Как да добавите Asyntai AI чатбот в Drupal

Ръководство стъпка по стъпка за уебсайтове на Drupal

Платформа:

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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"
Paste your Asyntai embed code in the footer scripts text area
Натиснете "Save configuration"

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

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

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

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

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

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

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

Create 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 } }
Attach the library in your theme's *.info.yml file:
libraries: - your_theme/asyntai-chatbot
Изчистете кеша на Drupal

Стъпка 3: Проверка на инсталацията

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