Перевизначте шаблони DXPR Builder.

Вивчення DXPR BuilderКерування сайтомАдаптація під бренд

DXPR Builder рендерить свої елементи в браузері, із шаблонів, скомпільованих у редактор. Немає шаблону елемента, який ви можете скопіювати в тему. Модуль постачає чотири Twig-шаблони для власних сторінок, і ви перевизначаєте їх звичайним способом Drupal. Ця сторінка перелічує їх, пояснює, чому розмітку елементів не можна перевизначити, і вказує на маршрути, які модуль натомість підтримує.

Twig-шаблони, які ви можете перевизначити

Шаблони живуть у теці templates/ модуля:

Шаблон Використовується для Змінні
dxpr-license-info.html.twig Підсумок використання на сторінках User Licenses і Content items, та License info-блок used_count, total_count, limit, block_label, total_label, used_label, more_info_link
page--dxpr-builder--media-library.html.twig Обгортка сторінки діалогового вікна Media Library за шляхом /dxpr_builder/media-library стандартні page-змінні
html--dxpr-builder--media-library.html.twig Обгортка <html> того самого діалогового вікна стандартні html-змінні
page--people-list.html.twig Відправна точка для сторінки People (/admin/people) з підсумком ліцензії стандартні змінні page плюс user_license

Перші три працюють як є. Drupal не завантажує page--people-list.html.twig з модуля. DXPR Builder лише додає пропозицію page__people_list і змінну user_license на сторінці People. Щоб показати там підсумок, скопіюйте файл у свою тему адміністрування.

Щоб перевизначити шаблон:

  1. Скопіюйте файл із modules/contrib/dxpr_builder/templates/ у теку templates/ теми, яка його рендерить. Сторінки адміністрування та діалогове вікно Media Library використовують тему адміністрування. Блок License info використовує тему регіону, у який ви його помістили.
  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 теми, і власні стилі для текстового редактора
Додаткові набори піктограм Бібліотеки піктограм
Нові типи елементів Створення власних елементів

Що далі?