Как добавить ИИ-чат-бот Asyntai в OpenCart

Пошаговое руководство для сайтов на OpenCart

Платформа:

Шаг 1: Get Your Embed Code

Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:

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

Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.

Шаг 2: Edit Footer Template (Recommended)

Самый прямой способ добавить чат-бот — отредактировать шаблон футера вашей темы:

Откройте файлы OpenCart через FTP или файловый менеджер
Перейдите в your theme's footer template:
- 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: Панель управления → Синяя шестерёнка (верхний правый угол) → Обновить или удалить содержимое system/storage/cache/

Совет: Если вы используете тему по умолчанию, путь будет catalog/view/theme/default/template/common/footer.twig. Всегда создавайте резервную копию перед редактированием файлов шаблонов.

Альтернатива: Через пользовательский код темы

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

Войдите в панель администратора OpenCart
Перейдите в Extensions → Themes (или Extensions → Extensions → Themes)
Нажмите Edit on your active theme
Найдите раздел «Custom Code», «Footer Scripts» или «Custom JavaScript»
Вставьте код встраивания Asyntai
Нажмите \"Save\"
Очистить кэш

Примечание: Не все темы поддерживают эту опцию. Если в вашей теме нет полей для пользовательского кода, используйте метод редактирования шаблона или установите расширение.

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

Вы можете установить бесплатное расширение из OpenCart Marketplace для добавления пользовательских скриптов:

Перейдите в 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: Verify Installation

После сохранения изменений и очистки кэша откройте магазин в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.

Виджет не отображается? Обязательно очистите кэш OpenCart. Перейдите в панель администратора, нажмите на синюю иконку шестерёнки в правом верхнем углу и нажмите кнопки обновления. Также попробуйте очистить кэш браузера или открыть сайт в режиме инкогнито. Если вы изменили не тот файл шаблона, убедитесь, что ваша тема использует именно отредактированный файл.