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

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

Платформа:

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

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

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

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

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

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

Войдите в MODX Manager (панель администратора)
На левой панели перейдите в Elements > Templates
Откройте шаблон сайта (обычно называется «BaseTemplate» или ваш активный шаблон)
Найдите закрывающий тег </body> в коде шаблона
Вставьте код встраивания Asyntai непосредственно перед закрывающим тегом </body>
Нажмите «Save», чтобы сохранить шаблон

<!-- Your existing template content -->

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

Совет: Добавление кода непосредственно перед закрывающим тегом </body> гарантирует загрузку чат-бота после всего контента страницы — это рекомендуемое расположение для чат-виджетов, которое не замедлит загрузку страницы.

Альтернативный способ 1: Через MODX Chunk

Вы можете использовать Chunk в MODX, чтобы хранить код встраивания отдельно и переиспользовать:

В MODX Manager перейдите в Elements > Chunks
Нажмите «New Chunk», чтобы создать новый чанк
Назовите чанк «asyntaiWidget»
Вставьте код встраивания Asyntai в область контента чанка
Нажмите «Save»
Откройте ваш шаблон (в разделе Elements > Templates)
Добавьте вызов чанка [[$asyntaiWidget]] непосредственно перед закрывающим тегом </body>
Сохранить шаблон

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Совет: Использование фрагмента (Chunk) упрощает управление и обновление кода встраивания в одном месте, особенно при использовании нескольких шаблонов на сайте.

Альтернативный способ 2: Через системные настройки MODX (HTML Head/Footer)

Некоторые конфигурации MODX включают заполнители для скриптов футера через системные настройки:

В MODX Manager перейдите в System > System Settings
Фильтруйте по «htmlhead» или ищите пользовательскую настройку для скриптов футера
Если в вашей настройке есть заполнитель для скриптов подвала (например, [[++footer_scripts]]), вы можете его использовать
Установите значение системной настройки на ваш код встраивания Asyntai
Убедитесь, что соответствующий плейсхолдер [[++footer_scripts]] присутствует в шаблоне перед закрывающим тегом </body>
Сохранить системную настройку

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Примечание: Этот метод зависит от наличия в вашей конфигурации MODX пользовательской системной настройки для скриптов футера. Если её нет, вы можете создать пользовательскую системную настройку и ссылаться на неё в шаблоне с помощью синтаксиса [[++setting_key]].

Альтернативный способ 3: Использование плагина MODX (OnWebPagePrerender)

Для продвинутого подхода можно создать плагин MODX, который автоматически вставляет код чат-бота на каждую страницу:

В MODX Manager перейдите в Элементы > Плагины
Нажмите «New Plugin», чтобы создать новый плагин
Назовите плагин «AsyntaiChatbot»
Вставьте следующий PHP-код в область кода плагина:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Нажмите вкладку «System Events»
Поставьте галочку рядом с «OnWebPagePrerender», чтобы плагин срабатывал на это событие
Нажмите «Save»

Важно: Замените YOUR_WIDGET_ID на ваш реальный идентификатор виджета из Панели управления Asyntai. Этот плагин автоматически внедрит скрипт чат-бота на каждую страницу вашего сайта на MODX перед её отображением.

Шаг 3: Очистка кэша и проверка

После добавления кода вставки любым из указанных способов необходимо очистить кэш MODX и проверить установку:

В MODX Manager перейдите в Управление > Очистить кэш (или нажмите на значок очистки кэша в верхнем меню)
Откройте свой сайт в новой вкладке браузера или в режиме инкогнито
Кнопка виджета чата должна появиться в правом нижнем углу страницы
Нажмите на него, чтобы убедиться, что он открывается и работает корректно

Виджет не отображается? Убедитесь, что очистили кеш MODX через Manage > Clear Cache в MODX Manager. Также очистите кеш браузера или откройте сайт в режиме инкогнито. Если вы использовали метод плагина, проверьте, что для вашего плагина отмечено системное событие «OnWebPagePrerender».