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

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

Платформа:

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

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

<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>

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

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

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

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

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

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

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

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

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

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

Для розробників, які віддають перевагу системі бібліотек активів 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: Перевірте встановлення

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