الوصف
مع التحديث إلى ووردبريس 5.5، لم تعد أداة الترحيل المعروفة بـ jquery-migrate
ممكَّنة افتراضيًا. قد يؤدي هذا إلى نقص في الوظائف أو سلوك غير متوقع في بعض القوالب أو الإضافات التي تعمل بواسطة كود قديم.
تعمل هذه الإضافة كحل مؤقت، حيث يتيح السكربت آلية الترحيل لموقعك، لمنح مطوّري الإضافات والقوالب الخاصة بك مزيدًا من الوقت لتحديث الأكواد الخاصة بهم واختبارها.
مع التحديث إلى ووردبريس 5.6، تمت أيضًا ترقية النسخة المضمّنة من jQuery. هذا يعني أن الكود القديم الذي تسبب سابقًا في التحذيرات الآن قد يتسبب في حدوث أخطاء أو يتوقف عن العمل تمامًا.
ستتوقف بعض الميزات التي لم تعد تعمل عن العمل خلف الكواليس دون أي مشكلة واضحة.
ستسمح لك الإضافة بالرجوع إلى إصدار سابق من jQuery لفترة، ولكن بصفتك مسؤول موقع، نشجّعك على إصلاح المشكلة الأساسية.
التنصيب
- رفع إلى مجلد الإضافات الخاصة بك، بالعادة
wp-content/plugins/
. - تفعيل الإضافة من خلال شاشة الإضافات.
- هذا كل شيء! ستتولى الإضافة معالجة الأمور من أجلك تلقائيًا.
الأسئلة المتكررّة
-
ماذا يعني لك ذاك الشيء الـ ”مهمل“
-
ملف، سكربت، أو جزء من كود مهمل عندما يكون المطوّرين في طور استبداله بكود أحدث أو إزالته بالكامل.
-
ماذا يحدث بعد ووردبريس 5.6
-
مع إصدار ووردبريس 5.6، يتم أيضًا تحديث نسخة jQuery. هذا يعني أن الإضافات أو القوالب التي تسببت في السابق في تحذيرات الإصدارات المهملة ستسبب أخطاء بدلاً من ذلك.
ستسمح لك هذه الإضافة – مؤقتًا – بالعودة إلى الإصدار السابق من jQuery إذا حدث ذلك (سيحاول أيضًا القيام بذلك تلقائيًا لزوار موقع الويب في المرة الأولى التي يحدث فيها خطأ) مما يسمح لك بإصلاح الكود أو استبداله. -
كيف يمكنني العثور على الـ Browser Console واستخدامها.
-
يحتوي WordPress.org على مقالة حول استخدام سجل الـ Browser Console لتشخيص أخطاء JavaScript.
-
لا تقوم الإضافة بتسجيل الإهمالات أو تغيير إصدارات jQuery
-
إذا كان موقعك يحتوي على أي إضافات لدمج ملفات جافا سكربت، أو تحميلها بشكل غير متزامن، فقد تتأثر هذه الإضافة سلبًا ولن تكون قادرةً على العمل على النحو المنشود.
إذا كان موقعك يتطلب تشغيل هذه الإضافة، فيرجى تعطيل أي إضافات تتفاعل مع تحميل ملفات JavaScript مثل الأنواع المذكورة أعلاه. بمجرد حل المشكلة الأساسية، يمكنك إزالة هذه الإضافة وإعادة تمكين تلك الأدوات الأخرى.
-
كيف أعرف ما إذا كنت بحاجة إلى هذا الإضافة، أم لا
-
إذا كان هناك شيء لا يعمل بشكل صحيح على موقعك بعد ترقية ووردبريس، فيمكنك ببساطة محاولة تنصيب هذه الإضافة وتفعيلها. إذا كان هذا مفيدًا، فستترك هذا الإضافة مفعلة واتبع الإرشادات الموجودة في الإضافة. ستخبرك الإضافة عندما لا تحتاج إليها أكثر من ذلك.
-
يوجد الكثير من تحذيرات الإصدارات المهملة عند استخدام النسخة 3 من jQuery
-
نظرًا لأن النسخة 3 من jQuery جديدة جدًا على ووردبريس، فهذا متوقع.
تشير ملاحظات الإصدارات المهملة إلى أن أداة الترحيل في مكانها الصحيح مع التأكد من استمرار هذه الميزات في العمل أثناء تحديث الكود ذي الصلة.
المراجعات
المساهمون والمطوّرون
“تمكين أداة Enable jQuery Migrate Helper” هو برنامج مفتوح المصدر. وقد ساهم هؤلاء الأشخاص بالأسفل في هذه الإضافة.
المساهمونلقد تم ترجمة ”تمكين أداة Enable jQuery Migrate Helper“ إلى 16 لغة. شكراً إلى جميع المُترجمين لمُساهماتهم.
ترجمة ”تمكين أداة Enable jQuery Migrate Helper“ إلى لغتك.
مُهتم بالتطوير؟
تصفّح الشفرة، تحقق من مستودع SVN، أو الاشتراك في سجل التطوير بواسطة RSS.
سجل التغييرات
v 1.4.0 (2023-07-31)
- Fixed a bug where an empty error text would cause the plugin scripts from working properly.
- Improved how inline scripts are detected and logged when applicable.
- Improved logging to also capture deprecations within WordPress core.
- Changed variable declarations for front-end scripts to use
var
instead ofconst
andlet
, to improve compatibility for sites servicing older clients. - Updated the (modern) bundled jQuery Migrate script to match what is shipped with WordPress core.
v 1.3.0
- تمت إضافة jQuery UI القديمة ليتم تحميلها إذا كان jQuery القديم قيد الاستخدام.
- تمت إضافة إشارة إلى عناوين URL الخاصة بالموقع في رسائل البريد الإلكتروني التلقائية.
- تمت إضافة خيار لـ تمكين/تعطيل الرجوع إلى نسخة أقدم تلقائيًا (automatic downgrades).
- تمت إضافة منطق لضمان إرسال طلب واحد فقط للرجوع إلى إصدار أقدم لكل تحميل صفحة.
- تم تحديث المنطق حول الرجوع إلى نسخة أقدم تلقائيًا (automatic downgrades) لتحسين الأداء.
- تم تصنيف ملاحظات الإهمالات التي وصفت بشكل غير صحيح على أنها إشعارات مضمنة غير محددة.
v 1.2.0
- تمت إضافة صفحة الإعدادات
- تمت إضافة اختيار للرجوع إلى إصدار أقدم من jQuery
- تمت إضافة عملية الرجوع التلقائية إلى نسخة أقدم
- تمت إضافة اختيار لسجلّ الإصدارات المهملة في jQuery الحديث
- تمت إضافة إشعارات البريد الإلكتروني
- تمت إضافة ملخص البريد الإلكتروني الأسبوعي للإصدارات المهملة
- تمت إضافة اختيار للسماح بإيقاف السجلّ من زوار الموقع المجهولين
- تم تغيير معالجة كود JavaScript المضمنة المتسببة في ملاحظات الإصدارات المهملة
- تم تغيير شريط الإدارة ليكون رابطين ثابتين لتجنب تغيير السياقات والحالات باستمرار
- تم تغيير ملاحظات المسؤول لتكون مستمرة عند استخدام jQuery القديم بعد الترقية إلى ووردبريس 5.6
- تم تغيير كيفية تعطيل التسلسل، لمعالجة مشكلات الأداء التي تواجه العامة
- توصية ثابتة لإزالة الإضافة عند عدم تسجيل أي إصدارات مهملة لها منطق خاطئ ولا يتم عرضها.
v 1.1.0
- إضافة خيار لتجاهل إشعارات الإهمال في الخلفية
- تمت إضافة تسجيل ملاحظات الإهمال في واجهة الموقع
- تمت إضافة مدخل شريط المسؤول لإظهاره عند حدوث الإهمال
- تمت إضافة عرض للإهمالات المسجلة
- تمت إضافة إشعار للوحة التحكم يشجع المستخدمين على إزالة الإضافة إذا لم يتم تسجيل أي إلغاء وإهمال للإصدارات القديمة لبعض الوقت (أسبوع واحد).
- تم تغيير الفاصل الزمني بين عرض لوحة التحكم من أسبوعين إلى أسبوع واحد، حيث اقتراب موعد إصدار ووردبريس 5.6.
v 1.0.1
- إصلاح إحدى إشعارات المسؤول التي تفيد بأنه غير قابل للرفض.
v 1.0.0
- إصدار مبدئي.