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

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

Платформа:

Шаг 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 Your Layout Template (Recommended)

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

Откройте файлы проекта Craft CMS через FTP, SSH или редактор кода
Перейдите в the templates/ directory
Найдите основной файл макета (обычно называется _layout.twig, _layout.html или находится в templates/_layouts/)
Найдите закрывающий тег </body>
Вставьте код встраивания Asyntai перед тегом </body>
Сохранить файл

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

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS provides a built-in Twig tag for registering JavaScript:

Откройте главный шаблон макета
Добавьте следующий код перед закрывающим тегом </body>:
{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %}
Замените YOUR_WIDGET_ID на ваш реальный ID виджета
Сохранить файл

Примечание: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Альтернатива: Отдельный подключаемый файл

Для лучшей организации создайте отдельный файл подключения:

Создайте новый файл: templates/_includes/chatbot.twig (или .html)
Добавьте код Asyntai в этот файл:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
В основном шаблоне макета подключите этот файл перед </body>:
{% include '_includes/chatbot' %}
Сохранить оба файла

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

Альтернатива: Условная загрузка

Чтобы загружать чат-бот только на определённых страницах или разделах:

В шаблоне макета или страницы используйте условия Twig:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Или проверьте конкретные разделы:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

Шаг 3: Verify Installation

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

Виджет не отображается? Убедитесь, что вы сохранили файл шаблона и редактируете правильный шаблон макета, который используется вашими страницами. Очистите кэш браузера или откройте сайт в режиме инкогнито. Если используется кэширование шаблонов, очистите кэш Craft CMS через Панель управления: Утилиты > Очистить кэш.

Расположение шаблона: Расположение шаблонов Craft CMS может варьироваться в зависимости от настроек проекта. Типичные пути: templates/_layout.twig, templates/_layouts/main.twig или templates/_base.twig. Проверьте существующие шаблоны, чтобы найти, где определён тег </body>.