Як додати AI чат-бот Asyntai до Drupal

Покрокова iнструкцiя для веб-сайтiв Drupal

Платформа:

Крок 1: Отримайте код для вставки

Спочатку перейдiть до вашої Панелi керування Asyntai та прокрутiть вниз до роздiлу "Код для вставки". Скопiюйте унiкальний код для вставки, який виглядатиме так:

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

Примiтка: Код вище є лише прикладом. Ви повиннi скопiювати власний унiкальний код для вставки з вашої Панелi керування, оскiльки вiн мiстить ваш особистий ID вiджета.

Крок 2: Використання модуля Header and Footer Scripts (Рекомендовано)

Найпростiший спосiб додати чат-бот - використання модуля "Header and Footer Scripts":

Увiйдiть до адмiнiстративної панелi Drupal
Перейдiть до Extend та натиснiть "Install new module"
Знайдiть "Header and Footer Scripts" або завантажте з Drupal.org
Встановiть та увiмкнiть модуль
Перейдiть до Configuration → Development → Header and Footer Scripts
Натиснiть на вкладку "Footer"
Вставте код вбудовування Asyntai у текстове поле футерних скриптiв
Натиснiть "Save configuration"

Порада: Додавання коду до роздiлу футера забезпечує його завантаження пiсля контенту сторiнки, що рекомендується для чат-вiджетiв.

Альтернатива: Редагування шаблону теми

Ви можете додати код безпосередньо до файлу шаблону вашої теми:

Перейдiть до папки вашої теми: themes/your_theme/
Вiдкрийте файл html.html.twig (або створiть його, якщо його не iснує)
Знайдiть закриваючий тег </body>
Вставте ваш код для вставки Asyntai безпосередньо перед тегом </body>
Збережiть файл
Очистiть кеш Drupal: Configuration → Performance → Clear all caches

Важливо: Змiни у файлах теми можуть бути перезаписанi пiд час оновлення теми. Розгляньте використання дочiрньої теми або модуля Header and Footer Scripts для бiльш надiйного рiшення.

Альтернатива: Використання бiблiотек (Для розробникiв)

For developers who prefer using Drupal's asset library system:

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

Крок 3: Перевiрте встановлення

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