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

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

Платформа:

Крок 1: Отримайте код для вставки

Спочатку перейдіть до своєї панелі керування Asyntai і прокрутіть вниз до розділу "Код вбудовування". Скопіюйте свій унікальний код вбудовування, який виглядає так:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

Примітка: Код вище є лише прикладом. Ви повинні скопіювати власний унікальний код для вставки з вашої Панелі керування, оскільки він містить ваш особистий ID віджета.

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

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

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

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

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

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

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

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

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

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

Створіть структуру папок: local/asyntaichatbot/ у вашій інсталяції Moodle
Створіть version.php:
<?php defined('MOODLE_INTERNAL') || die(); $plugin->component = 'local_asyntaichatbot'; $plugin->version = 2024010100; $plugin->requires = 2022041900;
Створіть lib.php:
<?php defined('MOODLE_INTERNAL') || die(); function local_asyntaichatbot_before_footer() { global $PAGE; $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init'); }
Створіть папку 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); } }; });
Замініть YOUR_WIDGET_ID на ваш фактичний ID віджету
Перейдіть до Site administration → Notifications, щоб встановити плагін
Очистіть кеші після встановлення

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

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

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

Перейдіть до папки вашої теми: theme/YOUR_THEME/
Знайдіть файли layout (наприклад, layout/columns2.php або templates/columns2.mustache)
Знайдіть закриваючий тег </body> або розділ футера
Додайте ваш код вбудовування Asyntai перед тегом </body>
Збережіть файл
Очистіть кеші Moodle

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

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

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

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