مشاكل التحديث.

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

أتموا تحديثًا متعثرًا. ففي كل الحالات تقريبًا حُدِّثت الشيفرة لكن قاعدة البيانات لم تُحدَّث، أو نسخة متروكة من الوحدة تعترض الطريق، أو تبعية مفقودة.

شغّلوا التحديث بالترتيب الصحيح

  1. انسخوا قاعدة البيانات احتياطيًا.
  2. شغّلوا composer require drupal/dxpr_builder، مع قيد إصدار إذا ثبّتم الإصدارات.
  3. شغّلوا drush updb -y (أو زوروا /update.php).
  4. شغّلوا drush cr.
  5. افتحوا صفحة منشئ واحدة واحفظوها مجددًا.

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

يعرض Composer خطأ

  • «تعذّر العثور على إصدار من الحزمة drupal/dxpr_builder يطابق minimum-stability الخاصة بكم». يُنشَر الإصدار 3.x كإصدارات بيتا. اسمحوا بها في القيد: composer require 'drupal/dxpr_builder:^3.0@beta'.
  • «تعذّر العثور على إصدار مطابق للحزمة dxpr/dxpr_builder». الحزمة على drupal.org هي drupal/dxpr_builder. استبدلوا dxpr/dxpr_builder بـ drupal/dxpr_builder في composer.json، ثم شغّلوا composer update drupal/dxpr_builder.
  • يرفض Composer لأن المجلد غير مُدار مع Composer. نُسِخت نسخة يدويًا. احذفوا modules/contrib/dxpr_builder وشغّلوا أمر require مجددًا.
  • «تُجُووزت حصة القرص» أو «فشلت الكتابة». أخلُوا مساحة قرص على الخادم قبل إعادة المحاولة.

يفشل تحديث قاعدة البيانات

  • «تعذّر تثبيت الوحدات key بسبب الوحدات المفقودة key». يحتاج الإصدار 3.x وحدة Key، والتحديث 9020 يثبّتها. وشيفرتها مفقودة لأن الوحدة لم تُثبَّت مع Composer. شغّلوا composer require drupal/key، ثم drush updb -y مجددًا.
  • يفشل خطاف تحديث مسمى. شغّلوا drush updb -vvv وأرفقوا الخطأ الكامل في تذكرتكم.
  • «الوحدة 'dxpr_builder_page' تفتقد تبعيتها الوحدة field_group». تحتاج الوحدة الفرعية DXPR Builder Drag and Drop Page وحدة Field Group. شغّلوا composer require drupal/field_group، ثم drush en dxpr_builder_page -y.

تبدو الصفحات معطلة بعد التحديث

تحوّل بعض الإصدارات الوسوم القديمة، مثل كاروسيلات Owl وعدّادات الدوائر، دفعات أثناء drush updb. والعناصر التي تفشل تبقى معلقة.

  1. انتقلوا إلى DXPR Studio > DXPR Builder > عناصر المحتوى > الترحيلات (/admin/dxpr_studio/dxpr_builder/migration-status).
  2. إذا عرض ترحيل معلّق، انقروا التشغيل الآن أو تشغيل كل الترحيلات المعلقة.
  3. راجعوا التقارير > رسائل السجل الأخيرة للعناصر التي تخطتها دفعة.

يرفض Composer ترقية رئيسية لنواة Drupal

يدعم DXPR Builder 3.x إصدار Drupal 10.2 فأحدث، وDrupal 11.

  1. راجعوا ملاحظات إصدار DXPR Builder وDXPR Theme وDXPR Theme Helper للإصدار الذي يدعم الإصدار الرئيسي الجديد.
  2. شغّلوا Upgrade Status لرؤية الحزم غير الجاهزة.
  3. ثبّتوا الإصدار الرئيسي للنواة في composer.json. فأمر composer require drupal/core-recommended غير المقيد قد يسحب الإصدار الرئيسي التالي خطأ.

تعطّل المحرر بعد التحديث مباشرة

اتبعوا المحرر لا يظهر. فالأسباب الأولى هناك هي التي تلي تحديثًا جزئيًا: تحديثات قاعدة بيانات معلقة وملفات قديمة وذاكرة تجميع مبنية من الإصدار القديم.

أرحّل من Glazed Builder

لم يعد DXPR Builder 3.x يحوّل أسماء فئات Glazed في المحتوى المخزّن. حدّثوا إلى آخر إصدار 2.x أولًا وشغّلوا تحديثات قاعدة بياناته، ثم حدّثوا إلى 3.x. راجعوا الترحيل من DXPR Builder 1.x أو 2.x.

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

drush updb يُبلِغ عن عدم وجود تحديثات معلقة، ويعرض drush pm:list --filter=dxpr الإصدارات المقصودة، وصفحة منشئ معاد حفظها تُعرض بالطريقة نفسها في المحرر وللزائر.

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

تحديث DXPR Builder لإجراء التحديث الروتيني.