الكتل المخصصة في Gutenberg مفقودة أو لا تعمل

Summary: يمكن لكتل Gutenberg المخصصة أن تعزز تجربة التحرير في WordPress بإضافة تخطيطات وعناصر محتوى ووظائف إضافية. إذا اختفت هذه الكتل فجأة أو فشل تحميلها أو توقفت

يمكن لكتل Gutenberg المخصصة أن تعزز تجربة التحرير في WordPress بإضافة تخطيطات وعناصر محتوى ووظائف إضافية. إذا اختفت هذه الكتل فجأة أو فشل تحميلها أو توقفت عن العمل بشكل صحيح، فالمشكلة غالبًا ما تكون متعلقة بتوافق الإضافات أو مكتبات الكتل القديمة أو التخزين المؤقت أو تعارضات JavaScript.

يشرح هذا الدليل أكثر الأسباب شيوعًا ويقدم حلولًا خطوة بخطوة لاستعادة كتلك المخصصة.

إذا كان المحرر بأكمله لا يُحمّل وليس بعض الكتل فقط، فراجع محرر الكتل (Gutenberg) لا يعمل بدلًا من ذلك.

أعراض شائعة

إذا كنت تواجه مشاكل في الكتل المخصصة، فقد تلاحظ واحدًا أو أكثر مما يلي:

• لم تعد الكتل المخصصة تظهر في مُدرج الكتل.
• تعرض الكتل الموجودة “This block contains unexpected or invalid content.”
• تظهر الكتل كأنها غير مدعومة أو غير متاحة.
• تفشل الكتل في العرض داخل المحرر.
• يعرض المحرر أخطاء تحميل عند استخدام الكتل المخصصة.
• إعدادات الكتلة مفقودة من الشريط الجانبي.
• الصفحات التي أُنشئت سابقًا تظهر بتخطيطات تالفة أو مفقودة.
• تعرض الواجهة الأمامية أخطاء كتل أو محتوى مفقودًا.

الأسباب الشائعة

تكون مشاكل الكتل المخصصة عادةً ناتجة عن أحد الأسباب التالية:

• إضافة كتل قديمة.
• تعارض إضافات.
• مشكلات توافق القالب.
• أخطاء JavaScript.
• ملفات JavaScript أو CSS مخزّنة مؤقتًا.
• ملفات إضافة تالفة.
• تعطيل وظائف REST API.
• تغييرات في شفرة الكتل المخصصة بعد تحديث إضافة.
• ملفات نواة WordPress مفقودة أو تالفة.

الحل 1: حدّث إضافة الكتل

تأتي كثير من الكتل المخصصة من إضافات. إذا لم تُحدَّث الإضافة مؤخرًا، فقد لا تكون متوافقة تمامًا مع أحدث إصدار من WordPress.

حدّث الإضافة إلى أحدث إصدار متاح واختبر الكتل المتأثرة مرة أخرى.

إذا كانت هناك عدة إضافات كتل مثبتة، فحدّثها جميعًا قبل متابعة استكشاف الأخطاء.

الحل 2: تأكد من تفعيل الإضافة

قد يبدو هذا واضحًا، لكن الكتل المخصصة تختفي فورًا إذا عُطّلت الإضافة التي توفّرها.

انتقل إلى Plugins → Installed Plugins وتأكد من أن إضافة الكتل نشطة.

إذا كانت الإضافة قد عُطّلت بالخطأ، فأعد تفعيلها وأعد تحميل المحرر.

الحل 3: امسح جميع الذواكر المؤقتة

قد تمنع ملفات JavaScript وCSS القديمة المخزّنة مؤقتًا الكتل المخصصة من التحميل بشكل صحيح.

امسح:

• ذاكرة المتصفح المؤقتة.
• ذاكرة WordPress المؤقتة.
• ذاكرة الخادم المؤقتة.
• ذاكرة CDN المؤقتة.
• ذاكرة الكائنات المؤقتة.

بعد مسح الذاكرة المؤقتة، أجرِ تحديثًا قسريًا وأعد فتح المحرر.

الحل 4: تحقق من تعارض الإضافات

إذا لم يحل تحديث إضافة الكتل المشكلة، فقد تكون إضافة أخرى تتدخل معها.

عطّل مؤقتًا جميع الإضافات ما عدا إضافة الكتل.

إذا عادت الكتل للعمل:

1. أعد تفعيل الإضافات واحدة تلو الأخرى.
2. اختبر المحرر بعد كل تفعيل.
3. حدد أي إضافة تسبب التعارض.

بعد التحديد، حدّث الإضافة المتعارضة أو استبدلها أو أزلها.

الحل 5: بدّل إلى قالب افتراضي

تتضمن بعض القوالب JavaScript أو CSS مخصصًا يؤثر على Gutenberg.

فعّل مؤقتًا قالب WordPress افتراضيًا.

إذا بدأت الكتل المخصصة بالعمل، فمن المرجح أن قالبك هو المسؤول.

حدّث القالب أو تواصل مع المطور للحصول على إصدار متوافق.

الحل 6: تحقق من وحدة تحكم المتصفح

غالبًا ما تمنع أخطاء JavaScript الكتل المخصصة من التحميل بشكل صحيح.

لفحص الأخطاء:

1. افتح المحرر.
2. اضغط F12.
3. اختر تبويب Console.
4. أعد تحميل الصفحة.

ابحث عن أخطاء تشير إلى:

• ملفات JavaScript مفقودة.
• سكربتات الإضافات.
• فشل تسجيل الكتل.
• طلبات REST API.
• أخطاء React.

يمكن لهذه الرسائل مساعدتك على تحديد مصدر المشكلة.

الحل 7: تحقق من REST API

تعتمد كثير من كتل Gutenberg على WordPress REST API لاسترجاع الإعدادات والمحتوى.

زر:

https://yourdomain.com/wp-json/

إذا لم تُرجع الصفحة استجابة JSON صالحة، فقد تكون REST API محجوبة.

من الأسباب الشائعة:

• إضافات الأمان.
• قواعد جدار الحماية.
• تكوين الخادم.
• إعدادات الروابط الدائمة غير الصحيحة.

إصلاح مشاكل REST API غالبًا ما يعيد الكتل المفقودة.

الحل 8: أعد تثبيت إضافة الكتل

قد تتلف ملفات الإضافة أحيانًا أثناء التحديث.

لإعادة التثبيت بأمان:

1. صدّر أي إعدادات خاصة بالإضافة إن كان ذلك مدعومًا.
2. احذف الإضافة الحالية.
3. ثبّت أحدث إصدار.
4. فعّل الإضافة.
5. اختبر الكتل المتأثرة.

تحتفظ معظم الإضافات الجيدة بإعداداتها أثناء إعادة التثبيت، لكن من الجيد دائمًا إنشاء نسخة احتياطية مسبقًا.

الحل 9: تحقق من محتوى الكتل غير الصالح

إذا عرضت الصفحات الحالية الرسالة “This block contains unexpected or invalid content,” فقد تكون بنية الكتلة قد تغيرت بعد تحديث.

في كثير من الحالات يقدم WordPress خيارات مثل:

• محاولة استعادة الكتلة.
• تحويل الكتلة إلى HTML.
• حل مشكلة الكتلة يدويًا.

قبل قبول أي تغييرات، قارن المعاينة للتأكد من سلامة محتواك.

الحل 10: استعد نسخة احتياطية

إذا بدأت المشكلة مباشرة بعد تحديث إضافة أو إجراء تغييرات على موقعك، فقد يكون استعادة نسخة احتياطية حديثة هي أسرع حل.

استعد:

• ملفات الموقع.
• قاعدة البيانات.
• ملفات الإضافة.

بعد الاستعادة، حدّث الإضافات واحدة تلو الأخرى مع اختبار كتلك المخصصة بين كل تحديث.

أفضل الممارسات

لتجنب مشاكل الكتل المخصصة مستقبلًا:

• أبقِ إضافات الكتل محدّثة.
• أزل إضافات الكتل التي لم تعد تستخدمها.
• تجنب تثبيت عدة إضافات تقدم مجموعات كتل متشابهة.
• اختبر تحديثات الإضافات على موقع تجريبي قبل تطبيقها على موقعك الحي.
• أبقِ WordPress والقوالب والإضافات محدّثة.
• أنشئ نسخًا احتياطية منتظمة قبل التحديثات الكبيرة.
• راجع سجلات تغييرات الإضافات لمعرفة التغييرات الجذرية قبل التحديث.

اتباع هذه الممارسات المثلى يضمن بقاء كتل Gutenberg المخصصة مستقرة وتعمل بشكل صحيح، مما يقلل خطر فقدان المحتوى أو مشاكل المحرر مستقبلًا.