Встановлення 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 модулі ядра: Field, Field UI, Views, Image та Block.

Додавання ключа продукту

  1. Перейдіть до DXPR Studio > DXPR Builder > Загальні налаштування (/admin/dxpr_studio/dxpr_builder/settings).
  2. У розділі Ліцензія виберіть Спосіб зберігання.
  3. Для варіанта Зберігання в конфігурації вставте ключ у поле Ключ продукту. Для варіанта Модуль Key виберіть свій ключ у полі Ключ.
  4. Натисніть Зберегти налаштування.

Зберігання в конфігурації тримає ключ у конфігурації сайта, тож він потрапляє до експорту конфігурації. Модуль Key читає його з ключа, який ви спочатку створюєте за адресою /admin/config/system/keys. Надайте тому ключу постачальника File або Environment, щоб він теж не потрапляв до експорту.

Сторінка загальних налаштувань DXPR Builder із конфігурацією ключа продукту

Додавання підмодулів (необов’язково)

DXPR Builder постачається з трьома підмодулями. Увімкніть потрібний командою drush en з його назвою.

Підмодуль Що додає Потрібно
dxpr_builder_page Тип вмісту Drag and drop Page, уже перемкнутий на конструктор Модуль «Field Group»
dxpr_builder_block Тип блоків Drag and Drop Block для вмісту конструктора в регіонах блоків Модуль ядра Block Content, увімкнутий заздалегідь
dxpr_builder_media Застарілий браузер медіа на основі Entity Browser; прихований на сторінці «Розширити» Entity Browser та Inline Entity Form

Більшості сайтів підмодуль медіа не потрібен. Якщо на час встановлення увімкнено Media Library ядра, конструктор використовує його. Інакше виберіть його пізніше в розділі Медіа > Тип браузера на сторінці налаштувань. Деталі наведено на сторінці Архітектура підмодулів.

Увімкнення функцій ШІ (необов’язково)

Створення сторінок, текст і зображення від ШІ працюють через модуль 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. Тип Drag and drop Page із dxpr_builder_page уже налаштовано, тож там кроки 2–5 можна пропустити.

  1. Перейдіть до DXPR Studio > DXPR Builder > Загальні налаштування і перевірте розділ Ліцензія щодо свого ключа продукту.
  2. Перейдіть до Структура > Типи вмісту. Відкрийте меню біля типу вмісту з полем Body і натисніть Керувати показом.
  3. Якщо відкрився огляд режимів перегляду, натисніть Керувати для Default.
  4. Змініть Формат поля Body на DXPR Builder.
  5. Натисніть Зберегти.
  6. Створіть вміст цього типу й введіть Title.
  7. Натисніть Зберегти.
  8. Наведіть вказівник на область вмісту. З’явиться панель інструментів DXPR Builder.

Що ви бачите

На збереженій сторінці показано порожній конструктор там, де був би текст. Він пропонує запрошення ШІ, неактивне, доки ШІ не налаштовано, а також Виберіть шаблон і Додати елементи. Натисніть Додати елементи: засіб вибору елементів відкриється з вкладками Макет і Вміст. DXPR Builder працює.

Якщо ви не бачите конструктора

  • На сторінці показано текст, але немає конструктора. Поле досі використовує інший форматувальник. Укажіть для нього Формат DXPR Builder у режимі перегляду Default у розділі Структура > Типи вмісту > Керувати показом.
  • У формі редагування показано звичайне текстове поле. DXPR Builder працює на збереженій сторінці, а не у формі редагування. Збережіть вміст і відкрийте його сторінку.
  • Конструктор показується лише адміністратору. Іншим ролям бракує дозволу Редагувати за допомогою 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. Скопіюйте свій поточний ключ ще раз без пробілів і розривів рядків.

Редактор не з’являється охоплює більше причин.

Що далі?