Jak přidat Asyntai AI chatbota do OpenCart

Podrobný návod pro weby na platformě OpenCart

Platforma:

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Úprava šablony zápatí (Doporučeno)

Nejprimejsi způsob přidání chatbota je úprava šablony zápatí vašeho motivu:

Pristupte k souborum OpenCart pres FTP nebo správce souborů
Přejděte do šablony zápatí svého motivu:
- 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
Otevřete soubor zápatí pro upravu
Najděte uzavírací značku </body>
Vložte svůj Asyntai embed kód těsně před značku </body>
Uložte soubor
Vymažte mezipaměť OpenCart: Nastenka → Modra ikona ozubeného kola (vpravo nahore) → Obnovit nebo smazte obsah system/storage/cache/

Tip: Pokud používáte výchozí motiv, cesta by byla catalog/view/theme/default/template/common/footer.twig. Pred upravou souborů šablon vždy vytvořte zalohu.

Alternativa: Použití možnosti vlastního kódu motivu

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

Přihlaste se do administračního panelu OpenCart
Přejděte na Rozšíření → Motivy (nebo Rozšíření → Rozšíření → Motivy)
Klikněte na Upravit u svého aktivniho motivu
Hledejte sekci "Vlastní kód", "Skripty zápatí" nebo "Vlastní JavaScript"
Vložte svůj vkládací kód Asyntai
Klikněte na "Save"
Vymažte mezipaměť

Poznámka: Ne všechny motivy maji tuto možnost. Pokud váš motiv neobsahuje pole pro vlastní kód, použijte metodu upravy šablony nebo nainstalujte rozšíření.

Alternativa: Použití rozšíření pro vlastní kód

Můžete nainstalovat bezplatné rozšíření z OpenCart Marketplace pro přidání vlastních skriptů:

Přejděte na OpenCart Marketplace
Vyhledejte "Custom Script", "Header Footer Scripts" nebo "Custom Code"
Stáhněte a nainstalujte vhodne rozšíření
Ve svém administracnim panelu přejděte na Rozšíření → Rozšíření → Moduly
Najděte a nainstalujte modul vlastního kódu
Nakonfigurujte modul a vložte svůj vložený kód Asyntai do sekce zápatí
Uložte a vymažte mezipaměť

Důležité: Použití rozšíření je doporučeno před upravou základních souborů, protože přežijí aktualizace OpenCart. Mezi oblíbená rozšíření patří "Custom Script in Header & Footer" dostupné na trhu.

Alternativa: Použití metody addScript (Pro vývojáře)

Pro vývojáře poskytuje OpenCart 3.x/4.x programový způsob přidání skriptů:

Otevřete catalog/controller/common/footer.php
Přidejte následující řádek před $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Pro datovy atribut budete muset upravit footer.twig tak, aby jej zahrnoval ručně, nebo přidat inline JavaScript za smyčku skriptů

Poznámka: Pro správně fungování widgetu s datovým atributem je metoda šablony jednodušší, protože metoda addScript přímo nepodporuje vlastní atributy.

Krok 3: Ověřte instalaci

Po uložení změn a vymazání mezipaměti navštivte svůj obchod v nové kartě prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatového widgetu. Klikněte na nej a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Nezapomeňte vymazat mezipaměť OpenCart. Přejděte do svého administračního panelu, klikněte na modrou ikonu ozubeného kola v právém horním rohu a klikněte na tlačítka obnovení. Zkuste také vymazat mezipaměť prohlížeče nebo stránku zobrazit v anonymním okně. Pokud jste upravili špatný soubor šablony, zkontrolujte, že váš motiv používá soubor, který jste upravili.