قائمة الموقع توقفت بعد تحديث ووردبريس: jQuery القديمة في القالب
باختصار: إذا حدّثت ووردبريس ثم توقفت القائمة المنسدلة في رأس الموقع، أو الشرائح المتحركة في الصفحة الرئيسية، أو نافذة اختيار المقاس في المتجر، بينما بقية الموقع تعمل، فالأرجح أن قالباً أو إضافة قديمة تستخدم دوال في مكتبة jQuery أو jQuery UI لم تعد موجودة. ووردبريس يحدّث هذه المكتبات على مراحل، وآخرها تحديث jQuery UI إلى الإصدار 1.14.2 في ووردبريس 7.1 مع إزالة بعض الدوال. الحل ليس الرجوع إلى إصدار قديم من ووردبريس، ولا تثبيت إضافة «مساعد» أُغلقت لسبب أمني، بل تحديد الكود المعطل من وحدة تحكم المتصفح وتحديثه أو استبداله.
الموقف كما يحدث
محل أثاث في مادبا موقعه على ووردبريس بقالب اشتراه قبل سنوات. بعد تحديث تلقائي، لاحظ صاحب المحل أن القائمة في أعلى الموقع لا تنفتح على الهاتف، وأن معرض صور المنتجات لم يعد ينتقل بين الصور. الزبائن يتصلون ليسألوا عن منتجات لا يستطيعون رؤيتها.
صاحب المحل بحث في الإنترنت فوجد نصيحة بتثبيت إضافة تعيد نسخة قديمة من jQuery. هذا مثال توضيحي لحالة شائعة، والنصيحة التي وجدها لم تعد صالحة كما سنرى.
لماذا تتعطل أجزاء من القالب بعد التحديث؟
jQuery مكتبة JavaScript قديمة وشائعة، تعتمد عليها قوالب وإضافات كثيرة، خصوصاً القديمة منها. ووردبريس يضمّن نسخة من jQuery ومكتبة الواجهات jQuery UI، ويحدّثهما مع الوقت.
في 2020 نشر فريق تطوير ووردبريس خطة تحديث jQuery، وشرح أنها يجب أن تتم على مراحل، اتباعاً لتوصيات فريق jQuery: إزالة نسخة قديمة من أداة التوافق jQuery Migrate، ثم التحديث إلى أحدث jQuery مع أحدث jQuery Migrate، ثم إزالة أداة التوافق لاحقاً حسب نتائج الاختبار. وطلب من المطورين تحديث أكوادهم، وأشار إلى أدلة الترقية الرسمية من jQuery لمعرفة ما تغير.
وفي تموز 2026، أعلن فريق التطوير أن ووردبريس 7.1 يتضمن تحديث jQuery UI إلى الإصدار 1.14.2 من 1.13.3. وذكر أن التحديث يُسقط دعم كل إصدارات Internet Explorer وEdge القديم، وأنه يضبط خيار التوافق uiBackCompat على true لضمان استمرار عمل الكود المكتوب لواجهة قديمة، لكنه أزال أربع دوال محددة. وقال إن ووردبريس نفسه لا يستخدم أياً منها، لكن على المطورين فحص أكوادهم وتحديثها إن كانت تستخدمها.
القالب الذي لم يُحدّث منذ سنوات قد يكون واحداً من هذه الأكواد.
ما هو jQuery Migrate؟
مستودع jQuery Migrate الرسمي يصفه بأنه أداة تطوير تسهل الترقية عندما تتضمن المكتبة تغييرات جذرية، إذ تعيد الواجهات التي أُزيلت، وتعرض تحذيرات في وحدة تحكم المتصفح عند استخدام واجهات مزالة أو مهملة. ويذكر أن هذه التحذيرات تظهر في النسخة التطويرية فقط، وأن كل التحذيرات تبدأ بالنص JQMIGRATE. أما النسخة الإنتاجية فمضغوطة ولا تولّد تحذيرات، بل رسالة عند التحميل أو عند اكتشاف خطأ.
ويذكر المستودع أن الهدف استخدام الأداة حتى لا تعود بحاجة إليها ثم إزالتها. أي أنها جسر مؤقت، لا حل دائم.
لا تثبت إضافة «تفعيل مساعد jQuery Migrate»
كانت هناك إضافة شهيرة في دليل إضافات ووردبريس تعيد أداة التوافق القديمة للمواقع المتعطلة، وكثير من المقالات القديمة ما زالت تنصح بها. صفحتها في الدليل تقول الآن إنها أُغلقت في 20 أيار 2026 ولم تعد متاحة للتنزيل، والسبب المذكور مشكلة أمنية.
إذا كانت هذه الإضافة مثبتة في موقعك من سنوات، فاطلب من المطور إزالتها، ومعالجة السبب الحقيقي. ولا تبحث عن نسخة منها من مصدر آخر.
كيف تجد الكود المعطل؟
- افتح الموقع على الحاسوب واذهب إلى الصفحة التي فيها العطل.
- افتح أدوات المطور في المتصفح، ثم تبويب وحدة التحكم.
- أعد تحميل الصفحة وجرّب العنصر المعطل، مثل القائمة.
- اقرأ الأخطاء الحمراء: غالباً تذكر اسم دالة غير معرّفة أو خاصية غير موجودة، ومعها اسم الملف الذي حدث فيه الخطأ.
- انظر إلى مسار الملف: هل هو داخل مجلد القالب أم داخل مجلد إضافة معينة؟ هذا يحدد المسؤول.
- ابحث عن تحذيرات JQMIGRATE إذا ظهرت، فهي تدل على كود يستخدم واجهات قديمة.
بعد تحديد المصدر
- إضافة قديمة: تحقق من وجود تحديث لها. إذا كانت متوقفة عن التطوير، ابحث عن بديل يؤدي الوظيفة نفسها.
- قالب قديم: تحقق من وجود إصدار أحدث من مطوره. إذا كان القالب معدلاً يدوياً، فالتحديث قد يمسح التعديلات، فاطلب من المطور نقلها إلى قالب فرعي أولاً.
- كود مخصص كتبه مطور سابق: يحتاج تعديلاً يستبدل الدوال المزالة ببدائلها الحديثة، استناداً إلى أدلة الترقية الرسمية.
تحديثات jQuery الكبيرة قادمة أيضاً
مستودع jQuery Migrate يذكر أن الترقية إلى jQuery 4 تتطلب الوصول أولاً إلى الإصدار 3، وأن من يستخدم إصداراً أقدم يجب أن يرقّي أولاً إلى الإصدار 3 باستخدام jQuery Migrate 3 لحل مشاكل التوافق. ويعرض جدولاً يربط كل إصدار من jQuery بإصدار أداة التوافق المناسب له، ويذكر أن كل إصدار من الأداة يدعم المتصفحات نفسها التي يدعمها إصدار jQuery المستخدم معه.
لا نعرف متى أو إن كان ووردبريس سينتقل إلى jQuery 4، ولم نجد إعلاناً بذلك في الصفحات التي راجعناها. لكن الدرس واضح: القالب الذي يعتمد على دوال قديمة سيتعطل مرة بعد مرة مع كل خطوة. الأفضل معالجته الآن، أو التخطيط لاستبداله بقالب حديث لا يعتمد على jQuery بكثافة.
إذا كان المتجر على WooCommerce
العطل قد يظهر في صفحة المنتج أو الدفع بالذات، لأن إضافات المتجر القديمة، مثل إضافات اختيار المقاسات والألوان، تعتمد كثيراً على jQuery. اختبر رحلة الشراء كاملة بعد أي تحديث.
لماذا لا تعيد ووردبريس إلى إصدار قديم؟
الرجوع إلى إصدار قديم يعيد القائمة للعمل اليوم، لكنه يترك الموقع دون إصلاحات الأمان التي جاءت مع التحديث. والمشكلة ستعود مع أي تحديث قادم. القالب القديم هو الدَّين الذي يجب سداده، والتحديث فقط كشفه.
خطة وقائية للتحديثات القادمة
- موقع تجريبي: نسخة من الموقع تُحدّث أولاً، ويُختبر فيها كل شيء قبل الموقع الحي.
- قائمة اختبار قصيرة: القائمة على الهاتف، والشرائح، والنماذج، وسلة الشراء، والدفع.
- قراءة ملاحظات المطورين: فريق ووردبريس ينشر ملاحظات مثل إعلان تحديث jQuery UI قبل الإصدار. اطلب من المطور متابعتها.
- مراجعة سنوية للإضافات والقالب: ما المتوقف عن التطوير؟ وما البديل؟
أسئلة شائعة
ليش القائمة والسلايدر وقفوا بعد تحديث ووردبريس؟
غالباً لأن القالب أو إضافة تستخدم دوالاً قديمة في jQuery أو jQuery UI أُزيلت أو تغيرت في التحديث.
هل أثبت إضافة Enable jQuery Migrate Helper؟
لا. صفحتها في دليل ووردبريس تقول إنها أُغلقت في 20 أيار 2026 لسبب أمني.
كيف بعرف شو الملف اللي عامل المشكلة؟
من وحدة تحكم المتصفح: الأخطاء تذكر عادة اسم الدالة والملف، ومسار الملف يدل على القالب أو الإضافة.
هل أرجع ووردبريس لنسخة قديمة؟
لا يُنصح بذلك، لأنك تفقد إصلاحات الأمان والمشكلة ستعود. أصلح الكود القديم.
إذا تعطلت أجزاء من موقعك بعد تحديث ووردبريس، راسلنا ونحدد الكود القديم معك.