Jak dodać chatbota Asyntai AI do OpenCart

Instrukcja krok po kroku dla stron OpenCart

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: Edytuj szablon stopki (zalecane)

Najprostszym sposobem dodania chatbota jest edycja szablonu stopki Twojego motywu:

Uzyskaj dostęp do plików OpenCart przez FTP lub menedżera plików
Przejdź do szablonu stopki Twojego motywu:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
Otwórz plik stopki do edycji
Znajdź zamykający znacznik </body>
Wklej kod osadzania Asyntai tuz przed znacznikiem </body>
Zapisz plik
Wyczyść pamięć podręczna OpenCart: Dashboard → Niebieska ikona zebatki (prawy gorny rog) → Refresh lub usuń zawartość system/storage/cache/

Wskazówka: Jeśli używasz domyslnego motywu, ścieżka będzie catalog/view/theme/default/template/common/footer.twig. Zawsze tworz kopie zapasowa przed edycja plików szablonów.

Alternatywa: Użycie opcji niestandardowego kodu motywu

Many modern OpenCart themes include a built-in option for custom code:

Zaloguj sie do panelu administracyjnego OpenCart
Przejdź do Extensions → Themes (lub Extensions → Extensions → Themes)
Kliknij Edit przy aktywnym motywie
Poszukaj sekcji "Custom Code", "Footer Scripts" lub "Custom JavaScript"
Wklej swój kod osadzania Asyntai
Kliknij "Save"
Wyczyść pamięć podręczna

Uwaga: Nie wszystkie motywy maja te opcje. Jeśli Twój motyw nie zawiera pol niestandardowego kodu, użyj metody edycji szablonu lub zainstaluj rozszerzenie.

Alternatywa: Użycie rozszerzenia niestandardowego kodu

Możesz zainstalować darmowe rozszerzenie z OpenCart Marketplace, aby dodać niestandardowe skrypty:

Przejdź do OpenCart Marketplace
Wyszukaj "Custom Script", "Header Footer Scripts" lub "Custom Code"
Pobierz i zainstaluj odpowiednie rozszerzenie
W panelu administracyjnym przejdź do Extensions → Extensions → Modules
Znajdź i zainstaluj moduł niestandardowego kodu
Skonfiguruj moduł i wklej kod osadzania Asyntai w sekcji stopki
Zapisz i wyczyść pamięć podręczna

Ważne: Użycie rozszerzen jest zalecane zamiast edycji plików podstawowych, ponieważ przetrwaja one aktualizacje OpenCart. Popularne rozszerzenia obejmuja \"Custom Script in Header & Footer" dostępne na rynku.

Alternatywa: Użycie metody addScript (dla deweloperow)

Dla deweloperow OpenCart 3.x/4.x udostępnia programistyczny sposób dodawania skryptów:

Otwórz catalog/controller/common/footer.php
Dodaj nastepujaca linie przed $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
W przypadku atrybutu data należy zmodyfikowac footer.twig, aby dolaczyc go ręcznie, lub dodać wbudowany JavaScript po petli skryptów

Uwaga: Aby widget działał poprawnie z atrybutem data, metoda szablonowa jest prostsza, ponieważ metoda addScript nie obsługuje bezpośrednio niestandardowych atrybutow.

Krok 3: Weryfikacja instalacji

Po zapisaniu zmian i wyczyszczeniu pamięci podręcznej odwiedź swoj sklep w nowej karcie przeglądarki lub w oknie incognito. Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu. Kliknij go, aby upewnić sie, ze otwiera sie i działa poprawnie.

Nie widzisz widgetu? Upewnij sie, ze wyczysciles pamięć podręczna OpenCart. Przejdź do panelu administracyjnego, kliknij niebieska ikone zebatki w prawym gornym rogu i kliknij przyciski odswiezania. Spróbuj również wyczyść pamięć podręczna przeglądarki lub wyświetlić stronę w oknie incognito. Jeśli zmodyfikowales niewlasciwy plik szablonu, sprawdź, czy Twój motyw używa edytowanego pliku.