تجاوز قوالب DXPR Builder.

تعلّم DXPR Builderإدارة الموقعطابقوا علامتكم

يعرض DXPR Builder عناصره في المتصفح، من قوالب مُجمَّعة في المحرّر. ولا يوجد قالب عنصر يمكنكم نسخه إلى قالب. لكن الوحدة تشحن أربعة قوالب Twig لصفحاتها الخاصة، ويمكنكم تجاوزها بالطريقة المعتادة في Drupal. تسرد هذه الصفحة القوالب، وتشرح لماذا لا يمكن تجاوز وسوم العناصر، وتشير إلى المسارات التي تدعمها الوحدة بدل ذلك.

قوالب Twig التي يمكنكم تجاوزها

تعيش القوالب في مجلد templates/ الخاص بالوحدة:

القالب يُستخدم لـ المتغيرات
dxpr-license-info.html.twig ملخص الاستخدام على صفحتي تراخيص المستخدمين وعناصر المحتوى وكتلة معلومات الترخيص المذكورة used_count وtotal_count وlimit وblock_label وtotal_label وused_label وmore_info_link
page--dxpr-builder--media-library.html.twig غلاف صفحة مربع حوار مكتبة الوسائط في /dxpr_builder/media-library متغيرات page المعيارية
html--dxpr-builder--media-library.html.twig غلاف <html> لمربع الحوار نفسه متغيرات html المعيارية
page--people-list.html.twig نقطة بداية لصفحة الأشخاص (/admin/people) مع ملخص ترخيص متغيرات page المعيارية إضافة إلى user_license

تعمل الثلاثة الأولى كما هي. ولا يحمّل Drupal الملف page--people-list.html.twig من الوحدة. فيضيف DXPR Builder فقط الاقتراح page__people_list والمتغير user_license على صفحة الأشخاص. ولعرض الملخص هناك، انسخوا الملف إلى قالب الإدارة الخاص بكم.

لتجاوز قالب:

  1. انسخوا الملف من modules/contrib/dxpr_builder/templates/ إلى مجلد templates/ الخاص بالقالب الذي يعرضه. فصفحات الإدارة ومربع حوار مكتبة الوسائط يستخدمان قالب الإدارة. وتستخدم كتلة معلومات الترخيص قالب المنطقة التي وضعتموها فيها.
  2. حرّروا النسخة.
  3. امسحوا ذاكرات التخزين المؤقت باستخدام drush cr.

لماذا لا يمكن تجاوز وسوم العناصر

وسوم كل عنصر قالب twig.js في dxpr_builder/templates/، مثلًا elements/alert/alert.twig.html. يجمّع البناء هذه القوالب في dxpr_builder/dxpr_templates.js. فيعرضها المحرّر في المتصفح ويحفظ HTML الناتج في الحقل. ويترتب على ذلك أمران:

  • يحتاج القالب المغيَّر إلى إعادة بناء المحرّر. والمواقع التي تحمّل المحرّر من DXPR CDN لا تستطيع استخدام قالب مغيَّر على الإطلاق.
  • تحتفظ الصفحات المحفوظة بـ HTML الذي حُفظت به. ولا يؤثر القالب الجديد إلا على العناصر المعروضة بعد التغيير.

فلا تقدّم الوحدة أي تجاوز لوسوم العناصر لكل موقع. استخدموا أحد المسارات أدناه.

مسارات التخصيص المدعومة

الهدف المسار
تخطيطات قابلة لإعادة الاستخدام للمحرّرين قوالب الصفحات وقوالب المستخدم، وكلاهما يُختار في المنشئ
تغيير مظهر العناصر CSS مخصص في القالب، موجَّه إلى فئاتكم الخاصة أو إلى az-* من الفئات
منح المحرّرين أنماطًا مُسمّاة فئات الأدوات من ملف .info.yml الخاص بالقالب، وأنماط مخصصة لمحرر النصوص
مجموعات أيقونات إضافية مكتبات الأيقونات
أنواع عناصر جديدة إنشاء عناصر مخصصة

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