Az Asyntai AI Chatbot hozzáadása az OpenCart-hoz

Lépésről lépésre útmutató az OpenCart weboldalakhoz

Platform:

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.

1. lépés: Szerezze be a beágyazási kódját

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>

Megjegyzés: A fenti kód csak egy példa. Le kell másolnia saját egyedi beágyazási kódját az Irányítópultról, mivel az tartalmazza személyes widget-azonosítóját.

Step 2: Edit Footer Template

A chatbot hozzáadásának legegyszerűbb módja a téma lábléc sablonjának szerkesztése:

Nyissa meg az OpenCart fájlokat FTP-n vagy fájlkezelőn keresztül
Navigáljon a témája lábléc sablonjához:
- 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
Nyissa meg a lábléc fájlt szerkesztésre
Keresse meg a záró </body> taget
Illessze be az Asyntai beágyazási kódot közvetlenül a </body> tag elé
Mentse el a fájlt
Ürítse az OpenCart gyorsítótárát: Irányítópult → Kék fogaskerék ikon (jobb felül) → Frissítés vagy törölje a system/storage/cache/ tartalmát

Tipp: Ha az alapértelmezett témát használja, az elérési út catalog/view/theme/default/template/common/footer.twig lesz. Mindig készítsen biztonsági másolatot a sablonfájlok szerkesztése előtt.

Alternatíva: A téma egyéni kód opciójának használata

Sok modern OpenCart téma beépített opciót tartalmaz egyéni kódhoz:

Jelentkezz be az OpenCart Admin Panel felületére
Lépjen a Bővítmények → Témák menüponthoz (vagy Bővítmények → Bővítmények → Témák)
Kattintson a Szerkesztés gombra az aktív témájánál
Keressen „Egyéni kód", „Lábléc szkriptek" vagy „Egyéni JavaScript" szakaszt
Illessze be az Asyntai beágyazási kódját
Kattintson a „Mentés" gombra
Ürítse a gyorsítótárat

Megjegyzés: Nem minden témában érhető el ez az opció. Ha a témája nem tartalmaz egyéni kódmezőket, használja a sablon szerkesztési módszert, vagy telepítsen egy bővítményt.

Alternatíva: Egyéni kód bővítmény használata

Ingyenes bővítményt telepíthet az OpenCart Piactérről egyéni szkriptek hozzáadásához:

Go to the OpenCart Marketplace
Keressen „Egyéni szkript", „Fejléc lábléc szkriptek" vagy „Egyéni kód" kifejezésre
Töltse le és telepítse a megfelelő bővítményt
Az adminpanelen lépjen a Bővítmények → Bővítmények → Modulok menüponthoz
Keresse meg és telepítse az egyéni kód modult
Konfigurálja a modult, és illessze be az Asyntai beágyazó kódját a lábléc szakaszba
Mentse el, és ürítse a gyorsítótárat

Fontos: A bővítmények használata javasolt az alapfájlok szerkesztésével szemben, mivel az OpenCart frissítések után is megmaradnak. Népszerű bővítmények közé tartozik a piactéren elérhető „Egyéni szkript fejlécben és láblécben".

Alternatíva: addScript módszer használata (fejlesztőknek)

Az OpenCart 3.x/4.x programozói módot biztosít szkriptek hozzáadásához fejlesztők számára:

Nyissa meg a catalog/controller/common/footer.php fájlt
Adja hozzá a következő sort a $data['scripts'] = $this->document->getScripts('footer'); sor elé:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Az adatattribútumhoz módosítania kell a footer.twig fájlt, hogy manuálisan tartalmazza azt, vagy adjon hozzá inline JavaScriptet a szkriptek ciklusa után

Megjegyzés: Ahhoz, hogy a widget megfelelően működjön az adatattribútummal, a sablon módszer egyszerűbb, mivel az addScript módszer közvetlenül nem támogat egyéni attribútumokat.

3. lépés: Telepítés ellenőrzése

A változtatások mentése és a gyorsítótár ürítése után látogassa meg az áruházát egy új böngészőlapon vagy inkognító ablakban. A jobb alsó sarokban meg kell jelennie a chat widget gombnak. Kattintson rá, hogy megbizonyosodjon arról, hogy megnyílik és megfelelően működik.

Nem látja a widgetet? Ürítse az OpenCart gyorsítótárát. Lépjen az adminpanelre, kattintson a jobb felső sarokban lévő kék fogaskerék ikonra, majd kattintson a frissítés gombokra. Próbálja meg törölni a böngészőgyorsítótárat is, vagy tekintse meg inkognító ablakban. Ha rossz sablonfájlt módosított, ellenőrizze, hogy a témája a szerkesztett fájlt használja-e.

Dokumentáció