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

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

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

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

Покрокова інструкція для вебсайтів Moodle LMS

Отримати код вбудовування

Крок 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н мiстить ваш особистий ID вiджета.

Крок 2: Використання додаткового HTML (Рекомендовано)

Moodle має вбудовану функцію для додавання власного HTML/JavaScript на всі сторінки:

  1. Увійдіть на ваш сайт Moodle як адміністратор
  2. Перейдіть до Site administration
  3. Перейдіть до Appearance → Additional HTML
  4. Прокрутіть вниз до розділу "Before BODY is closed"
  5. Вставте код вбудовування Asyntai у текстове поле
  6. Натисніть "Save changes"

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

Альтернатива: Використання налаштувань теми

Багато тем Moodle (включаючи Boost та її варіанти) мають власні налаштування для додавання власного JavaScript:

  1. Перейдіть до Site administration → Appearance → Themes
  2. Натисніть на Theme settings для вашої активної теми (наприклад, Boost)
  3. Знайдіть розділ "Raw SCSS", "Additional HTML" або "Custom JavaScript"
  4. Якщо є поле JavaScript, вставте туди ваш код вбудовування Asyntai
  5. Натисніть "Save changes"
  6. Очистіть кеші: Site administration → Development → Purge caches

Примiтка: Налаштування, специфічні для теми, відрізняються між темами. Якщо ваша тема не має поля JavaScript, використовуйте метод додаткового HTML, описаний вище.

Альтернатива: Створення локального плагіна

Для більшого контролю ви можете створити простий локальний плагін:

  1. Створіть структуру папок: local/asyntaichatbot/ у вашій інсталяції Moodle
  2. Створіть version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Створіть lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Створіть папку amd/src/ та файл loader.js:
    define([], function() {
      return {
        init: 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);
        }
      };
    });
  5. Замiнiть YOUR_WIDGET_ID на ваш фактичний ID вiджету
  6. Перейдіть до Site administration → Notifications, щоб встановити плагін
  7. Очистіть кеші після встановлення

Важливо: Метод локального плагіна вимагає доступу до командного рядка для створення файлів. Для більшості користувачів метод додаткового HTML є простішим та достатнім.

Альтернатива: Редагування шаблону футера теми

Ви також можете безпосередньо відредагувати шаблон футера вашої теми:

  1. Перейдіть до папки вашої теми: theme/YOUR_THEME/
  2. Знайдіть файли layout (наприклад, layout/columns2.php або templates/columns2.mustache)
  3. Знайдіть закриваючий тег </body> або розділ футера
  4. Add your Asyntai embed code just before </body>
  5. Збережiть файл
  6. Очистіть кеші Moodle

Важливо: Безпосереднє редагування файлів теми означає, що зміни можуть бути втрачені при оновленні теми. Використовуйте дочірню тему або метод додаткового HTML для більш постійного рішення.

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

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

Не бачите вiджет? Переконайтеся, що ви очистили всі кеші Moodle: перейдіть до Site administration → Development → Purge all caches. Також спробуйте очистити кеш браузера або переглянути сторінку у вікні інкогніто. Якщо ви використовуєте плагін кешування або зворотний проксі, очистіть і ці кеші.