Перенесення сторінок з Paragraphs до DXPR Builder.

Вивчення DXPR BuilderПочніть звідсиПерехід з іншого конструктора

Ви перебудовуєте параграфи кожної сторінки як елементи DXPR Builder у новому полі того самого типу вмісту. Параграфи лишаються онлайн, доки кожна сторінка не буде готова. Після цього редактори проєктують сторінку на самій сторінці замість заповнення форм параграфів. Жоден інструмент не конвертує параграфи, але Drush може записати підготовлений HTML у багато сторінок одразу.

Перед початком

  • DXPR Builder встановлено, а ваш ключ продукту збережено, див. Загальні налаштування.
  • Ви можете керувати полями й відображенням типу вмісту.
  • Кожна сторінка типу вмісту рахується матеріалом, щойно його відображення використовує форматер DXPR Builder. Перевірте ваш ліміт на вкладці Content Items.

Налаштування

  1. Перейдіть до Structure > Content types (/admin/structure/types) і натисніть Manage fields для типу вмісту.
  2. Додайте поле: виберіть Formatted text, потім Long text, наприклад «Page content».
  3. Натисніть Manage display і встановіть Format нового поля на DXPR Builder.
  4. Лишіть поле Paragraphs на місці й натисніть Save.

Перебудова кожної сторінки

  1. Відкрийте сторінку. Порожнє поле DXPR Builder показується поруч із параграфами.
  2. Перебудуйте кожен параграф відповідним елементом із таблиці нижче.
  3. Скопіюйте текст кожного параграфа в нові елементи.
  4. Натисніть Save на панелі інструментів DXPR Builder.
Тип параграфа Елемент DXPR Builder
Text Text
Image Image
Text with image Row з двома стовпцями: Text і Image
Accordion Collapse panel на вкладці Layout.
Call to action Button
Video Video
Gallery Image carousel
Webform Блок вебформи на вкладці Drupal Blocks.
Anything else HTML або поєднання елементів

Перебудова багатьох сторінок за допомогою Drush

DXPR Builder перетворює HTML Bootstrap 5 на елементи, які можна перетягувати й редагувати. Якщо ви можете експортувати старий вміст як HTML, запишіть його в кожну сторінку за допомогою Drush. Спочатку спробуйте з --dry-run, який показує зміну без збереження:

drush dxb:page:update 42 --markup=@/tmp/page-42.html --dry-run
drush dxb:page:update 42 --markup=@/tmp/page-42.html

Команда знаходить поле DXPR Builder у стандартному відображенні типу вмісту. Вона зберігає нову ревізію, тож можна відкотитися.

Завершення переїзду

  1. У розділі Manage display перемістіть поле Paragraphs до Disabled і натисніть Save.
  2. Перевірте перебудовані сторінки, також на телефоні.
  3. Видаліть поле Paragraphs у розділі Manage fields лише коли його вміст більше не потрібен. Його видалення прибирає параграфи назавжди.

Що ви бачите

Кожна сторінка показує вміст поля DXPR Builder, а параграфи більше не з’являються. Редактори з дозволом Edit with DXPR Builder бачать елементи керування редагуванням на сторінці. Вкладка Content items перелічує кожну сторінку типу вмісту.

Якщо редактор не відображається

  • Сторінка показує старий і новий вміст. Поле Paragraphs досі у відображенні. Перемістіть його до Disabled у розділі Manage display.
  • Drush повідомляє «No DXPR Builder field found». Стандартне відображення не використовує форматер DXPR Builder. Установіть Format у розділі Manage display стандартного режиму перегляду.
  • Drush повідомляє «Multiple DXPR Builder fields found». Тип вмісту має більше одного такого поля. Назвіть поле, наприклад --field=field_page_content.
  • Поле показується, але елементів керування редагуванням немає. Ваш обліковий запис не має дозволу Edit with DXPR Builder або ваші ліміти ліцензії досягнуто. Див. Помилки ліцензії та ключа продукту.

Що далі?