Jak dodać chatbota AI Asyntai do October CMS

Przewodnik krok po kroku dla witryn October 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 układu (zalecane)

Zalecanym sposobem dodania chatbota jest edycja domyślnego układu w panelu October CMS:

Zaloguj się do panelu October CMS
Przejdź do CMS > Layouts w menu głównym
Otwórz domyślny układ (zwykle default.htm)
Znajdź zamykający </body> tag i {% scripts %} symbol zastepczy
Dodaj swój kod osadzania Asyntai tuż przed {% scripts %} i </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Kliknij "Save", aby zastosować zmiany

Wskazówka: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Możesz użyć symbolu zastępczego skryptów October CMS, aby wstrzyknąć chatbota ze strony lub fragmentu szablonu:

Otwórz dowolną stronę lub fragment szablonu w edytorze CMS
Dodaj następujący kod, używając {% put scripts %} blok:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Zamien YOUR_WIDGET_ID na rzeczywisty identyfikator widgetu z panelu sterowania
Kliknij "Save"

Uwaga: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Metoda alternatywna 2: Użycie komponentu PHP

Jeśli preferujesz podejście programistyczne, możesz dodać skrypt chatbota za pomocą niestandardowego komponentu:

Utwórz lub zmodyfikuj komponent w swojej wtyczce October CMS
W metodzie onRun() komponentu użyj metody addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Zamień YOUR_WIDGET_ID na rzeczywisty identyfikator widgetu
Zarejestruj komponent na stronach, na których chcesz wyświetlać chatbota

Wskazówka: Użycie komponentu daje programistyczną kontrolę nad tym, kiedy i gdzie chatbot się ładuje. Możesz dodać logikę warunkową wewnątrz onRun(), aby kontrolować ładowanie na podstawie ról użytkowników, typów stron lub innych kryteriów.

Metoda alternatywna 3: Użycie fragmentu szablonu (Partial)

Możesz utworzyć fragment szablonu wielokrotnego użytku dla widgetu czatu:

Przejdź do CMS > Partials w panelu October CMS
Kliknij \"+ Add\", aby utworzyć nowy fragment szablonu
Nazwij go asyntai-widget.htm
Dodaj kod osadzania Asyntai do fragmentu szablonu:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Kliknij "Save"
Otwórz szablon układu i dołącz fragment szablonu przed </body>:
{% partial 'asyntai-widget' %}
Zapisz układ

Wskazówka: Użycie fragmentu szablonu ułatwia włączanie lub wyłączanie chatbota na całej stronie poprzez dodanie lub usunięcie dołączenia fragmentu szablonu z układu.

Krok 3: Weryfikacja instalacji

Po zapisaniu zmian odwiedź swoją stronę October CMS 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 poprawnie.

Nie widzisz widgetu? Upewnij się, że zapisałeś wszystkie zmiany w panelu administracyjnym CMS. Wyczyść pamięć podręczną przeglądarki lub wyświetl stronę w oknie incognito. Jeśli Twoja strona korzysta z buforowania, wyczyść pamięć podręczną October CMS, uruchamiając php artisan cache:clear z wiersza poleceń lub użyj opcji Settings > System > Clear Cache w panelu administracyjnym.

Wybór układu: Upewnij się, że strony, na których chcesz wyświetlać chatbota, używają właściwego układu. Możesz sprawdzić, jakiego układu używa strona, otwierając ją w CMS > Pages i sprawdzając listę rozwijaną Layout w ustawieniach strony.