Jak dodać chatbota AI Asyntai do MODX

Przewodnik krok po kroku dla witryn MODX 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 MODX (zalecane)

Zalecanym sposobem dodania chatbota jest edycja szablonu MODX bezpośrednio w MODX Managerze:

Zaloguj sie do MODX Managera (panel administracyjny)
W lewym pasku bocznym przejdź do Elements > Templates
Otwórz szablon witryny (zwykle nazywany "BaseTemplate" lub Twój aktywny szablon)
Znajdź zamykający tag </body> w kodzie szablonu
Wklej swoj kod osadzania Asyntai tuz przed zamykającym tagiem </body>
Kliknij "Save", aby zapisać szablon

<!-- Your existing template content -->

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

Wskazówka: Dodanie kodu tuz przed zamykającym tagiem </body> zapewnia, ze chatbot ładuje sie po całej zawartości strony, co jest zalecanym umiejscowieniem dla widgetów czatu i nie spowalnia ładowania strony.

Metoda alternatywna 1: Użycie fragmentu MODX (Chunk)

Możesz użyć MODX Chunk, aby kod osadzenia był oddzielny i wielokrotnego użytku:

W MODX Managerze przejdź do Elements > Chunks
Kliknij "New Chunk", aby utworzyć nowy fragment
Nazwij fragment "asyntaiWidget"
Wklej swoj kod osadzania Asyntai w obszarze zawartości fragmentu
Kliknij "Save"
Otwórz swoj szablon (w Elements > Templates)
Dodaj wywolanie fragmentu [[$asyntaiWidget]] tuz przed zamykającym tagiem </body>
Zapisz szablon

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Wskazówka: Użycie fragmentu (Chunk) ułatwia zarządzanie i aktualizowanie kodu osadzania w jednym miejscu, szczegolnie jeśli używasz wielu szablonów na swojej witrynie.

Metoda alternatywna 2: Użycie ustawień systemowych MODX (nagłówek/stopka HTML)

Niektóre konfiguracje MODX zawierają symbole zastępcze dla skryptów stopki w ustawieniach systemowych:

W MODX Managerze przejdź do System > System Settings
Filtruj wedlug "htmlhead" lub wyszukaj niestandardowe ustawienie systemowe dla skryptów stopki
Jeśli Twoja konfiguracja ma symbol zastepczy dla skryptów stopki (taki jak [[++footer_scripts]]), możesz go użyć
Ustaw wartość ustawienia systemowego na swoj kod osadzania Asyntai
Upewnij sie, ze odpowiedni symbol zastepczy [[++footer_scripts]] jest obecny w szablonie przed zamykającym tagiem </body>
Zapisz ustawienie systemowe

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Uwaga: Ta metoda zalezy od tego, czy Twoja konfiguracja MODX ma niestandardowe ustawienie systemowe dla skryptów stopki. Jeśli takie nie istnieje, możesz utworzyć niestandardowe ustawienie systemowe i odwolac sie do niego w szablonie za pomocą skladni [[++setting_key]].

Metoda alternatywna 3: Użycie wtyczki MODX (OnWebPagePrerender)

W ramach zaawansowanego podejścia możesz utworzyć wtyczkę MODX, która automatycznie wstrzykuje kod chatbota na każda stronę:

W MODX Managerze przejdź do Elements > Plugins
Kliknij "New Plugin", aby utworzyć nowa wtyczkę
Nazwij wtyczkę "AsyntaiChatbot"
Wklej następujący kod PHP w obszarze kodu wtyczki:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Kliknij zakładkę "System Events"
Zaznacz pole obok "OnWebPagePrerender", aby uruchomić te wtyczkę przy tym zdarzeniu
Kliknij "Save"

Ważne: Zamien YOUR_WIDGET_ID na swoj rzeczywisty identyfikator widgetu z panelu Asyntai. Ta wtyczka automatycznie wstrzyknie skrypt chatbota na każda stronę Twojej witryny MODX przed jej wyrenderowaniem.

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

Po dodaniu kodu osadzania za pomocą dowolnej z powyzszych metod należy wyczyść pamięć podręczna MODX i zweryfikować instalacje:

W MODX Managerze przejdź do Manage > Clear Cache (lub kliknij ikone czyszczenia pamięci podręcznej w gornym menu)
Otwórz swoja witrynę w nowej karcie przeglądarki lub oknie incognito
Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu strony
Kliknij go, aby upewnić się, że otwiera się i działa poprawnie

Nie widzisz widgetu? Upewnij sie, ze wyczysciles pamięć podręczna MODX z Manage > Clear Cache w MODX Managerze. Spróbuj również wyczyść pamięć podręczna przeglądarki lub wyświetlić witrynę w oknie incognito. Jeśli uzyles metody z wtyczka, sprawdź, czy zdarzenie systemowe \"OnWebPagePrerender" jest zaznaczone dla Twojej wtyczki.