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

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

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

Як додати ШI-чатбот Asyntai до Backdrop CMS

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

Backdrop CMS використовує файли шаблонiв .tpl.php у своїх темах. Рекомендований пiдхiд - додати код для вставки безпосередньо до шаблону сторiнки вашої активної теми:

  1. Отримайте доступ до вашої установки Backdrop CMS через FTP або Файловий менеджер
  2. Перейдiть до каталогу вашої активної теми: themes/yourtheme/
  3. Вiдкрийте файл page.tpl.php (або layout.tpl.php залежно вiд вашої теми)
  4. Знайдiть закриваючий тег </body> або рядок <?php print $page_bottom; ?>
  5. Вставте ваш код для вставки Asyntai безпосередньо перед цим рядком
  6. Збережіть файл
<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Порада: Розмiщення коду безпосередньо перед <?php print $page_bottom; ?> або закриваючим тегом </body> забезпечує завантаження чатбота пiсля вмiсту сторiнки, що покращує продуктивнiсть завантаження. Цей метод автоматично додає чатбот на кожну сторiнку, що використовує цю тему.

Альтернативний метод 1: Використання користувацького модуля

Ви можете створити простий модуль Backdrop CMS, який вставляє скрипт чатбота за допомогою backdrop_add_js():

  1. Створіть каталог модуля: modules/custom/asyntai_widget/
  2. Створiть файл модуля asyntai_widget.module з наступним кодом:
    // modules/custom/asyntai_widget/asyntai_widget.module
    function asyntai_widget_init() {
      backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array(
        'type' => 'external',
        'scope' => 'footer',
        'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'),
      ));
    }
  3. Створіть файл asyntai_widget.info:
    name = Asyntai AI Chatbot Widget
    description = Adds the Asyntai AI chatbot widget to all pages.
    backdrop = 1.x
    package = Custom
    type = module
  4. Перейдiть до Функцiональнiсть (admin/modules) у панелi адмiнiстрування Backdrop
  5. Знайдiть "Asyntai AI Chatbot Widget" у пакетi Custom та увiмкнiть його
  6. Натисніть "Save configuration"

Примітка: Замiнiть YOUR_WIDGET_ID у кодi модуля на ваш фактичний ID вiджета з Панелi керування Asyntai. Пiдхiд з користувацьким модулем безпечний для оновлень i не буде перезаписаний при оновленнi теми.

Альтернативний метод 2: Використання модуля "Add to Head" Backdrop

Допомiжний модуль "Add to Head" надає простий спосiб вставки скриптiв без редагування коду:

  1. Завантажте та встановiть допомiжний модуль "Add to Head" з сайту Backdrop CMS
  2. Перейдіть до Configuration > Development > Add to Head
  3. Додайте ваш код вбудовування Asyntai у footer section
  4. Натисніть "Save configuration"

Порада: Використання модуля "Add to Head" є найпростiшим методом, якщо ви не хочете редагувати файли теми або створювати користувацькi модулi. Вiн надає простий адмiнiстративний iнтерфейс для управлiння вставленими скриптами.

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

Система макетiв та блокiв Backdrop CMS також може використовуватися для додавання чатбота:

  1. Увійдіть до вашої панелі адміністрування Backdrop CMS
  2. Перейдіть до Structure > Layouts
  3. Оберіть макет, який хочете редагувати (наприклад, макет за замовчуванням)
  4. Натиснiть "Add block" в областi нижнього колонтитула
  5. Оберіть "Custom block"
  6. Встановiть формат блоку на "Full HTML" або "Raw HTML"
  7. Вставте ваш код для вставки Asyntai в тіло блоку
  8. Дайте блоку назву (наприклад, "Asyntai Chatbot") та за бажанням поставте прапорець "Hide title"
  9. Натиснiть "Save block", а потiм "Save layout"

Важливо: Переконайтеся, що текстовий формат встановлено на "Full HTML" або "Raw HTML", щоб тег скрипту не був видалений. Формат "Filtered HTML" за замовчуванням видалить теги скриптiв з мiркувань безпеки.

Крок 3: Очистіть кеш та перевірте

Після внесення змін очистіть кеш Backdrop CMS та перевірте встановлення:

  1. Перейдiть до Configuration > Performance у вашiй панелi адмiнiстрування
  2. Натисніть "Clear all caches"
  3. Відкрийте ваш сайт у новій вкладці браузера або вікні інкогніто
  4. Ви повинні побачити кнопку віджета чату в правому нижньому куті
  5. Натисніть на нього, щоб переконатися, що він відкривається та працює коректно

Не бачите віджет? Переконайтеся, що ви очистили кеш Backdrop CMS у Configuration > Performance. Спробуйте переглянути сайт у вiкнi iнкогнiто або очистити кеш браузера. Вiдкрийте консоль браузера (F12), щоб перевiрити наявнiсть помилок JavaScript. Якщо ви використовували метод користувацького модуля, переконайтеся, що модуль увiмкнено в Функцiональнiсть.