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

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

Платформа:

Шаг 1: Get Your Embed Code

Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

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

Шаг 2: Using Header and Footer Scripts Module (Recommended)

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

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

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

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

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

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

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

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

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

Создайте or edit your theme's *.libraries.yml file
Добавьте новую запись в библиотеку:
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: Verify Installation

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