المحرر لا يظهر.

تعلّم DXPR Builderإدارة الموقعحلّ مشكلة

تفتحون صفحة ولا شيء يحدث عندما تشيرون إلى المحتوى، أو تظهر عناصر التحكم لكن مربع الإعدادات لا يُفتَح أبدًا. اعملوا عبر الأسباب تحته بالترتيب. فالأربعة الأولى تغطي معظم الحالات.

أنا على نموذج تحرير العقدة

يعمل المحرر على الصفحة نفسها، لا على نموذج التحرير. احفظوا العقدة وافتحوا الصفحة وأشيروا إلى منطقة المحتوى. ويبقى المحرر مطفأ أيضًا على صفحات المراجعات، مثل /node/12/revisions/34/view.

تعرض الصفحة رسالة مفتاح منتج أو ترخيص

يبقى المحرر مطفأ بينما تظهر إحدى هذه الرسائل:

  • «يحتاج DXPR Builder مفتاح منتج ليعمل». لا مفتاح منتج مضبوط. انتقلوا إلى DXPR Studio > DXPR Builder > الإعدادات العامة (/admin/dxpr_studio/dxpr_builder/settings) واملؤوا قسم الترخيص.
  • «عذرًا، لا يُحمَّل المحرر دون شيفرة هنا». تسمّي الرسالة السبب: تراخيص مستخدم قليلة جدًا أو حد عناصر المحتوى في باقتكم أو حساب بلا عنوان بريد إلكتروني صالح. اتبعوا أخطاء الترخيص ومفتاح المنتج.
  • «الوصول إلى DXPR Builder محظور بسبب مشكلة دفع أو ترخيص». حظرت DXPR نطاق الموقع. اتصلوا بـ DXPR عبر الرابط في الرسالة.

تعرض وحدة التحكم أخطاء 401 أو 403 من cdn2.dxpr.com

مع ضبط مصدر الأصول على السحابة، تُحمَّل سكربتات المحرر من cdn2.dxpr.com ومفتاح منتجكم في عنوان URL. ويعني 401 أو 403 أن CDN رفضت المفتاح. راجعوا قسم الترخيص في الإعدادات العامة، ثم اتبعوا أخطاء الترخيص ومفتاح المنتج. وإذا انتهت مهلة الطلبات بدلًا من ذلك، فجدار ناري يحجب CDN؛ راجعوا استخدام DXPR Builder خلف جدار ناري.

توقف المحرر بعد تحديث

  1. شغّلوا drush updb -y (أو زوروا /update.php).
  2. شغّلوا drush cr.
  3. افتحوا صفحة منشئ واحدة واحفظوها مجددًا.

إذا أبلغ السجل عن ملف مفقود داخل مجلد الوحدة، فالشيفرة على الخادم ناقصة. أعيدوا تثبيت الشيفرة:

  1. احذفوا مجلد modules/contrib/dxpr_builder.
  2. شغّلوا composer require drupal/dxpr_builder.
  3. شغّلوا drush cr.

مهم: لا تلغوا تثبيت الوحدة أبدًا لإعادة ضبطها. فإلغاء التثبيت يحذف القوالب المحفوظة والملفات والإعدادات.

تظهر عناصر التحكم، لكن مربعات الإعدادات لا تُفتَح أبدًا

تعرض وحدة التحكم bootstrap is not defined، أو خطأ عن getOrCreateInstance. فمربعات المحرر تعمل على JavaScript الخاصة بـ Bootstrap 5. والصفحة بلا أي منها، أو القالب يحمّل Bootstrap 3 أو 4 بدلًا منها.

  1. انتقلوا إلى الإعدادات العامة وافتحوا قسم Bootstrap.
  2. إذا كان قالبكم لا يحمّل Bootstrap 5، اضبطوا تحميل ملفات Bootstrap جانبيًا على Bootstrap 5 وانقروا حفظ الإعدادات.
  3. إذا كان قالبكم يحمّل JavaScript الخاصة بـ Bootstrap 3 أو 4، أوقفوا تحميلها أو بدّلوا إلى قالب Bootstrap 5.

تعرض وحدة التحكم خطأ JavaScript من سكربت آخر

سكربت آخر على الصفحة يعطّل المحرر. ففي تذاكر الدعم كان الجناة لافتات موافقة ملفات تعريف الارتباط ومديري الوسوم وتضمين MailChimp ووكيل متصفح New Relic. وتسببت به القوالب أيضًا، عبر حزمة Webpack أو JavaScript الخاصة بـ Bootstrap 3 أو 4، وكذلك مصغّرات JavaScript.

  1. انتقلوا إلى الإعدادات > التطوير > الأداء وأطفئوا تجميع JavaScript. أعيدوا التحميل.
  2. عطّلوا وحدات الموافقة والتحليلات والمراقبة واحدة واحدة. أعيدوا التحميل بعد كل منها.
  3. بدّلوا إلى قالب نواة مثل Olivero لاختبار واحد.

ما تخبركم به النتيجة:

  • أُصلِح بالخطوة 1: المصغّر هو السبب. فمكتبات المحرر المساعدة، مثل Sortable، تُجمَّع مع باقي الصفحة، لذا فـ Sortable is not defined مع تفعيل التجميع يشير إلى هنا. ومع Advanced CSS/JS Aggregation، غيّروا المصغّر من JSqueeze إلى JSMin.
  • أُصلِح بالخطوة 2: أبقوا تلك الوحدة معطلة على صفحات التحرير، أو أبلغوا عن التعارض لمشرفها.
  • أُصلِح بالخطوة 3: JavaScript الخاصة بالقالب هي السبب. أوقفوا تحميل JavaScript الخاصة بـ Bootstrap 3 أو 4 من القالب، واضبطوا تحميل ملفات Bootstrap جانبيًا على Bootstrap 5.

تعرض الصفحة «واجه الموقع خطأ غير متوقع»

يعرض السجل تتبع مكدس عبر DxprBuilderService يسمّي عرضًا أو فئة كتلة من وحدة أخرى.

للمحرّرين، يسرد المنشئ كل معروض عرض وملحق كتلة لتضيفوها إلى الصفحات. ولكل زائر، يعرض الكتل وطرق العرض الموضوعة في الصفحة. فعرض واحد معطل أو كتلة ترمي خطأ في أي من الخطوتين تُسقِط الصفحة.

  1. افتحوا التقارير > رسائل السجل الأخيرة وجدوا العرض أو الوحدة المسماة في التتبع.
  2. أصلحوا ذلك العرض أو احذفوه، أو عطّلوا تلك الوحدة.
  3. امسحوا كل ذاكرات التخزين المؤقت.

لا يظهر المحرر أبدًا على نوع محتوى واحد

  1. انتقلوا إلى البنية > أنواع المحتوى > (النوع) > إدارة العرض.
  2. اضبطوا تنسيق حقل المنشئ على DXPR Builder.
  3. كرّروا لكل وضع عرض يعرض الحقل، لا الافتراضي فقط.

ملاحظة: يحتاج المحرر حقلًا بقيمة ليرتبط به. فعندما تحفظون عقدة، يملأ DXPR Builder الحقل الفارغ الذي يستخدم تنسيق DXPR Builder في عرض الافتراضي. والعقدة المحفوظة قبل تغيير التنسيق تبقى فارغة: حرّروها واحفظوها مرة.

يرى المحرر بعض المستخدمين فقط

راجعوا التالي للحساب الذي لا يرى محررًا:

  1. على الأشخاص > الصلاحيات (/admin/people/permissions)، يملك الدور التحرير باستخدام DXPR Builder.
  2. قد يحرّر الدور ذلك المحتوى أيضًا، مثل صفحة أساسية: تحرير أي محتوى. فلا يُحمَّل المحرر إلا للمستخدمين الذين يستطيعون تحديث الصفحة.
  3. يملك الحساب عنوان بريد إلكتروني صالحًا. فالترخيص يحتاج واحدًا.
  4. على نموذج تحرير المستخدم، الاستبعاد من التحرير باستخدام DXPR Builder غير محدد.
  5. على DXPR Studio > DXPR Builder > ملفات المستخدم، يملك الملف لذلك الدور بدء المحرر عند تحميل الصفحة محددًا. وعند تعطيله، لا تظهر عناصر التحكم إلا بعد نقرة على أيقونة العين لعناصر تحكم الحاوية.

قفل محرر آخر المحتوى

يقول تحذير «المحتوى ... مقفل بواسطة» زميل، وتعرض الحاوية زر مقفل فقط. فنقر ذلك المحرر داخل الحاوية ولم يحفظ بعد؛ ويُمسَح القفل عندما يحفظ. اطلبوا منهم الحفظ، أو انقروا مقفل وأكّدوا للاستلام. وإذا واصلتما التحرير معًا، فالحفظ الأخير يفوز.

تأكيد الإصلاح

أعيدوا التحميل في نافذة خاصة وأشيروا إلى منطقة المحتوى. يعرض شريط الحاوية وضع العرض والمزيد وحفظ، ولا تعرض وحدة التحكم أخطاء حمراء.

ما الخطوة التالية؟

مشاكل بعد التحديث إذا تعطّل المحرر بعد إصدار مباشرة.