Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Jak dodać chatbota AI Asyntai do ExpressionEngine

Instrukcja krok po kroku dla CMS ExpressionEngine

Pobierz kod osadzania

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 układu szablonu (zalecane)

Najłatwiejszym sposobem dodania chatbota do wszystkich stron jest edycja głównego szablonu układu w panelu sterowania ExpressionEngine:

  1. W panelu sterowania EE przejdź do Developer > Templates > Template Groups
  2. Otwórz główna grupe szablonów (zazwyczaj "site") i edytuj szablon ukladu (lub szablon opakowujacy wszystkie strony)
  3. Znajdź zamykający znacznik </body>
  4. Wklej kod osadzania Asyntai tuż przed znacznikiem </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. 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:

  1. Go to Developer > Templates > Template Partials
  2. Kliknij "New", aby utworzyć nowa część szablonu o nazwie _asyntai_widget
  3. Wklej kod osadzania Asyntai do treści części szablonu:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Zapisz część szablonu
  5. 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:

  1. Przejdź do Settings > Content & Design > Global Template Preferences
  2. Jeśli Twoja konfiguracja EE posiada globalna sekcję stopki, wklej tam kod osadzania Asyntai
  3. 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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. 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:

  1. Uzyskaj dostęp do plików projektu ExpressionEngine przez FTP, SSH lub edytor kodu
  2. Przejdź do katalogu system/user/config/ i otwórz plik config.php
  3. W celu niestandardowego wstrzykiwania JavaScript rozważ utworzenie prostego dodatku/rozszerzenia EE, które podlacza sie do hooka template_post_parse w celu wstrzyknięcia skryptu podczas renderowania strony:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Zamien YOUR_WIDGET_ID na 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.