Редактор не з’являється.

Вивчення DXPR BuilderКерування сайтомУсунення проблем

Ви відкриваєте сторінку й нічого не відбувається, коли ви вказуєте на вміст, або елементи керування показуються, але діалогове вікно налаштувань ніколи не відкривається. Пройдіть причини нижче за порядком. Перші чотири покривають більшість випадків.

Я у формі редагування матеріалу

Редактор працює на самій сторінці, а не у формі редагування. Збережіть матеріал, відкрийте сторінку й укажіть на область вмісту. Редактор також лишається вимкненим на сторінках ревізій, як-от /node/12/revisions/34/view.

Сторінка показує повідомлення про ключ продукту чи ліцензію

Редактор лишається вимкненим, доки показується одне з цих повідомлень:

  • «DXPR Builder needs a product key to work». Ключ продукту не задано. Перейдіть до DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings) і заповніть розділ License.
  • «Oops, the no-code editor is not loading here». Повідомлення називає причину: брак ліцензій користувачів, ліміт матеріалів вашого плану або обліковий запис без дійсної адреси електронної пошти. Див. Помилки ліцензії та ключа продукту.
  • «Access to DXPR Builder is blocked because of a payment or licensing problem». DXPR заблокував домен сайту. Зв’яжіться з DXPR через посилання в повідомленні.

Консоль показує помилки 401 або 403 від cdn2.dxpr.com

З Asset source, установленим на Cloud, скрипти редактора завантажуються з cdn2.dxpr.com із вашим ключем продукту в URL. 401 або 403 означає, що CDN відхилив ключ. Перевірте розділ License General Settings, потім див. сторінку Помилки ліцензії та ключа продукту. Якщо натомість запити вичерпують час очікування, файрвол блокує CDN; див. Використання DXPR Builder за файрволом.

Редактор зупинився після оновлення

  1. Виконайте drush updb -y (або відвідайте /update.php).
  2. Виконайте drush cr.
  3. Відкрийте одну сторінку конструктора й збережіть її знову.

Якщо журнал повідомляє про відсутній файл усередині папки модуля, код на сервері неповний. Перевстановіть код:

  1. Видаліть папку modules/contrib/dxpr_builder.
  2. Виконайте composer require drupal/dxpr_builder.
  3. Виконайте drush cr.

Важливо: ніколи не видаляйте модуль, щоб скинути його. Видалення стирає збережені шаблони, профілі й налаштування.

Елементи керування показуються, але діалогові вікна налаштувань ніколи не відкриваються

Консоль показує bootstrap is not defined або помилку про getOrCreateInstance. Діалогові вікна редактора працюють на JavaScript Bootstrap 5. Сторінка не має його, або тема натомість завантажує Bootstrap 3 чи 4.

  1. Перейдіть до General Settings і відкрийте розділ Bootstrap.
  2. Якщо ваша тема не завантажує Bootstrap 5, установіть Sideload Bootstrap files на Bootstrap 5 і натисніть Save settings.
  3. Якщо ваша тема завантажує JavaScript Bootstrap 3 чи 4, припиніть його завантажувати або перейдіть на тему Bootstrap 5.

Консоль показує помилку JavaScript від іншого скрипта

Інший скрипт на сторінці ламає редактор. У заявках підтримки винуватцями були банери згоди на файли cookie, менеджери тегів, вбудовування MailChimp і браузерний агент New Relic. Теми теж спричиняли це через бандл Webpack або власний JavaScript Bootstrap 3 чи 4, як і мініфікатори JavaScript.

  1. Перейдіть до Configuration > Development > Performance і вимкніть агрегацію JavaScript. Перезавантажте.
  2. Вимикайте модулі згоди, аналітики й моніторингу по одному. Перезавантажуйте після кожного.
  3. Перемкніться на тему ядра, як-от Olivero, для одного тесту.

Що означає результат:

  • Виправлено кроком 1: причина мініфікатор. Допоміжні бібліотеки редактора, як-от Sortable, агрегуються разом із рештою сторінки, тож Sortable is not defined із увімкненою агрегацією вказує сюди. З Advanced CSS/JS Aggregation змініть мініфікатор з JSqueeze на JSMin.
  • Виправлено кроком 2: тримайте цей модуль вимкненим на сторінках редагування або повідомте про конфлікт його супроводжувачу.
  • Виправлено кроком 3: причина JavaScript теми. Припиніть завантажувати JavaScript Bootstrap 3 чи 4 з теми й установіть Sideload Bootstrap files на Bootstrap 5.

Сторінка показує «The website encountered an unexpected error»

Журнал показує трасування стеку через DxprBuilderService, що називає вигляд або клас блока із іншого модуля.

Для редакторів конструктор перелічує кожне відображення виглядів і плагін блоків, щоб ви могли додавати їх на сторінки. Для кожного відвідувача він виводить блоки й вигляди, розміщені на сторінці. Один зламаний вигляд або блок, що кидає помилку на будь-якому кроці, кладе сторінку.

  1. Відкрийте Reports > Recent log messages і знайдіть вигляд або модуль, названий у трасуванні.
  2. Виправте або видаліть цей вигляд, або вимкніть цей модуль.
  3. Очистіть усі кеші.

Редактор ніколи не показується на одному типі вмісту

  1. Перейдіть до Structure > Content types > (type) > Manage display.
  2. Установіть формат поля конструктора на DXPR Builder.
  3. Повторіть для кожного режиму перегляду, що виводить поле, а не лише Default.

Заувага: редактору потрібне поле зі значенням, до якого приєднатися. Коли ви зберігаєте матеріал, DXPR Builder заповнює порожнє поле, що використовує формат DXPR Builder у відображенні Default. Матеріал, збережений до зміни формату, лишається порожнім: редагуйте його й збережіть один раз.

Лише деякі користувачі бачать редактор

Перевірте це для облікового запису, що не бачить редактора:

  1. У розділі People > Permissions (/admin/people/permissions) роль має Edit with DXPR Builder.
  2. Роль також може редагувати цей вміст, наприклад Basic page: Edit any content. Редактор завантажується лише для користувачів, які можуть оновлювати сторінку.
  3. Обліковий запис має дійсну адресу електронної пошти. Ліцензуванню вона потрібна.
  4. У формі редагування користувача Exclude from DXPR builder editing не позначено.
  5. У розділі DXPR Studio > DXPR Builder > User Profiles профіль для цієї ролі має позначений Start editor when page loads. Коли вимкнено, елементи керування з’являються лише після натискання на піктограму ока елементів керування контейнера.

Інший редактор заблокував вміст

У попередженні «The content ... is locked by» названо колегу, і контейнер показує лише кнопку Locked. Цей редактор натиснув усередині контейнера і ще не зберіг; блокування знімається, коли вони збережуть. Попросіть їх зберегти або натисніть Locked і підтвердьте, щоб перехопити. Якщо ви обоє продовжите редагувати, перемагає останнє збереження.

Підтвердьте виправлення

Перезавантажте в приватному вікні й укажіть на область вмісту. Панель контейнера показує View mode, More і Save, а консоль не показує червоних помилок.

Що далі?

Проблеми після оновлення, якщо редактор зламався одразу після релізу.