Kako dodati klepetalnik Asyntai AI v OpenCart

Vodič po korakih za spletna mesta OpenCart

Platforma:

The Easy Way: Install the Asyntai Extension

We publish a free extension on the OpenCart Marketplace. It puts the chatbot on your storefront and connects your account, and there is no code to copy and no template to edit. It works on OpenCart 3.x and 4.x.

Download Asyntai - AI Chatbot from the OpenCart Marketplace
In your admin panel, go to Extensions → Installer and upload the ZIP file
Go to Extensions → Extensions, choose Modules in the list, find Asyntai AI Chatbot and press the green install button
Press edit, then press Connect to Asyntai. A window opens where you sign in or create an account.

That is all. The chatbot is live on your storefront when the window closes.

Your products, prices and stock

When you connect, the extension also lets Asyntai read your catalogue. Your assistant then answers with the price you charge today and tells shoppers what is in stock, instead of repeating whatever your pages said when they were last read.

Asyntai reads your products through a read-only address on your own store. Every request is signed, and the reply carries the prices a shopper would actually pay, with your tax rules already applied. You can switch this off at any time on the extension's settings screen.

Updating from version 1.0.0? OpenCart clears a module's settings when you uninstall it, so press Connect to Asyntai once after the update. From this version on, updates keep your connection.

Or Add the Code Yourself

Prefer not to install an extension? The rest of this page shows how to add the chatbot by hand. You will not get the catalogue reading this way.

Korak 1: Pridobite svojo vdelovalno kodo

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

Opomba: Zgornja koda je le primer. Svojo edinstveno vdelovalno kodo morate kopirati iz svoje Nadzorne plošče, saj vsebuje vaš osebni ID klepetalnika.

Step 2: Edit Footer Template

Najbolj neposreden način za dodajanje klepetalnika je urejanje predloge noge vaše teme:

Dostopite do datotek OpenCart prek FTP ali upravitelja datotek
Pojdite do predloge noge svoje teme:
- 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
Odprite datoteko noge za urejanje
Poiščite zaključno oznako </body>
Prilepite svojo vdelovalno kodo Asyntai tik pred oznako </body>
Shranite datoteko
Počistite predpomnilnik OpenCart: Nadzorna plošca → Modra ikona zobnika (zgoraj desno) → Osveži ali izbrišite vsebino mape system/storage/cache/

Nasvet: Če uporabljate privzeto temo, je pot catalog/view/theme/default/template/common/footer.twig. Vedno ustvarite varnostno kopijo, preden urejate datoteke predlog.

Alternativa: Uporaba možnosti za kodo po meri v temi

Številne sodobne teme OpenCart vključujejo vgrajeno možnost za kodo po meri:

Prijavite se v svoj skrbniški panel OpenCart
Pojdite na Razširitve → Teme (ali Razširitve → Razširitve → Teme)
Kliknite Uredi pri svoji aktivni temi
Poišcite razdelek "Koda po meri", "Skripte noge" ali "JavaScript po meri"
Prilepite svojo vdelovalno kodo Asyntai
Kliknite "Shrani"
Počistite predpomnilnik

Opomba: Nimajo vse teme te možnosti. Če vaša tema ne vključuje polj za kodo po meri, uporabite način urejanja predloge ali namestite razširitev.

Alternativa: Uporaba razširitve za kodo po meri

Namestite lahko brezplacno razširitev s tržnice OpenCart za dodajanje skript po meri:

Go to the OpenCart Marketplace
Poišcite "Skripta po meri", "Skripte glave in noge" ali "Koda po meri"
Prenesite in namestite ustrezno razširitev
V svojem skrbniškem panelu pojdite na Razširitve → Razširitve → Moduli
Poišcite in namestite modul za kodo po meri
Konfigurirajte modul in prilepite svojo vdelano kodo Asyntai v razdelek noge
Shranite in počistite predpomnilnik

Pomembno: Uporaba razširitev je priporočena namesto urejanja jedrnih datotek, saj preživijo posodobitve OpenCart. Priljubljene razširitve vkljucujejo "Custom Script in Header & Footer", ki je na voljo na tržnici.

Alternativa: Uporaba metode addScript (za razvijalce)

Za razvijalce OpenCart 3.x/4.x zagotavlja programski način dodajanja skript:

Odprite catalog/controller/common/footer.php
Dodajte naslednjo vrstico pred $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Za podatkovni atribut boste morali spremeniti footer.twig, da ga vkljuci rocno, ali dodati vgrajeni JavaScript za zanko skript

Opomba: Da pripomocek pravilno deluje s podatkovnim atributom, je način s predlogo preprostejši, saj metoda addScript ne podpira neposredno atributov po meri.

Korak 3: Preverite namestitev

Po shranjevanju sprememb in cišcenju predpomnilnika obiščite svojo trgovino v novem zavihku brskalnika ali oknu brez beleženja. V spodnjem desnem kotu bi morali videti gumb pripomocka za klepet. Kliknite nanj, da se prepričajte, da se odpre in pravilno deluje.

Ne vidite klepetalnika? Počistite predpomnilnik OpenCart. Pojdite v skrbniški panel, kliknite modro ikono zobnika v zgornjem desnem kotu in kliknite gumbe za osvežitev. Poskusite tudi pocistiti predpomnilnik brskalnika ali stran ogledati v oknu brez beleženja. Če ste spremenili napačno datoteko predloge, preverite, da vaša tema uporablja datoteko, ki ste jo uredili.

Dokumentacija