محرر الكتل (Gutenberg) لا يعمل

Summary: محرر الكتل في WordPress (Gutenberg) هو المحرر الافتراضي المستخدم لإنشاء المقالات والصفحات والمحتوى الآخر وتحريره. إذا لم يُحمّل المحرر أو عرض شاشة فارغة

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

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

أعراض شائعة

إذا لم يُحمّل محرر الكتل بشكل صحيح، قد تلاحظ مشكلة أو أكثر مما يلي:

• يبقى المحرر عالقًا على شاشة التحميل.
• تظهر شاشة بيضاء بدلًا من المحرر.
• رسالة خطأ مثل “The editor has encountered an unexpected error.”
• تفشل المقالات أو الصفحات في الفتح للتحرير.
• أزرار أو عناصر التحكم في المحرر لا تستجيب.
• الكتل المخصصة مفقودة أو لا تُحمّل.
• المحرر الكلاسيكي يعمل، لكن محرر الكتل لا يعمل.
• تتلقى أخطاء JavaScript في متصفحك.

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

هناك عدة عوامل قد تمنع محرر الكتل من التحميل بشكل صحيح. أكثرها شيوعًا:

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

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

تعد الملفات المخزّنة مؤقتًا من أكثر أسباب عدم تحميل محرر الكتل بعد إجراء تغييرات على موقعك.

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

• إضافات التخزين المؤقت في WordPress.
• التخزين المؤقت على مستوى الخادم.
• ذاكرة الكائنات المؤقتة (Redis أو Memcached).
• ذاكرة CDN المؤقتة (مثل Cloudflare).
• ذاكرة المتصفح المؤقتة.

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

Windows

Ctrl + F5

macOS

Cmd + Shift + R

بعد الانتهاء، أعد فتح محرر الكتل.

الحل 2: عطّل تحسين JavaScript

غالبًا ما تحسّن إضافات الأداء JavaScript لتسريع التحميل. ورغم أن هذه التحسينات مفيدة، إلا أنها قد تتداخل أحيانًا مع Gutenberg.

عطّل مؤقتًا ميزات مثل:

• ضغط JavaScript.
• دمج ملفات JavaScript.
• تأجيل تحميل JavaScript.
• تأخير تنفيذ JavaScript.
• تحسين CSS.

امسح الذاكرة المؤقتة بعد إجراء التغييرات واختبر المحرر مرة أخرى.

إذا اختفت المشكلة، أعد تفعيل كل تحسين على حدة حتى تحدد الميزة المتعارضة.

الحل 3: حدّث جميع الإضافات

تعد الإضافة القديمة من أبرز أسباب مشكلات محرر الكتل — وهذا شائع خاصة بعد تحديث نواة WordPress.

حدّث كل إضافة مثبتة إلى أحدث إصدار، مع الاهتمام الخاص بالإضافات التي:

• تضيف كتل Gutenberg مخصصة.
• تعدّل محرر WordPress.
• توسّع WooCommerce.
• تتضمن وظائف منشئات الصفحات.
• تقدم تحسينات SEO أو الأداء.

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

الحل 4: بدّل القالب مؤقتًا

قد يحتوي قالبك النشط على JavaScript قديم أو مشكلات توافق تمنع تحميل المحرر.

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

• Twenty Twenty-Five
• Twenty Twenty-Six

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

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

الحل 5: تحقق من أخطاء JavaScript

يمكن لوحة تحكم المتصفح مساعدتك على معرفة ما يمنع المحرر من التحميل.

لفحص أخطاء JavaScript:

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

ابحث عن أخطاء معروضة باللون الأحمر، مثل:

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

غالبًا ما تشير هذه الرسائل مباشرةً إلى مصدر المشكلة.

الحل 6: عطّل الإضافات واحدة تلو الأخرى

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

بعد تفعيل كل إضافة:

1. امسح الذاكرة المؤقتة لموقعك.
2. أعد تحميل محرر الكتل.
3. تحقق مما إذا عادت المشكلة.

عندما يتوقف المحرر عن العمل مجددًا، فقد حددت الإضافة المتعارضة غالبًا.

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

الحل 7: تحقق من إصدار PHP

قد يسبب تشغيل إصدار PHP قديم مشكلات غير متوقعة في WordPress، بما في ذلك مشكلات محرر الكتل.

لأفضل أداء وتوافق، استخدم إصدار PHP مدعومًا حاليًا، مثل PHP 8.2 أو PHP 8.3.

إذا كنت غير متأكد من إصدار PHP الذي يستخدمه موقعك، فتحقق من لوحة تحكم الاستضافة أو تواصل مع مزود الاستضافة.

الحل 8: فعّل سجل تصحيح WordPress

إذا استمرت المشكلة، فعّل تصحيح WordPress لجمع مزيد من المعلومات.

أضف الأسطر التالية إلى ملف wp-config.php الخاص بك:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

ثم أعد إنتاج المشكلة وراجع ملف السجل الموجود في:

wp-content/debug.log

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

الحل 9: اختبر واجهة REST API

يعتمد محرر الكتل على واجهة WordPress REST API للتواصل مع موقعك.

للتحقق من عملها، زر:

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

إذا كان كل شيء يعمل بشكل صحيح، سترى استجابة JSON تحتوي معلومات عن تثبيت WordPress لديك.

إذا تلقيت خطأً مثل:

• 403 Forbidden
• 404 Not Found
• 500 Internal Server Error

فقد تكون REST API محجوبة أو مضبوطة بشكل خاطئ.

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

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

إصلاح أخطاء REST API غالبًا ما يعيد محرر الكتل إلى العمل.

الحل 10: أعد تثبيت ملفات نواة WordPress

إذا لم ينجح أي من الحلول السابقة، فقد تكون ملفات نواة WordPress قد تلفت.

لإعادة تثبيت WordPress دون التأثير على محتواك:

1. انتقل إلى Dashboard → Updates.
2. انقر Reinstall Current Version.
3. انتظر حتى تكتمل العملية.

يعيد هذا تثبيت ملفات WordPress الأساسية دون حذف مقالاتك أو صفحاتك أو إضافاتك أو قوالبك أو مكتبة الوسائط.

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

لتقليل خطر مشكلات محرر الكتل مستقبلًا:

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

وباتباع هذه الممارسات المثلى تضمن تجربة تحرير مستقرة وتقلل احتمال حدوث مشاكل محرر الكتل مستقبلًا.