Ako pridať Asyntai AI Chatbot do OpenCart

Podrobný návod pre webové stránky 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.

Krok 1: Získajte svoj vkladací kód

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>

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Step 2: Edit Footer Template

Najpriamejší spôsob pridania chatbota je úprava šablóny pätičky vašej témy:

Pristúpte k súborom OpenCart cez FTP alebo správcu súborov
Prejdite na šablónu pätičky vašej témy:
- 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
Otvorte súbor pätičky na úpravu
Nájdite uzatvárací tag </body>
Vložíte svoj vkladací kod Asyntai tesne pred tag </body>
Uložte súbor
Vymažte vyrovnávaciu pamäť OpenCart: Dashboard → Modrá ikona ozubeného kolesa (vpravo hore) → Refresh alebo odstráňte obsah system/storage/cache/

Tip: Ak používate predvolenú tému, cesta by bola catalog/view/theme/default/template/common/footer.twig. Pred úpravou súborov šablóny vždy vytvorte zálohu.

Alternatíva: Pomocou možnosti vlastného kódu témy

Mnohé moderné témy OpenCart obsahujú vstavanú možnosť pre vlastný kód:

Prihláste sa do svojho administrátorského panela OpenCart
Prejdite na Extensions → Themes (alebo Extensions → Extensions → Themes)
Kliknite na Edit pri vašej aktívnej téme
Hľadajte sekciu "Custom Code", "Footer Scripts" alebo "Custom JavaScript"
Vložte svoj vkladací kód Asyntai
Kliknite na "Uložiť"
Vymažte vyrovnávaciu pamäť

Poznámka: Nie všetky témy majú túto možnosť. Ak vaša téma neobsahuje polia pre vlastný kód, použite metódu úpravy šablóny alebo nainštalujte rozšírenie.

Alternatíva: Pomocou rozšírenia pre vlastný kód

Môžete nainštalovať bezplatné rozšírenie z OpenCart Marketplace na pridanie vlastných skriptov:

Go to the OpenCart Marketplace
Vyhľadajte "Custom Script", "Header Footer Scripts" alebo "Custom Code"
Stiahnite a nainštalujte vhodné rozšírenie
Vo vašom administrátorskom paneli prejdite na Extensions → Extensions → Modules
Nájdite a nainštalujte modul pre vlastný kód
Nakonfigurujte modul a vložte svoj vkladací kód Asyntai do sekcie pätičky
Uložte a vymažte vyrovnávaciu pamäť

Dôležité: Používanie rozšírení sa odporúča pred úpravou základných súborov, pretože prežijú aktualizácie OpenCart. Medzi populárne rozšírenia patrí "Custom Script in Header & Footer" dostupné na trhovisku.

Alternatíva: Pomocou metódy addScript (Pre vývojárov)

Pre vývojárov OpenCart 3.x/4.x poskytuje programový spôsob pridávania skriptov:

Otvorte catalog/controller/common/footer.php
Pridajte nasledujúci riadok pred $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Pre dátový atribút budete musieť upraviť footer.twig, aby ho zahŕňal manuálne, alebo pridať vnorený JavaScript za slučku skriptov

Poznámka: Pre správne fungovanie widgetu s dátovým atribútom je metóda šablóny jednoduchšia, keďže metóda addScript nepodporuje vlastné atribúty priamo.

Krok 3: Overenie inštalácie

Po uložení zmien a vymazaní vyrovnávacej pamäte navštívte svoj obchod v novej záložke prehliadača alebo v okne inkognito. V pravom dolnom rohu by ste mali vidieť tlačidlo chatového widgetu. Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne.

Nevidíte widget? Uistite sa, že ste vymazali vyrovnávaciu pamäť OpenCart. Prejdite do administrátorského panela, kliknite na modrú ikonu ozubeného kolesa v pravom hornom rohu a kliknite na tlačidlá obnovenia. Tiež skúste vymazať vyrovnávaciu pamäť prehliadača alebo zobraziť stránku v okne inkognito. Ak ste upravili nesprávny súbor šablóny, skontrolujte, či vaša téma používa súbor, ktorý ste upravili.

Dokumentácia