تثبيت DXPR Builder على موقع Drupal.

تعلّم DXPR Builderابدؤوا من هناالتثبيت والتحديث

ثبّتوا DXPR Builder على موقع Drupal تديرونه سلفًا، وأضيفوا مفتاح منتجكم وبدّلوا نوع محتوى واحدًا إلى المنشئ. وفي النهاية تحصلون على صفحة محفوظة تعرض المنشئ، جاهزة لعنصركم الأول. أتبدؤون موقعًا جديدًا بدلًا من ذلك؟ يضبط تثبيت DXPR CMS المنشئ والقالب وأنواع المحتوى دفعة واحدة.

يمر الفيديو في التثبيت على أنواع المحتوى الموجودة على الخطوات 2 إلى 8 من الفحص في نهاية هذه الصفحة.

قبل أن تبدؤوا

  • Drupal 10.2 أو أحدث، بما فيه Drupal 11، مع PHP 8.1 أو أحدث. تسرد المتطلبات الباقي.
  • Composer وDrush في مشروعكم.
  • مفتاح منتج. يحتاجه DXPR Builder ليعمل؛ تجدون مفتاحكم في dxpr.com/getting-started.

تثبيت الوحدة

  1. نزّلوا DXPR Builder 3.x باستخدام Composer. يُنشر الإصدار 3 كإصدارات تجريبية، فاسمحوا بها:

    composer require 'drupal/dxpr_builder:^3.0@beta'

    أما composer require drupal/dxpr_builder العادي فيثبّت سلسلة 2.x المستقرة بدلًا من ذلك.

  2. فعّلوا الوحدة:

    drush en dxpr_builder

    ويفعّل Drush أيضًا وحدة Key ووحدات النواة التي يحتاجها DXPR Builder: الحقل وواجهة الحقل وViews والصورة والكتلة.

إضافة مفتاح المنتج

  1. انتقلوا إلى DXPR Studio > DXPR Builder > الإعدادات العامة (/admin/dxpr_studio/dxpr_builder/settings).
  2. في قسم الترخيص، اختاروا طريقة التخزين.
  3. لـتخزين الإعدادات، الصقوا المفتاح في مفتاح المنتج. ولـوحدة Key، اختاروا مفتاحكم تحت المفتاح.
  4. انقروا حفظ الإعدادات.

تخزين الإعدادات يُبقي المفتاح في إعدادات الموقع، فينتهي في صادرات الإعدادات. وتقرأه وحدة Key من مفتاح تنشئونه أولًا في /admin/config/system/keys. امنحوا ذلك المفتاح موفّر الملف أو البيئة لإبعاده عن الصادرات أيضًا.

صفحة الإعدادات العامة لـ DXPR Builder مع ضبط مفتاح المنتج

إضافة الوحدات الفرعية (اختياري)

يُشحن DXPR Builder مع ثلاث وحدات فرعية. فعّلوا واحدة بـ drush en واسمها.

الوحدة الفرعية ما تضيفه تحتاج
dxpr_builder_page نوع المحتوى صفحة السحب والإفلات، المضبوط على المنشئ سلفًا وحدة Field Group المساهمة
dxpr_builder_block نوع الكتلة كتلة السحب والإفلات، لمحتوى المنشئ في مناطق الكتل وحدة نواة محتوى الكتل، مفعّلة أولًا
dxpr_builder_media متصفح وسائط قديم مبني على Entity Browser؛ مخفي في صفحة التوسعة للوحدات Entity Browser وInline Entity Form

لا تحتاج معظم المواقع وحدة وسائط. فعندما تكون وحدة مكتبة الوسائط الأساسية مفعّلة وقت التثبيت، يستخدمها المنشئ. وإلا فاختاروها لاحقًا تحت الوسائط > نوع المتصفح في صفحة الإعدادات. لدى بنية الوحدات الفرعية التفاصيل.

تشغيل ميزات الذكاء الاصطناعي (اختياري)

يعمل إنشاء الصفحات والنصوص والصور بالذكاء الاصطناعي عبر وحدة AI وDXPR AI Provider.

  1. نزّلوا الوحدتين:

    composer require drupal/ai drupal/ai_provider_dxpr

  2. فعّلوهما:

    drush en ai ai_provider_dxpr

  3. انتقلوا إلى /admin/config/ai/providers/dxpr، واختاروا المفتاح الذي يحمل مفتاح منتجكم تحت مفتاح DXPR API، واحفظوا.

  4. انتقلوا إلى /admin/dxpr_studio/dxpr_builder/ai_settings. تحت ميزات الذكاء الاصطناعي، تكون المربعات الثلاثة كلها معلّمة افتراضيًا. ألغوا تحديد أي ميزة لا تريدونها.

يشرح دليل ميزات الذكاء الاصطناعي كل إعداد.

التحقق من التثبيت

يظهر المنشئ على المحتوى الذي يستخدم حقل النص فيه منسّق DXPR Builder. وتضبط هذه الخطوات المنسّق على نوع محتوى مع حقل Body. أما النوع صفحة السحب والإفلات من dxpr_builder_page فمضبوط سلفًا، فتخطّوا هناك الخطوات 2 إلى 5.

  1. انتقلوا إلى DXPR Studio > DXPR Builder > الإعدادات العامة وتأكدوا من وجود مفتاح منتجكم في قسم الترخيص.
  2. انتقلوا إلى البنية > أنواع المحتوى. افتحوا القائمة بجانب نوع محتوى مع حقل Body وانقروا إدارة العرض.
  3. إذا فُتحت نظرة عامة على أنماط العرض، فانقروا إدارة لـالافتراضي.
  4. غيّروا تنسيق Body إلى DXPR Builder.
  5. انقروا حفظ.
  6. أنشئوا محتوى من ذلك النوع واكتبوا عنوانًا.
  7. انقروا حفظ.
  8. حوموا فوق منطقة المحتوى. فيظهر شريط أدوات DXPR Builder.

ما ترونه

تعرض الصفحة المحفوظة منشئًا فارغًا حيث كان نص المتن. وهو يقدّم أمرًا نصيًا للذكاء الاصطناعي، معطّلًا حتى يُعدّ الذكاء الاصطناعي، مع اختيار قالب وإضافة العناصر. انقروا إضافة العناصر: فيُفتح منتقي العناصر مع تبويبَي التخطيط والمحتوى. DXPR Builder يعمل.

إذا لم يظهر المنشئ

  • تعرض الصفحة نص المتن، لكن بلا منشئ. ما زال الحقل يستخدم منسّقًا آخر. اضبطوا تنسيقه على DXPR Builder في نمط العرض الافتراضي تحت البنية > أنواع المحتوى > إدارة العرض.
  • يعرض نموذج التحرير منطقة نص عادية. يعمل DXPR Builder على الصفحة المحفوظة، وليس على نموذج التحرير. احفظوا المحتوى وافتحوا صفحته.
  • يظهر المنشئ للمسؤول فقط. تفتقر الأدوار الأخرى إذن Edit with DXPR Builder. امنحوه في الأشخاص > الأذونات (/admin/people/permissions).
  • يرى محرر ثانٍ «يمكن لحساب واحد فقط استخدام DXPR Builder على المستوى المجاني لـ DXPR». يسمح المستوى المجاني بمحرر واحد. أدخلوا مفتاح منتج من اشتراك مدفوع تحت الترخيص.
  • يقول خطأ «مفتاح منتجكم غير صالح». رفضت شبكة CDN الخاصة بـ DXPR المفتاح. الصقوا المفتاح الكامل مجددًا تحت الترخيص في /admin/dxpr_studio/dxpr_builder/settings.
  • يقول خطأ «تعذّر تحميل موارد DXPR Builder السحابية». لا يستطيع المتصفح الوصول إلى cdn2.dxpr.com أو cdn.dxpr.com. اسمحوا بالمضيفين كليهما، كما يشرح جدار الحماية وإقامة البيانات.
  • يقول الأمر النصي للذكاء الاصطناعي «تتطلب ميزات الذكاء الاصطناعي وحدة AI». لم تُعدّ وحدات الذكاء الاصطناعي بعد. اتبعوا تشغيل ميزات الذكاء الاصطناعي، أو ألغوا تحديد الميزات تحت ميزات الذكاء الاصطناعي في /admin/dxpr_studio/dxpr_builder/ai_settings.
  • يبلّغ حفظ الإعدادات عن «مفتاح منتج غير صالح». النص الملصق ليس مفتاحًا كاملًا، أو هو مفتاح مصنوع لـ DXPR Builder 1.x. انسخوا مفتاحكم الحالي مجددًا، دون مسافات أو فواصل أسطر.

المحرر لا يظهر يغطي أسبابًا أكثر.

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