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

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

Платформа:

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

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

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

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

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

Найпростіший спосіб додати чат-бот - використання модуля "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: Configuration → Performance → Clear all caches

Важливо: Зміни у файлах теми можуть бути перезаписані під час оновлення теми. Розгляньте використання дочірньої теми або модуля 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: Перевірте встановлення

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