Как да добавите Asyntai AI чатбот към OpenCart

Ръководство стъпка по стъпка за уебсайтове с OpenCart

Платформа:

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

<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 на уиджета.

Стъпка 2: Редактиране на шаблона за футър (Препоръчително)

Най-директният начин да добавите чатбота е чрез редактиране на шаблона за футър на вашата тема:

Осъществете достъп до вашите 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, за да добавите персонализирани скриптове:

Отидете на 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. Отидете в административния панел, щракнете върху синята икона зъбно колело в горния десен ъгъл и натиснете бутоните за опресняване. Също опитайте да изчистите кеша на браузъра или да разгледате в прозорец инкогнито. Ако сте модифицирали грешния файл на шаблона, проверете дали вашата тема използва файла, който сте редактирали.