Повернутися до панелі керування

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

Дізнайтеся, як використовувати Asyntai

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

Покрокова інструкція для ExpressionEngine 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: Додавання до макету шаблону (Рекомендовано)

Найпростiший спосiб додати чат-бот на всi сторiнки - це редагування головного шаблону макету в панелi керування ExpressionEngine:

  1. У панелi керування EE перейдiть до Developer > Templates > Template Groups
  2. Вiдкрийте головну групу шаблонiв (зазвичай "site") та вiдредагуйте шаблон макету (або шаблон, що обгортає всi сторiнки)
  3. Знайдіть закриваючий тег </body>
  4. Вставте код вбудовування Asyntai безпосередньо перед тегом </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Збережіть шаблон

Порада: Додавання скрипту перед закриваючим тегом </body> забезпечує його завантаження пiсля контенту сторiнки, що рекомендується для чат-вiджетiв i не сповiльнює завантаження сторiнки.

Альтернативний метод 1: Використання часткових шаблонів EE

Частковi шаблони ExpressionEngine дозволяють створювати багаторазовi фрагменти, якi можна включати в рiзнi шаблони:

  1. Перейдіть до Developer > Templates > Template Partials
  2. Натиснiть "New", щоб створити новий частковий шаблон з назвою _asyntai_widget
  3. Вставте код вбудовування Asyntai у вміст часткового шаблону:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Збережіть частковий шаблон
  5. Включiть його до шаблону макету безпосередньо перед закриваючим тегом </body>:
    {embed="_asyntai_widget"} </body>

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

Альтернативний метод 2: Використання HTML заголовка/футера EE

Деякi налаштування ExpressionEngine надають глобальний роздiл футера для додавання скриптiв:

  1. Перейдiть до Settings > Content & Design > Global Template Preferences
  2. Якщо ваше налаштування EE має глобальний роздiл футера, вставте код вбудовування Asyntai туди
  3. Якщо глобальний роздiл футера недоступний, вiдредагуйте головний шаблон макету безпосередньо та додайте код вбудовування перед закриваючим тегом </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Збережіть зміни

Альтернативний метод 3: Використання config.php

Для досвiдчених користувачiв можна впровадити скрипт чат-бота через конфiгурацiю ExpressionEngine або створивши власне доповнення:

  1. Отримайте доступ до файлiв проекту ExpressionEngine через FTP, SSH або ваш редактор коду
  2. Перейдiть до каталогу system/user/config/ та вiдкрийте config.php
  3. Для впровадження власного JavaScript розгляньте створення простого доповнення/розширення EE, яке пiдключається до хука template_post_parse для впровадження скрипту при рендерингу сторiнки:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Замiнiть YOUR_WIDGET_ID на фактичний ID вiджету з панелi керування

Важливо: Метод config.php та доповнення призначений для досвiдчених користувачiв, якi добре знають розробку ExpressionEngine. Для бiльшостi користувачiв рекомендується метод шаблону макету (Крок 2) або метод часткових шаблонiв (Альтернативний метод 1).

Крок 3: Перевірте встановлення

Пiсля збереження змiн вiдвiдайте свiй веб-сайт ExpressionEngine у новiй вкладцi браузера або в режимi iнкогнiто. Ви повиннi побачити кнопку чат-вiджету в нижньому правому кутi. Натиснiть на неї, щоб переконатися, що вона вiдкривається та працює коректно.

Не бачите віджет? Переконайтеся, що ви зберегли шаблон та що ви редагуєте правильний шаблон макету, який використовують вашi сторiнки. Очистiть кеш браузера або перегляньте в режимi iнкогнiто. Якщо кешування шаблонiв ExpressionEngine увiмкнене, очистiть кеш з панелi керування в роздiлi Developer > Utilities > Cache Manager.