Як додати AI чат-бот Asyntai до OpenCart

Покрокова інструкція для вебсайтів на OpenCart

Платформа:

Крок 1: Отримайте код для вставки

Спочатку перейдiть до вашої Панелi керування Asyntai та прокрутiть вниз до роздiлу "Код для вставки". Скопiюйте унiкальний код для вставки, який виглядатиме так:

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

Примітка: Код вище є лише прикладом. Ви повиннi скопiювати власний унiкальний код для вставки з вашої Панелi керування, оскiльки вiн мiстить ваш особистий ID вiджета.

Крок 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. Перейдіть до панелі адміністрування, натисніть синій значок шестерні у верхньому правому куті та натисніть кнопки оновлення. Також спробуйте очистити кеш браузера або переглянути сторінку у вікні інкогніто. Якщо ви змінили не той файл шаблону, перевірте, що ваша тема використовує файл, який ви редагували.