Jak dodać chatbota AI Asyntai do Concrete CMS

Przewodnik krok po kroku dla stron Concrete CMS (wcześniej Concrete5)

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 kod do stopki motywu (zalecane)

Najlepszym sposobem dodania chatbota do wszystkich stron witryny Concrete CMS jest edycja pliku stopki motywu:

Uzyskaj dostęp do instalacji Concrete CMS przez FTP lub Menedżer plików
Przejdź do katalogu /application/themes/your_theme_name/
Znajdź i otwórz plik footer.php (lub odpowiedni szablon stopki)
Znajdź linię z zamykającym znacznikiem </body>
Wklej kod osadzania Asyntai tuż przed znacznikiem </body>
Zapisz plik i prześlij go z powrotem na serwer, jeśli edytujesz lokalnie
Wyczyść pamięć podręczną Concrete CMS: Dashboard → System & Settings → Clear Cache

Wskazówka: Dodanie kodu przed zamykającym znacznikiem </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: Blok HTML (najłatwiejsza dla osób niebędących programistami)

Jeśli wolisz nie edytować plików motywu, możesz użyć wbudowanego bloku HTML Concrete CMS:

Zaloguj się do swojego Panelu Concrete CMS
Przejdź do strony, na której chcesz dodać chatbota
Kliknij Edit Page (ikona ołówka na pasku narzędzi)
Kliknij Add Block w obszarze, w którym chcesz umieścić kod
Wyszukaj i wybierz blok HTML
Wklej kod osadzania Asyntai do edytora HTML
Kliknij Add, aby zapisać blok
Kliknij Publish, aby opublikować zmiany

Uwaga: Metoda bloku HTML jest świetna do dodawania chatbota na konkretne strony. Dla instalacji na całej witrynie musisz dodać blok HTML do każdej strony lub użyć metody stopki motywu opisanej powyżej. Wizualne umiejscowienie bloku nie wpływa na to, gdzie chatbot się pojawia - nadal będzie wyświetlany w prawym dolnym rogu.

Metoda alternatywna 2: Plik nagłówka motywu

Możesz również dodać kod do pliku nagłówka motywu dla instalacji na całej witrynie:

Uzyskaj dostęp do plików Concrete CMS przez FTP lub Menedżer plików
Przejdź do /application/themes/your_theme_name/
Otwórz plik header.php (lub elements/header.php)
Znajdź zamykający znacznik </head>
Wklej kod osadzania Asyntai tuż przed znacznikiem </head>
Zapisz i prześlij plik
Wyczyść pamięć podręczną z Panelu

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

Wskazówka: Upewnij się, że dołączyłeś wymagane elementy nagłówka za pomocą <?php View::element('header_required'); ?> w pliku header.php, aby Concrete CMS działał prawidłowo.

Metoda alternatywna 3: Własny szablon (zaawansowane)

Dla programistów, którzy chcą mieć większą kontrolę, można utworzyć własny szablon strony:

Utwórz nowy plik szablonu strony w /application/themes/your_theme_name/
Lub skopiuj istniejący szablon (np. default.php) i zmień jego nazwę
Dodaj kod osadzania Asyntai do pliku szablonu przed </body>
W Panelu Concrete CMS przejdź do Pages & Themes
Kliknij Page Types
Wybierz typ strony, z którym chcesz użyć tego szablonu
Przypisz własny szablon do typu strony
Wszystkie strony korzystające z tego typu strony będą teraz zawierać chatbota

Ważne: Zawsze twórz kopię zapasową plików motywu przed wprowadzeniem zmian. Jeśli to możliwe, najpierw przetestuj modyfikacje na stronie testowej. Nieprawidłowe edycje plików motywu mogą uszkodzić układ lub funkcjonalność witryny.

Krok 3: Weryfikacja instalacji

Po wprowadzeniu zmian i wyczyszczeniu pamięci podręcznej 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ą Concrete CMS (Dashboard → System & Settings → Clear Cache). Spróbuj wyświetlić stronę w oknie incognito. Sprawdź, czy zapisałeś i przesłałeś wszystkie zmiany plików. Otwórz konsolę przeglądarki (F12), aby sprawdzić, czy nie ma błędów JavaScript.