Як додати 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 на всі сторінки:
- Увійдіть на ваш сайт 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
Примiтка: Налаштування, специфічні для теми, відрізняються між темами. Якщо ваша тема не має поля 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);
}
};
}); - Замiнiть
YOUR_WIDGET_IDна ваш фактичний ID вiджету - Перейдіть до Site administration → Notifications, щоб встановити плагін
- Очистіть кеші після встановлення
Важливо: Метод локального плагіна вимагає доступу до командного рядка для створення файлів. Для більшості користувачів метод додаткового HTML є простішим та достатнім.
Альтернатива: Редагування шаблону футера теми
Ви також можете безпосередньо відредагувати шаблон футера вашої теми:
- Перейдіть до папки вашої теми:
theme/YOUR_THEME/ - Знайдіть файли layout (наприклад,
layout/columns2.phpабоtemplates/columns2.mustache) - Знайдіть закриваючий тег
</body>або розділ футера - Add your Asyntai embed code just before
</body> - Збережiть файл
- Очистіть кеші Moodle
Важливо: Безпосереднє редагування файлів теми означає, що зміни можуть бути втрачені при оновленні теми. Використовуйте дочірню тему або метод додаткового HTML для більш постійного рішення.
Крок 3: Перевiрте встановлення
Після збереження змін та очищення кешів відвідайте ваш сайт Moodle у новій вкладці браузера або у вікні інкогніто. Ви повинні побачити кнопку чат-віджета у нижньому правому куті. Натисніть на неї, щоб переконатися, що вона відкривається та працює коректно.
Не бачите вiджет? Переконайтеся, що ви очистили всі кеші Moodle: перейдіть до Site administration → Development → Purge all caches. Також спробуйте очистити кеш браузера або переглянути сторінку у вікні інкогніто. Якщо ви використовуєте плагін кешування або зворотний проксі, очистіть і ці кеші.
Weebly