Ako pridať Asyntai AI Chatbot do OpenCart

Podrobný návod pre webové stránky OpenCart

Získať vkladací kód

Krok 1: Ziskajte svoj vkladací kod

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii "Vkladaci kod". Skopirujte svoj jedinečný vkladací kod, ktory bude vyzerat takto:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Poznámka: Kod vyššie je len priklad. Musite skopirovat svoj vlastný jedinečný vkladací kod zo svojho Dashboardu, pretože obsahuje vase osobne ID widgetu.

Krok 2: Úprava šablóny pätičky (Odporúčané)

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

  1. Pristúpte k súborom OpenCart cez FTP alebo správcu súborov
  2. 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
  3. Otvorte súbor pätičky na úpravu
  4. Najdite uzatvaraci tag </body>
  5. Vložíte svoj vkladací kod Asyntai tesne pred tag </body>
  6. Uložte súbor
  7. 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:

  1. Prihláste sa do svojho administrátorského panela OpenCart
  2. Prejdite na Extensions → Themes (alebo Extensions → Extensions → Themes)
  3. Kliknite na Edit pri vašej aktívnej téme
  4. Hľadajte sekciu "Custom Code", "Footer Scripts" alebo "Custom JavaScript"
  5. Vložíte svoj vkladací kod Asyntai
  6. Kliknite na "Ulozit"
  7. 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:

  1. Prejdite na OpenCart Marketplace
  2. Vyhľadajte "Custom Script", "Header Footer Scripts" alebo "Custom Code"
  3. Stiahnite a nainštalujte vhodné rozšírenie
  4. Vo vašom administrátorskom paneli prejdite na Extensions → Extensions → Modules
  5. Nájdite a nainštalujte modul pre vlastný kód
  6. Nakonfigurujte modul a vložte svoj vkladací kód Asyntai do sekcie pätičky
  7. 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:

  1. Otvorte catalog/controller/common/footer.php
  2. Pridajte nasledujúci riadok pred $data['scripts'] = $this->document->getScripts('footer');:
    $this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
  3. 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.

Nevidite 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.