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

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

Платформа:

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

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

Шаг 2: Отредактируйте шаблон макета (рекомендуется)

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

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

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

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

Craft CMS предоставляет встроенный Twig-тег для регистрации 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>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
В основном шаблоне макета подключите этот файл перед </body>:
{% include '_includes/chatbot' %}
Сохраните оба файла

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

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

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

В шаблоне макета или страницы используйте условия Twig:
{% if entry.showChatbot ?? true %} <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% endif %}
Или проверьте конкретные разделы:
{% if craft.app.request.segments[0] != 'admin' %} <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% endif %}

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

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

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

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