Jak dodać chatbota Asyntai AI do Backdrop CMS

Przewodnik krok po kroku dla stron Backdrop CMS

Platforma:

Krok 1: Pobierz swój kod osadzania

Najpierw przejdź do swojego Panelu Asyntai i przewiń w dół do sekcji "Kod osadzania". Skopiuj swój unikalny kod osadzania, który będzie wyglądał tak:

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

Uwaga: Powyższy kod to tylko przykład. Musisz skopiować swój własny unikalny kod osadzania z Panelu, ponieważ zawiera on Twój osobisty identyfikator widgetu.

Krok 2: Dodaj do szablonu motywu (zalecane)

Backdrop CMS używa plików szablonów .tpl.php w swoich motywach. Zalecane podejście to dodanie kodu osadzania bezpośrednio do szablonu strony aktywnego motywu:

Uzyskaj dostęp do instalacji Backdrop CMS przez FTP lub Menedżer plików
Przejdź do katalogu aktywnego motywu: themes/yourtheme/
Otwórz plik page.tpl.php (lub layout.tpl.php w zależności od motywu)
Znajdź zamykający tag </body> lub linię <?php print $page_bottom; ?>
Wklej swój kod osadzania Asyntai tuż przed tą linią
Zapisz plik

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

Wskazówka: Umieszczenie kodu tuż przed <?php print $page_bottom; ?> lub zamykającym tagiem </body> zapewnia, że chatbot ładuje się po treści strony, co zapewnia lepszą wydajność ładowania. Ta metoda automatycznie dodaje chatbota do każdej strony korzystającej z tego motywu.

Metoda alternatywna 1: Użycie modułu niestandardowego

Możesz utworzyć prosty moduł Backdrop CMS, który wstrzykuje skrypt chatbota za pomocą backdrop_add_js():

Utwórz katalog modułu: modules/custom/asyntai_widget/
Utwórz plik modułu asyntai_widget.module z następującym kodem:
// 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'), )); }
Utwórz plik 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
Przejdź do Funkcjonalności (admin/modules) w panelu administracyjnym Backdrop
Znajdź "Asyntai AI Chatbot Widget" w pakiecie Custom i włącz go
Kliknij "Zapisz konfigurację"

Uwaga: Zamień YOUR_WIDGET_ID w kodzie modułu na swój rzeczywisty identyfikator widgetu z Panelu Asyntai. Podejście z modułem niestandardowym jest bezpieczne podczas aktualizacji i nie zostanie nadpisane przy aktualizacji motywu.

Metoda alternatywna 2: Użycie modułu "Add to Head" Backdrop

Dodatkowy moduł "Add to Head" zapewnia łatwy sposób na wstrzykiwanie skryptów bez edycji kodu:

Pobierz i zainstaluj dodatkowy moduł "Add to Head" ze strony Backdrop CMS
Przejdź do Konfiguracja > Rozwój > Add to Head
Dodaj swój kod osadzania Asyntai w sekcji stopki
Kliknij "Zapisz konfigurację"

Wskazówka: Użycie modułu "Add to Head" jest najłatwiejszą metodą, jeśli wolisz nie edytować plików motywu ani nie tworzyć niestandardowych modułów. Zapewnia prosty interfejs administracyjny do zarządzania wstrzykiwanymi skryptami.

Metoda alternatywna 3: Użycie systemu bloków

System układu i bloków Backdrop CMS może być również używany do dodania chatbota:

Zaloguj się do panelu administracyjnego Backdrop CMS
Przejdź do Structure > Layouts
Wybierz układ, który chcesz edytować (np. układ domyślny)
Kliknij "Add block" w sekcji stopki
Wybierz "Custom block"
Ustaw format bloku na "Full HTML" lub "Raw HTML"
Wklej kod osadzania Asyntai w treści bloku
Nadaj blokowi tytuł (np. "Asyntai Chatbot") i opcjonalnie zaznacz "Hide title"
Kliknij "Save block", a następnie "Save layout"

Ważne: Upewnij się, że format tekstu jest ustawiony na "Full HTML" lub "Raw HTML", aby znacznik script nie został usunięty. Domyślny format "Filtered HTML" usuwa znaczniki script ze względów bezpieczeństwa.

Krok 3: Wyczyść pamięć podręczną i zweryfikuj

Po wprowadzeniu zmian wyczyść pamięć podręczną Backdrop CMS i zweryfikuj instalację:

Przejdź do Configuration > Performance w panelu administracyjnym
Kliknij "Clear all caches"
Otwórz swoją stronę internetową w nowej karcie przeglądarki lub w oknie incognito
Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu
Kliknij go, aby upewnić się, że otwiera się i działa prawidłowo

Nie widzisz widgetu? Upewnij się, że wyczyściłeś pamięć podręczną Backdrop CMS w Configuration > Performance. Spróbuj wyświetlić stronę w oknie incognito lub wyczyść pamięć podręczną przeglądarki. Otwórz konsolę przeglądarki (F12), aby sprawdzić, czy nie ma błędów JavaScript. Jeśli użyłeś metody z własnym modułem, sprawdź, czy moduł jest włączony w sekcji Functionality.