Как да добавите Asyntai AI чатбот към Backdrop CMS

Ръководство стъпка по стъпка за Backdrop CMS уебсайтове

Платформа:

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

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

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

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

Стъпка 2: Добавяне към шаблона на темата (Препоръчително)

Backdrop CMS използва .tpl.php шаблонни файлове в темите си. Препоръчителният подход е да добавите кода за вграждане директно в шаблона на страницата на активната ви тема:

Достъпете вашата Backdrop CMS инсталация чрез FTP или Файлов мениджър
Навигирайте до директорията на вашата активна тема: themes/yourtheme/
Отворете файла page.tpl.php (или layout.tpl.php в зависимост от вашата тема)
Намерете затварящия таг </body> или реда <?php print $page_bottom; ?>
Поставете вашия Asyntai код за вграждане точно преди този ред
Запазете файла

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Съвет: Поставянето на кода точно преди <?php print $page_bottom; ?> или затварящия таг </body> гарантира, че чатботът се зарежда след съдържанието на страницата, осигурявайки по-добра производителност при зареждане. Този метод автоматично добавя чатбота към всяка страница, използваща тази тема.

Алтернативен метод 1: Използване на персонализиран модул

Можете да създадете прост Backdrop CMS модул, който инжектира скрипта на чатбота, използвайки backdrop_add_js():

Създайте директорията на модула: modules/custom/asyntai_widget/
Създайте файла на модула asyntai_widget.module със следния код:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
Създайте файла asyntai_widget.info:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Отидете на Функционалност (admin/modules) в администраторския панел на Backdrop
Намерете "Asyntai AI Chatbot Widget" под пакета Custom и го активирайте
Натиснете "Save configuration"

Забележка: Заменете YOUR_WIDGET_ID в кода на модула с вашия действителен ID на уиджета от Таблото за управление на Asyntai. Подходът с персонализиран модул е безопасен при надграждане и няма да бъде презаписан при актуализиране на темата ви.

Алтернативен метод 2: Използване на модула "Add to Head" на Backdrop

Контрибутираният модул "Add to Head" предоставя лесен начин за инжектиране на скриптове без редактиране на код:

Изтеглете и инсталирайте контрибутирания модул "Add to Head" от уебсайта на Backdrop CMS
Отидете на Configuration > Development > Add to Head
Добавете вашия Asyntai код за вграждане в раздела на долния колонтитул (footer section)
Натиснете "Save configuration"

Съвет: Използването на модула "Add to Head" е най-лесният метод, ако предпочитате да не редактирате файлове на темата или да създавате персонализирани модули. Той предоставя прост администраторски интерфейс за управление на инжектирани скриптове.

Алтернативен метод 3: Използване на блок системата

Системата за оформление и блокове на Backdrop CMS също може да се използва за добавяне на чатбота:

Влезте в администраторския панел на Backdrop CMS
Отидете на Structure > Layouts
Изберете оформлението, което искате да редактирате (напр. оформлението по подразбиране)
Натиснете "Add block" в областта на долния колонтитул
Изберете "Custom block"
Задайте формата на блока на "Full HTML" или "Raw HTML"
Поставете вашия Asyntai код за вграждане в тялото на блока
Дайте на блока заглавие (напр. "Asyntai Chatbot") и по желание отметнете "Hide title"
Натиснете "Save block" и след това "Save layout"

Важно: Уверете се, че текстовият формат е зададен на "Full HTML" или "Raw HTML", за да не бъде премахнат тагът script. Форматът "Filtered HTML" по подразбиране ще премахне таговете script от съображения за сигурност.

Стъпка 3: Изчистване на кеша и проверка

След като направите промените си, изчистете кеша на Backdrop CMS и проверете инсталацията:

Отидете на Configuration > Performance в администраторския панел
Натиснете "Clear all caches"
Отворете уебсайта си в нов таб на браузъра или в режим инкогнито
Трябва да видите бутона на чат уиджета в долния десен ъгъл
Натиснете го, за да се уверите, че се отваря и работи правилно

Не виждате уиджета? Уверете се, че сте изчистили кеша на Backdrop CMS от Configuration > Performance. Опитайте да прегледате сайта си в прозорец инкогнито или изчистете кеша на браузъра. Отворете конзолата на браузъра (F12), за да проверите за JavaScript грешки. Ако сте използвали метода с персонализиран модул, проверете дали модулът е активиран под Функционалност.