Jak dodać chatbota AI Asyntai do ExpressionEngine
Instrukcja krok po kroku dla CMS ExpressionEngine
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>(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>
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 układu szablonu (zalecane)
Najłatwiejszym sposobem dodania chatbota do wszystkich stron jest edycja głównego szablonu układu w panelu sterowania ExpressionEngine:
- W panelu sterowania EE przejdź do Developer > Templates > Template Groups
- Otwórz główna grupe szablonów (zazwyczaj "site") i edytuj szablon ukladu (lub szablon opakowujacy wszystkie strony)
- Znajdź zamykający znacznik
</body> - Wklej kod osadzania Asyntai tuż przed znacznikiem
</body>:<!-- Asyntai AI Chatbot --> <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> </body> - Zapisz szablon
Wskazówka: Dodanie skryptu przed zamykającym znacznikiem </body> zapewnia, że ładuje się on po treści strony, co jest zalecane dla widgetów czatu i nie spowalnia ładowania strony.
Metoda alternatywna 1: Użycie części szablonów EE
Części szablonów ExpressionEngine umożliwiają tworzenie fragmentow kodu wielokrotnego uzytku, które można dołączać do różnych szablonów:
- Go to Developer > Templates > Template Partials
- Kliknij "New", aby utworzyć nowa część szablonu o nazwie
_asyntai_widget - Wklej kod osadzania Asyntai do treści części szablonu:
<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> - Zapisz część szablonu
- Dołącz ja do szablonu ukladu tuz przed zamykającym tagiem
</body>:{embed="_asyntai_widget"} </body>
Uwaga: Użycie części szablonów utrzymuje porządek w kodzie i ułatwia aktualizacje kodu osadzania chatbota w jednym miejscu na całej witrynie.
Metoda alternatywna 2: Użycie nagłówka/stopki HTML w EE
Niektóre konfigurację ExpressionEngine oferuja globalna sekcję stopki do dodawania skryptów:
- Przejdź do Settings > Content & Design > Global Template Preferences
- Jeśli Twoja konfiguracja EE posiada globalna sekcję stopki, wklej tam kod osadzania Asyntai
- Jeśli globalna sekcja stopki nie jest dostępna, edytuj bezpośrednio główny szablon ukladu i dodaj kod osadzania przed zamykającym tagiem
</body>:<!-- Asyntai AI Chatbot --> <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> </body> - Zapisz zmiany
Metoda alternatywna 3: Użycie config.php
Dla zaawansowanych użytkowników można wstrzyknąć skrypt chatbota przez konfigurację ExpressionEngine lub tworząc niestandardowy dodatek:
- Uzyskaj dostęp do plików projektu ExpressionEngine przez FTP, SSH lub edytor kodu
- Przejdź do katalogu
system/user/config/i otwórz plikconfig.php - W celu niestandardowego wstrzykiwania JavaScript rozważ utworzenie prostego dodatku/rozszerzenia EE, które podlacza sie do hooka
template_post_parsew celu wstrzyknięcia skryptu podczas renderowania strony:// In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<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>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; } - Zamien
YOUR_WIDGET_IDna rzeczywisty identyfikator widgetu z panelu sterowania
Ważne: Metoda z config.php i dodatkiem jest przeznaczona dla zaawansowanych użytkowników, którzy czuja sie swobodnie w programowaniu ExpressionEngine. Dla większości użytkowników zalecana jest metoda szablonu ukladu (Krok 2) lub metoda części szablonów (Metoda alternatywna 1).
Krok 3: Weryfikacja instalacji
Po zapisaniu zmian odwiedź witrynę ExpressionEngine 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.
Nie widzisz widgetu? Upewnij sie, ze zapisales szablon i ze edytujesz wlasciwy szablon ukladu używany przez strony. Wyczyść pamięć podręczna przeglądarki lub otwórz stronę w trybie incognito. Jeśli buforowanie szablonów ExpressionEngine jest włączone, wyczyść pamięć podręczna z panelu sterowania w sekcji Developer > Utilities > Cache Manager.
Weebly