Как да добавите 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>

Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.

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 код за вграждане
Натиснете "Save"
Изчистете кеша

Забележка: Не всички теми имат тази опция. Ако вашата тема не включва полета за персонализиран код, използвайте метода за редактиране на шаблона или инсталирайте разширение.

Алтернатива: Използване на разширение за персонализиран код

Можете да инсталирате безплатно разширение от OpenCart Marketplace, за да добавите персонализирани скриптове:

Go to the OpenCart Marketplace
Потърсете "Custom Script", "Header Footer Scripts" или "Custom Code"
Изтеглете и инсталирайте подходящо разширение
В административния панел отидете на Extensions → Extensions → Modules
Намерете и инсталирайте модула за персонализиран код
Конфигурирайте модула и поставете вашия Asyntai код за вграждане в секцията за футър
Запазете и изчистете кеша

Важно: Използването на разширения е препоръчително пред редактирането на основни файлове, тъй като те оцеляват при обновявания на OpenCart. Популярните разширения включват "Custom Script in Header & Footer", налично на пазара.

Алтернатива: Използване на метода 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, за да го включите ръчно, или да добавите вграден JavaScript след цикъла на скриптовете

Забележка: За да работи уиджетът правилно с атрибута data, методът с шаблон е по-прост, тъй като методът addScript не поддържа директно персонализирани атрибути.

Стъпка 3: Проверка на инсталацията

След като запазите промените си и изчистите кеша, посетете магазина си в нов раздел на браузъра или в режим инкогнито. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Щракнете върху него, за да се уверите, че се отваря и работи правилно.

Не виждате уиджета? Уверете се, че сте изчистили кеша на OpenCart. Отидете в административния панел, щракнете върху синята икона зъбно колело в горния десен ъгъл и натиснете бутоните за опресняване. Също опитайте да изчистите кеша на браузъра или да разгледате в прозорец инкогнито. Ако сте модифицирали грешния файл на шаблона, проверете дали вашата тема използва файла, който сте редактирали.

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