Jak dodać chatbota AI Asyntai do Drupal

Instrukcja krok po kroku dla stron Drupal

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: Użycie modulu Header and Footer Scripts (zalecane)

Najłatwiejszym sposobem dodania chatbota jest użycie modulu "Header and Footer Scripts":

Zaloguj sie do panelu administracyjnego Drupal
Przejdź do Extend i kliknij "Install new module\"
Wyszukaj "Header and Footer Scripts" lub pobierz go z Drupal.org
Zainstaluj i włącz moduł
Przejdź do Configuration → Development → Header and Footer Scripts
Kliknij zakładkę "Footer"
Wklej kod osadzania Asyntai w polu tekstowym skryptów stopki
Kliknij "Zapisz konfigurację"

Wskazówka: Dodanie kodu do sekcji stopki zapewnia jego załadowanie po zawartości strony, co jest zalecane dla widgetów czatu.

Alternatywa: Edycja szablonu motywu

Możesz dodać kod bezpośrednio do pliku szablonu motywu:

Przejdź do folderu motywu: themes/your_theme/
Otwórz plik html.html.twig (lub utwórz go, jeśli nie istnieje)
Znajdź zamykający znacznik </body>
Wklej kod osadzania Asyntai tuz przed znacznikiem </body>
Zapisz plik
Wyczyść pamięć podręczna Drupal: Configuration → Performance → Clear all caches

Ważne: Zmiany w plikach motywu mogą zostac nadpisane podczas aktualizacji motywu. Rozważ użycie motywu potomnego lub modulu Header and Footer Scripts jako bardziej trwalego rozwiązania.

Alternatywa: Użycie bibliotek (dla deweloperow)

Dla deweloperow, którzy wola używać systemu bibliotek zasobow Drupal:

Utwórz lub edytuj plik *.libraries.yml motywu
Dodaj nowy wpis biblioteki:
asyntai-chatbot: js: https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
Dołącz biblioteke w pliku *.info.yml motywu:
libraries: - your_theme/asyntai-chatbot
Wyczyść pamięć podręczna Drupal

Krok 3: Weryfikacja instalacji

Po zapisaniu zmian i wyczyszczeniu pamięci podręcznej odwiedź witrynę w nowej karcie przeglądarki lub w trybie incognito. Przycisk widgetu czatu powinien byc widoczny w prawym dolnym rogu. Kliknij go, aby upewnić sie, ze otwiera sie i działa poprawnie.