Как добавить ИИ-чат-бот Asyntai в Drupal

Пошаговое руководство для сайтов на Drupal

Платформа:

Шаг 1: Получите код встраивания

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.

Шаг 2: Через модуль скриптов шапки и подвала (рекомендуется)

Самый простой способ добавить чат-бот — использовать модуль «Header and Footer Scripts»:

Войдите в панель администратора Drupal
Перейдите в Extend и нажмите "Install new module"
Search for "Header and Footer Scripts" or download it from Drupal.org
Установите и включите модуль
Перейдите в Configuration → Development → Header and Footer Scripts
Нажмите на вкладку «Footer»
Вставьте код встраивания Asyntai в текстовую область скриптов футера
Нажмите «Save configuration»

Совет: Добавление кода в раздел футера гарантирует загрузку после контента страницы — это рекомендуется для чат-виджетов.

Альтернатива: Шаблон темы

Вы можете добавить код напрямую в файл шаблона вашей темы:

Перейдите в папку вашей темы: themes/your_theme/
Откройте файл html.html.twig (или создайте его, если он не существует)
Найдите закрывающий тег </body>
Вставьте код встраивания Asyntai непосредственно перед тегом </body>
Сохраните файл
Очистить кэш Drupal: Конфигурация → Производительность → Очистить все кэши

Важно: Изменения в файлах темы могут быть перезаписаны при её обновлении. Для более надёжного решения рекомендуется использовать дочернюю тему или модуль Header and Footer Scripts.

Альтернатива: Через библиотеки (для разработчиков)

Для разработчиков, предпочитающих систему библиотек ресурсов Drupal:

Создайте или отредактируйте файл *.libraries.yml вашей темы
Добавьте новую запись в библиотеку:
asyntai-chatbot: js: https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
Подключите библиотеку в файле *.info.yml вашей темы:
libraries: - your_theme/asyntai-chatbot
Очистить кэш Drupal

Шаг 3: Проверка установки

После сохранения изменений и очистки кэша откройте сайт в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.