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

Пошаговое руководство для сайтов на Concrete CMS (ранее Concrete5)

Платформа:

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

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

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

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

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

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

Откройте установку Concrete CMS через FTP или Файловый менеджер
Перейдите в директорию /application/themes/your_theme_name/
Найдите и откройте файл footer.php (или аналогичный шаблон footer)
Найдите строку с закрывающим тегом </body>
Вставьте код встраивания Asyntai непосредственно перед тегом </body>
Сохраните файл и загрузите его обратно на сервер, если редактируете локально
Очистите кэш Concrete CMS: Dashboard → System & Settings → Clear Cache

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

Альтернативный метод 1: HTML-блок (самый простой для не-разработчиков)

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

Войдите в панель управления Concrete CMS
Перейдите на страницу, куда хотите добавить чат-бот
Нажмите Редактировать страницу (значок карандаша на панели инструментов)
Нажмите Добавить блок в области, где хотите разместить код
Найдите и выберите блок HTML
Вставьте код встраивания Asyntai в HTML-редактор
Нажмите Добавить, чтобы сохранить блок
Нажмите Опубликовать, чтобы изменения вступили в силу

Примечание: Метод HTML-блока отлично подходит для добавления чат-бота на определённые страницы. Для установки на весь сайт вам нужно добавить HTML-блок на каждую страницу или воспользоваться методом футера темы, описанным выше. Визуальное расположение блока не влияет на место отображения чат-бота — он по-прежнему будет отображаться в правом нижнем углу.

Альтернативный способ 2: Файл заголовка темы

Вы также можете добавить код в файл заголовка вашей темы для установки на весь сайт:

Откройте файлы Concrete CMS через FTP или Файловый менеджер
Перейдите в /application/themes/your_theme_name/
Откройте файл header.php (или elements/header.php)
Найдите закрывающий тег </head>
Вставьте код встраивания Asyntai непосредственно перед тегом </head>
Сохраните и загрузите файл
Очистить кэш из панели управления

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

Совет: Обязательно включите необходимые элементы заголовка с помощью <?php View::element('header_required'); ?> в файле header.php, чтобы Concrete CMS работал корректно.

Альтернативный метод 3: Пользовательский шаблон (продвинутый)

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

Создайте новый файл шаблона страницы в /application/themes/название_вашей_темы/
Или скопируйте существующий шаблон (например, default.php) и переименуйте его
Добавьте код вставки Asyntai в файл шаблона перед </body>
В панели управления Concrete CMS перейдите в Pages & Themes
Нажмите на Page Types
Выберите тип страницы, для которого хотите использовать этот шаблон
Назначьте свой шаблон типу страницы
Все страницы данного типа теперь будут включать чат-бот

Важно: Всегда создавайте резервные копии файлов темы перед внесением изменений. По возможности тестируйте правки на тестовом сайте. Неправильное редактирование файлов темы может нарушить макет или функциональность сайта.

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

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

Виджет не отображается? Убедитесь, что вы очистили кэш Concrete CMS (Панель управления → Система и настройки → Очистить кэш). Попробуйте открыть сайт в режиме инкогнито. Проверьте, что все изменённые файлы сохранены и загружены. Откройте консоль браузера (F12) для проверки ошибок JavaScript.