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

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

Платформа:

Шаг 1: Получите код встраивания

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

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

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

Шаг 2: Добавьте в шаблон макета (рекомендуется)

Рекомендуемый способ добавить чат-бот — отредактировать макет по умолчанию в административной панели October CMS:

Войдите в бэкенд October CMS
Перейдите в CMS > Layouts в главном меню
Откройте свой макет по умолчанию (обычно default.htm)
Найдите закрывающий </body> тег и {% scripts %} заполнитель
Добавьте код вставки Asyntai прямо перед {% scripts %} и </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Нажмите «Save», чтобы применить изменения

Совет: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Вы можете использовать заглушку скриптов October CMS для внедрения чат-бота из страницы или шаблона:

Откройте любую страницу или фрагмент в редакторе CMS
Добавьте следующий код, используя {% put scripts %} блок:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Замените YOUR_WIDGET_ID на ваш реальный ID виджета из панели управления
Нажмите «Save»

Примечание: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Альтернативный способ 2: Через Component PHP

Если вы предпочитаете программный подход, вы можете добавить скрипт чат-бота через пользовательский компонент:

Создайте или измените компонент в вашем плагине October CMS
В методе onRun() компонента используйте метод addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Замените YOUR_WIDGET_ID на ваш реальный ID виджета
Зарегистрируйте компонент на страницах, где должен появиться чат-бот

Совет: Использование компонента даёт программный контроль над тем, когда и где загружается чат-бот. Вы можете добавить условную логику внутри onRun() для управления загрузкой на основе ролей пользователей, типов страниц или других критериев.

Альтернативный способ 3: Через Partial

Вы можете создать переиспользуемый partial для виджета чат-бота:

Перейдите в CMS > Partials в бэкенде October CMS
Нажмите «+ Add», чтобы создать новый partial
Назовите его asyntai-widget.htm
Добавьте код Asyntai в partial:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Нажмите «Save»
Откройте шаблон макета и подключите фрагмент перед </body>:
{% partial 'asyntai-widget' %}
Сохранить макет

Совет: Использование шаблонного фрагмента позволяет легко включать или отключать чат-бот на всём сайте, просто добавив или убрав включение фрагмента из макета.

Шаг 3: Проверка установки

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

Виджет не отображается? Убедитесь, что вы сохранили все изменения в бэкенде CMS. Очистите кэш браузера или откройте сайт в режиме инкогнито. Если ваш сайт использует кэширование, очистите кэш October CMS командой php artisan cache:clear в командной строке или воспользуйтесь пунктом Настройки > Система > Очистить кэш в бэкенде.

Выбор макета: Убедитесь, что страницы, где должен появляться чат-бот, используют правильный макет. Проверить, какой макет использует страница, можно, открыв её в CMS > Pages и посмотрев на выпадающий список Layout в настройках страницы.