ميدياويكي:Common.js: الفرق بين النسختين

مراجعة ١٧:٤٦، ١٦ أكتوبر ٢٠٢٦

/* أي جافاسكريبت هنا سيتم تحميلها لكل المستخدمين مع كل تحميل للصفحة. */

/* 1. محرك جدول المعرفات السيمانتكي الديناميكي والجميل بالكامل (محلي ومستقل 100% بدون أي كود خارجي) */
$(document).ready(function() {
    if (mw.config.get('wgPageName') === 'المعرفات') {
        var $table = $('#table-ids-mw');
        if ($table.length > 0) {
            // تنسيق رؤوس الجدول وإعطاؤها لمسة احترافية
            $table.find('th').eq(0).text('معرف الصفحة (ID)').css({'background-color': '#2a4b7c', 'color': '#ffffff', 'text-align': 'right', 'padding': '10px'});
            $table.find('th').eq(1).text('اسم الشخص (القناع)').css({'background-color': '#2a4b7c', 'color': '#ffffff', 'text-align': 'right', 'padding': '10px'});
            
            // إضافة خاصية التنسيق العام لـ وبنية الجدول
            $table.css({'border-collapse': 'collapse', 'width': '100%', 'margin-top': '15px'});
        }

        // استعلام دلالي موسع يدعم الفحص بالشرطة والمسافة لحماية المعرفات
        var askQuery = "[[معرف الشخص::+]]|[[معرف_الشخص::+]]|?معرف الشخص|?معرف_الشخص|?Display_title_of|limit=500";
        var apiUrl = '/api.php?action=ask&format=json&query=' + encodeURIComponent(askQuery);
        
        $.getJSON(apiUrl, function(data) {
            var results = (data && data.query) ? data.query.results : null;
            if (results && Object.keys(results).length > 0) {
                var rowsHtml = '';
                
                $.each(results, function(title, pageData) {
                    if (title === 'المعرفات' || title.indexOf('قالب:') !== -1) return;
                    
                    var printouts = pageData.printouts || {};
                    
                    // 💡 فصل وتأمين رقم الـ ID النقي مباشرة من عنوان الويكي الفعلي لحل خلل الفراغ
                    var pageId = title.replace(/Person_/g, '').replace(/Person:/g, '').trim();
                    pageId = pageId.toString().replace(/[^0-9]/g, '').trim();
                    
                    var pageTitleId = "Person:" + pageId;
                    
                    // 💡 طريقتك الذهبية الثابتة والناجحة: قنص واصطياد الاسم العربي النقي من الخانة الثانية داخل مصفوفة الـ BLOB
                    var displayMask = '';
                    var blobAttr = printouts["Display_title_of"] || printouts["Display title of"];
                    
                    if (blobAttr && blobAttr.length > 1) {
                        displayMask = blobAttr; // استخلاص الكلمة العربية الصافية مباشرة بنجاح مؤكد
                    }
                    
                    // خطة احتياطية فورية: تنظيف عنوان الصفحة الفعلي إذا كان حقل مصفوفة الـ BLOB فارغاً
                    if (!displayMask || displayMask === '' || !isNaN(displayMask)) {
                        displayMask = title.replace(/Person_/g, '').replace(/Person:/g, '').replace(/\s*\(.*?\)\s*/g, '').trim();
                        if (!isNaN(displayMask) && displayMask !== '') {
                            displayMask = "فرد رقم (" + displayMask + ")";
                        }
                    }

                    // بناء الأسطر وتلوين الخلايا بشكل منسق ومريح للعين عند القراءة والفرز
                    rowsHtml += '<tr style="border-bottom: 1px solid #dddddd;">' +
                                '<td style="padding: 10px 12px; font-family: monospace; font-size: 14px; font-weight: bold; width: 40%;"><a href="/index.php?title=' + encodeURIComponent(title) + '" style="color: #2a4b7c; text-decoration: none;">' + pageTitleId + '</a></td>' +
                                '<td style="padding: 10px 12px; font-weight: bold; color: #27ae60; font-size: 14px; width: 60%;">' + displayMask + '</td>' +
                                '</tr>';
                });
                
                $table.find('tbody').html(rowsHtml);
                
                // تفعيل الفرز التلقائي والمؤثرات الجمالية عند تمرير الماوس فوق الأسطر
                $table.find('tbody tr').hover(
                    function() { $(this).css('background-color', '#f5f7fa'); },
                    function() { $(this).css('background-color', 'transparent'); }
                );
                if ($.fn.tablesorter) { $table.tablesorter(); }
            }
        });
    }
});


/* 2. محرك شجرة الأنساب التكراري المطور والآمن المتكامل مع قنص عناصر مصفوفات الـ BLOB (فائق السرعة) */
$(document).ready(function() {
    $('.family-tree-api-render').each(function() {
        var $container = $(this);
        var rootId = $container.data('rootid');
        
        // تطهير المعرف للتأكد من أنه رقم مجرد تماماً ومتوافق مع قاعدة البيانات
        if (rootId) {
            rootId = parseInt(rootId.toString().replace(/[^0-9]/g, ''), 10);
        }
        if (!rootId || isNaN(rootId)) return;

        var maxGenerations = 12;
        var pageTitle = mw.config.get("wgPageName").replace(/_/g, " ");

        // التقاط اسم رأس الشجرة (الجذر) الافتراضي من عنوان المتصفح المرئي فوراً لضمان الثبات الكامل
        var rootCleanTitle = $('#firstHeading').text().replace(/Person_/g, '').replace(/Person:/g, '').trim();
        if (!rootCleanTitle || rootCleanTitle === '' || !isNaN(rootCleanTitle)) {
            rootCleanTitle = pageTitle.replace(/Person:/g, '').trim();
        }

        // الاستعلام الدلالي الشامل والموسع لـ 500 عنصر بالمسافات والشرطات معاً لضمان الأمان البنيوي
        var askQuery = "[[معرف الشخص::+]]|[[معرف_الشخص::+]]|?معرف الشخص|?معرف_الشخص|?معرف الأب|?معرف_الأب|?Display_title_of|limit=500";
        var apiUrl = '/api.php?action=ask&format=json&query=' + encodeURIComponent(askQuery);

        $.getJSON(apiUrl, function(data) {
            var results = (data && data.query && data.query.results) ? data.query.results : null;

            if (results && Object.keys(results).length > 0) {
                var rawNodes = [];

                $.each(results, function(title, pageData) {
                    var pageId = parseInt(pageData.pageid || pageData.id, 10);
                    var printouts = pageData.printouts || {};
                    
                    // 💡 طريقتك الذهبية الثابتة والناجحة: قنص واصطياد الاسم العربي النقي من الخانة الثانية داخل مصفوفة الـ BLOB
                    var cleanName = '';
                    var blobAttr = printouts["Display_title_of"] || printouts["Display title of"];
                    
                    if (blobAttr && blobAttr.length > 1) {
                        cleanName = blobAttr[1]; // استخلاص الكلمة العربية الصافية مباشرة بنجاح مؤكد
                    }
                    
                    // خطة احتياطية فورية: تنظيف عنوان الصفحة الفعلي إذا كان حقل مصفوفة الـ BLOB فارغاً
                    if (!cleanName || cleanName === '') {
                        cleanName = title.replace(/Person_/g, '').replace(/Person:/g, '').replace(/\s*\(.*?\)\s*/g, '').trim();
                        if (!isNaN(cleanName) && cleanName !== '') {
                            cleanName = "فرد رقم (" + cleanName + ")";
                        }
                    }

                    // 🛠️ شرطك المرن المبتكر: التحقق مما إذا كان المتغير "معرف الشخص" بالمسافة أو بالشرطة السفلية
                    var currentIdAttr = printouts["معرف الشخص"] || printouts["معرف_الشخص"];
                    var currentId = null;
                    if (currentIdAttr && currentIdAttr.length > 0) {
                        currentId = currentIdAttr[0].fulltext || currentIdAttr[0] || currentIdAttr;
                    }
                    if (!currentId) currentId = pageId;
                    currentId = parseInt(currentId.toString().replace(/[^0-9]/g, ''), 10);

                    // 🛠️ نفس الشرط المرن المبتكر لحماية متغير "معرف الأب" بالمسافة أو بالشرطة السفلية صراحة
                    var fatherIdAttr = printouts["معرف الأب"] || printouts["معرف_الأب"];
                    var fatherId = null;
                    if (fatherIdAttr && fatherIdAttr.length > 0) {
                        var rawFather = fatherIdAttr[0].fulltext || fatherIdAttr[0] || fatherIdAttr;
                        fatherId = parseInt(rawFather.toString().replace(/[^0-9]/g, ''), 10);
                        if (isNaN(fatherId)) fatherId = null;
                    }

                    if (currentId) {
                        rawNodes.push({ id: currentId, parentId: fatherId, title: cleanName, pageName: title });
                    }
                });

                // تحديث اسم الجذر (رأس الشجرة الحالية) إذا تطابق المعرف مع عناصر الذاكرة لزيادة الكفاءة
                var rootNodeInfo = rawNodes.find(function(n) { return n.id === rootId; });
                if (rootNodeInfo) {
                    rootCleanTitle = rootNodeInfo.title;
                }

                // دالة البناء التكراري ورسم الأفرع والتسلسلات الشجرية الفورية عالية الكفاءة في ذاكرة المتصفح
                function buildTreeHtml(currentParentId, depth) {
                    if (depth > maxGenerations) return "";
                    
                    var children = rawNodes.filter(function(node) { return node.parentId === currentParentId; });
                    if (children.length === 0) return "";

                    children.sort(function(a, b) { return a.title.localeCompare(b.title, 'ar'); });

                    var html = "";
                    var indent = Array(depth + 1).join("&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;");

                    children.forEach(function(child) {
                        html += "<br />" + indent + "←&nbsp;<a href='/index.php?title=" + encodeURIComponent(child.pageName) + "' style='color: #2a4b7c; font-weight: bold;'> " + child.title + "</a>";
                        html += buildTreeHtml(child.id, depth + 1);
                    });
                    return html;
                }
                
                var childrenHtml = buildTreeHtml(rootId, 1);
                
                if (childrenHtml) {
                    $container.html("• '''" + rootCleanTitle + "'''" + childrenHtml);
                } else {
                    $container.html("• '''" + rootCleanTitle + "'''<br />&nbsp;&nbsp;←&nbsp;<span style='color:#666;'>لا توجد فروع أو ذرية مسجلة نزولاً لهذا المعرف الرقمي في النظام.</span>");
                }

            } else {
                $container.html("• '''" + rootCleanTitle + "'''<br />&nbsp;&nbsp;←&nbsp;<span style='color:#666;'>لا توجد نتائج مسجلة.</span>");
            }
        }).fail(function() {
            $container.html("• '''" + rootCleanTitle + "'''<br />&nbsp;&nbsp;←&nbsp;<span style='color:red;'>❌ فشل جلب الشجرة عبر الـ API المحلي للموسوعة.</span>");
        });
    });
});