Како додати Asyntai AI чатбот на OpenCart

Водич корак по корак за OpenCart веб-сајтове

Платформа:

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: Набавите свој код за уграђивање

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>

Напомена: Код изнад је само пример. Морате копирати свој јединствени код за уграђивање са своје Контролне табле јер садржи ваш лични ИД виџета.

Step 2: Edit Footer Template

Најдиректнији начин за додавање чатбота је уређивање шаблона подножја ваше теме:

Приступите вашим OpenCart фајловима путем FTP-а или менаџера фајлова
Навигирајте до шаблона подножја ваше теме:
- 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
Отворите фајл подножја за уређивање
Пронађите затварајућу </body> ознаку
Налепите свој Asyntai код за уграђивање непосредно пре </body> ознаке
Сачувајте фајл
Очистите OpenCart кеш: Dashboard → плава икона зупчаника (горе десно) → Refresh или обришите садржај system/storage/cache/

Савет: Ако користите подразумевану тему, путања би била catalog/view/theme/default/template/common/footer.twig. Увек направите резервну копију пре уређивања фајлова шаблона.

Алтернатива: Коришћење опције прилагођеног кода теме

Многе модерне OpenCart теме укључују уграђену опцију за прилагођени код:

Пријавите се на ваш OpenCart администраторски панел
Идите на Extensions → Themes (или Extensions → Extensions → Themes)
Кликните на Edit на вашој активној теми
Потражите секцију "Custom Code", "Footer Scripts" или "Custom JavaScript"
Налепите свој Asyntai код за уграђивање
Кликните „Сачувај"
Очистите кеш

Напомена: Не укључују све теме ову опцију. Ако ваша тема нема поља за прилагођени код, користите методу уређивања шаблона или инсталирајте проширење.

Алтернатива: Коришћење проширења за прилагођени код

Можете инсталирати бесплатно проширење са OpenCart Marketplace-а за додавање прилагођених скрипти:

Go to the OpenCart Marketplace
Претражите "Custom Script", "Header Footer Scripts" или "Custom Code"
Преузмите и инсталирајте одговарајуће проширење
У вашем администраторском панелу, идите на Extensions → Extensions → Modules
Пронађите и инсталирајте модул за прилагођени код
Конфигуришите модул и налепите ваш Asyntai код за уградњу у секцију подножја
Сачувајте и очистите кеш

Важно: Коришћење проширења се препоручује уместо уређивања основних фајлова, јер преживљавају OpenCart ажурирања. Популарна проширења укључују "Custom Script in Header & Footer" доступно на marketplace-у.

Алтернатива: Коришћење методе addScript (за програмере)

За програмере, OpenCart 3.x/4.x пружа програмски начин за додавање скрипти:

Отворите catalog/controller/common/footer.php
Додајте следећу линију пре $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
За data атрибут, мораћете да модификујете footer.twig да га ручно укључи, или додате inline JavaScript након петље скрипти

Напомена: Да би виџет исправно радио са data атрибутом, метода шаблона је једноставнија јер метода addScript не подржава прилагођене атрибуте директно.

Корак 3: Верификујте инсталацију

Након чувања промена и чишћења кеша, посетите вашу продавницу у новој картици прегледача или инкогнито прозору. Требало би да видите дугме виџета за ћаскање у доњем десном углу. Кликните на њега да проверите да ли се отвара и ради исправно.

Не видите виџет? Обавезно очистите OpenCart кеш. Идите на ваш администраторски панел, кликните на плаву иконицу зупчаника у горњем десном углу и кликните на дугмад за освежавање. Такође покушајте да обришете кеш прегледача или да прегледате у инкогнито прозору. Ако сте модификовали погрешан фајл шаблона, проверите да ли ваша тема користи фајл који сте уредили.

Документација