تحديث DXPR Builder.

حدّثوا DXPR Builder للحصول على إصلاحات الأخطاء والميزات الجديدة والإصلاحات الأمنية. حدّثوا الشيفرة باستخدام Composer، ثم دعوا Drupal يحوّل الإعدادات والمحتوى باستخدام drush updatedb. واستخدموا هذه الصفحة للتحديثات ضمن سلسلة 3.x. أما إذا كانت نسختكم 1.x أو 2.x فاتبعوا الترحيل من DXPR Builder 1.x أو 2.x بدلًا من ذلك.

قبل أن تبدؤوا

• انسخوا قاعدة البيانات احتياطيًا:

  drush sql:dump > backup-$(date +%Y%m%d).sql
  

• اقرؤوا سجل التغييرات و صفحة إصدارات GitHub للاطلاع على التغييرات التي تتطلب إجراءً، مثل الانتقال إلى Font Awesome 7.

• جرّبوا التحديث أولًا على نسخة مرحلية من الموقع.

تحديث الوحدة

1. حدّثوا الشيفرة:

   composer update drupal/dxpr_builder --with-dependencies
   

2. شغّلوا تحديثات قاعدة البيانات. ويمكنكم أيضًا زيارة /update.php بدلًا من ذلك:

   drush updatedb
   

   تحوّل بعض التحديثات كل قيمة من قيم حقول DXPR Builder على دفعات. وفي المواقع الكبيرة تستغرق دقائق لا ثوانٍ.

3. أعيدوا بناء ذواكر التخزين المؤقت ليستلم المتصفحون أوراق الأنماط والنصوص البرمجية الجديدة:

   drush cache:rebuild
   

ما ترونه

تبدو الصفحات ذات محتوى DXPR Builder كما كانت من قبل. حوموا فوق الصفحة أثناء التحرير وستظهر أشرطة التحكم؛ أجروا تغييرًا صغيرًا وانقروا حفظ للتحقق من عمل الحفظ. وما زالت General Settings تعرض مفتاح المنتج الخاص بكم تحت License.

ثم افتحوا التقارير > تقرير الحالة (/admin/reports/status). وبجانب DXPR Builder content migrations ستجدون All migrations completed.

إذا لم تظهر لكم النسخة الجديدة

• ما زال المحرّر يتصرف كما في النسخة القديمة. يحتفظ المتصفح بملفات المحرّر القديمة. أعيدوا التحميل باستخدام Ctrl+Shift+R، أو Cmd+Shift+R على Mac.
• يقول تقرير الحالة: «Some DXPR Builder content migrations have not been completed». ما زال بعض المحتوى بانتظار التحويل. افتحوا View migration status من تلك الرسالة، أو انتقلوا إلى /admin/dxpr_studio/dxpr_builder/migration-status وانقروا Run all pending migrations.
• تبدو الصفحات غير سليمة أو بعض العناصر مفقودة. انظروا مشكلات ما بعد التحديث لمعرفة الأسباب والحلول.

إذا عطّل التحديث الموقع ولم يساعد ما سبق، تراجعوا عنه:

1. استعيدوا نسختكم الاحتياطية من قاعدة البيانات:

   drush sql:cli < backup-20260901.sql
   

2. استعيدوا النسخة التي كنتم عليها، مثل 3.0.0-beta19:

   composer require 'drupal/dxpr_builder:3.0.0-beta19'
   

3. أعيدوا بناء ذواكر التخزين المؤقت:

   drush cache:rebuild
   

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

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