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

Пошаговое руководство для сайтов на Statamic 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: Choose Installation Method

Statamic поддерживает шаблонизаторы Antlers и Blade. Выберите метод в зависимости от используемого движка:

Способ 1: Макет Antlers (рекомендуется)

Самый простой способ добавить чат-бот — включить его в главный файл макета. Statamic использует Antlers в качестве шаблонизатора по умолчанию.

Перейдите в your Statamic project's resources/views directory
Откройте файл макета (обычно layout.antlers.html)
Найдите закрывающий тег </body>
Вставьте код встраивания Asyntai перед тегом </body>
Сохранить файл

<!DOCTYPE html>
<html lang="{{ site:short_locale }}">
<head>
  <meta charset="utf-8">
  <title>{{ title }} | {{ site:name }}</title>
  {{ vite src="resources/js/site.js|resources/css/site.css" }}
</head>
<body>
  {{ template_content }}

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

Совет: The {{ template_content }} variable is where Statamic injects your page content. Always add the chatbot script after this, just before </body>.

Способ 2: Макет Blade

If you're using Blade templates instead of Antlers, follow these steps:

Перейдите в your Statamic project's resources/views directory
Open your Blade layout file (e.g., layout.blade.php)
Найдите закрывающий тег </body>
Вставьте код встраивания Asyntai перед тегом </body>
Сохранить файл

<!DOCTYPE html>
<html lang="{{ $site->shortLocale() }}">
<head>
  <meta charset="utf-8">
  <title>{{ $title }} | {{ $site->name() }}</title>
  @vite(['resources/js/site.js', 'resources/css/site.css'])
</head>
<body>
  {!! $template_content !!}

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

Примечание: In Blade templates, use {!! $template_content !!} to render the page content. The !! syntax prevents HTML escaping.

Способ 3: Через шаблон partial

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

Шаг 1: Create the Partial

Создайте новый файл по пути resources/views/partials/_chatbot.antlers.html
Добавьте код Asyntai в этот файл:
 <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Шаг 2: Include in Your Layout

Откройте файл макета (layout.antlers.html)
Добавьте тег партиала перед </body>:
{{ partial:chatbot }} </body>

Зачем использовать partial? Фрагменты упрощают управление внешними скриптами в одном месте. Если вам когда-нибудь понадобится обновить код чат-бота, нужно отредактировать только один файл.

Использование нескольких макетов

Если ваш сайт Statamic использует несколько макетов (например, разные макеты для записей блога, лендингов и т.д.), добавьте скрипт чат-бота в каждый файл макета, где вы хотите отображать виджет.

Вы можете задать макет страницы несколькими способами:

В записи: добавьте layout: your_layout в блок front matter
В коллекции: задайте макет по умолчанию в YAML-файле конфигурации коллекции
В шаблоне: добавьте поле макета, из которого редакторы смогут выбирать

Для стартовых наборов Statamic

Если вы используете стартовый набор Statamic, расположение макета может отличаться. Распространённые варианты включают:

Default Statamic

resources/views/layout.antlers.html

Peak Starter

resources/views/layout.antlers.html с частичными шаблонами в resources/views/snippets/

Cool Writings

resources/views/layout.antlers.html

Starter's Creek

resources/views/layout.blade.php

Шаг 3: Clear Cache and Verify

После добавления кода очистите кэш Statamic, чтобы изменения вступили в силу:

php artisan cache:clear
php please stache:refresh

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

Виджет не отображается? Убедитесь, что вы очистили как кэш Laravel, так и Stache в Statamic. Если используется статическое кэширование, также выполните php please static:clear. Проверьте консоль браузера (F12) на наличие ошибок JavaScript.

Важно: Если вы используете генератор статических сайтов Statamic (ssg), не забудьте пересоздать статические файлы после добавления скрипта чат-бота, выполнив команду php please ssg:generate.

Документация