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

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

Платформа:

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

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

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

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

Крок 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

Ви можете використовувати MODX Chunk, щоб зберігати код вставки окремо та повторно використовувати:

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

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

Порада: Використання чанку дозволяє легко керувати та оновлювати код вбудовування в одному місці, особливо якщо ви використовуєте кілька шаблонів на вашому сайті.

Альтернативний метод 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 перейдіть до Elements > Plugins
Натисніть "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 на ваш справжній ID віджета з панелі керування Asyntai. Цей плагін автоматично вставить скрипт чат-бота на кожну сторінку вашого сайту MODX перед її відображенням.

Крок 3: Очистіть кеш та перевірте

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

У MODX Manager перейдіть до Manage > Clear Cache (або натисніть значок очищення кешу у верхньому меню)
Відкрийте ваш вебсайт у новій вкладці браузера або вікні інкогніто
Ви повинні побачити кнопку чат-віджета у нижньому правому куті вашої сторінки
Натисніть на нього, щоб переконатися, що він відкривається та працює коректно

Не бачите віджет? Переконайтеся, що ви очистили кеш MODX через Manage > Clear Cache в MODX Manager. Також спробуйте очистити кеш браузера або переглянути сайт у вікні інкогніто. Якщо ви використовували метод плагіна, перевірте, що системна подія "OnWebPagePrerender" відмічена для вашого плагіна.