Как да добавите Asyntai AI чатбот в 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"
Потърсете "Header and Footer Scripts" или го изтеглете от Drupal.org
Инсталирайте и активирайте модула
Отидете на Configuration → Development → Header and Footer Scripts
Кликнете върху раздела "Footer"
Поставете вашия Asyntai код за вграждане в полето Footer Scripts
Натиснете "Save configuration"

Съвет: Добавянето на кода в секцията на футъра гарантира, че той се зарежда след съдържанието на страницата, което е препоръчително за чат уиджети.

Алтернатива: Редактиране на шаблона на темата

Можете да добавите кода директно към файла на шаблона на вашата тема:

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

Важно: Промените по файловете на темата могат да бъдат презаписани при актуализиране на темата. Помислете за използване на дъщерна тема или модула Header and Footer Scripts за по-трайно решение.

Алтернатива: Използване на библиотеки (За разработчици)

За разработчици, които предпочитат да управляват скриптовете като файлове:

Създайте или редактирайте файла *.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: Проверка на инсталацията

След като запазите промените и изчистите кеша, посетете уебсайта си в нов раздел на браузъра или в инкогнито прозорец. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Кликнете върху него, за да се уверите, че се отваря и работи правилно.