Как добавить ИИ-чат-бот Asyntai в Moodle
Пошаговое руководство для сайтов на Moodle LMS
Шаг 1: Get Your Embed Code
Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.
Шаг 2: Using Additional HTML (Recommended)
Moodle имеет встроенную функцию для добавления пользовательского HTML/JavaScript на все страницы:
- Войдите на ваш сайт Moodle как администратор
- Перейдите в Site administration
- Перейдите в Appearance → Additional HTML
- Прокрутите вниз до раздела «Перед закрытием BODY»
- Вставьте код встраивания Asyntai в текстовую область
- Нажмите \"Save changes\"
Совет: Добавление кода в «Перед закрытием BODY» размещает его непосредственно перед закрывающим тегом </body>, что является рекомендуемым расположением для виджетов чата и гарантирует загрузку после основного содержимого страницы.
Альтернатива: Через настройки темы
Многие темы Moodle (включая Boost и его вариации) имеют собственные настройки для добавления пользовательского JavaScript:
- Перейдите в Site administration → Appearance → Themes
- Нажмите на Настройки темы для вашей активной темы (например, Boost)
- Найдите раздел «Raw SCSS», «Additional HTML» или «Custom JavaScript»
- Если есть поле для JavaScript, вставьте туда код встраивания Asyntai
- Нажмите \"Save changes\"
- Очистите кэши: Администрирование сайта → Разработка → Очистить кэши
Примечание: Специфичные для темы настройки различаются между темами. Если в вашей теме нет поля 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 виджета - Перейдите в Администрирование сайта → Уведомления для установки плагина
- Очистить кэши после установки
Важно: Метод локального плагина требует доступа к командной строке для создания файлов. Для большинства пользователей метод дополнительного HTML проще и достаточен.
Альтернатива: Шаблон подвала темы
You can also edit your theme's footer template directly:
- Перейдите в your theme folder:
theme/YOUR_THEME/ - Найдите файлы layout (например,
layout/columns2.phpилиtemplates/columns2.mustache) - Найдите закрывающий тег
</body>или раздел футера - Add your Asyntai embed code just before
</body> - Сохранить файл
- Очистить кэши Moodle
Важно: Прямое редактирование файлов темы означает, что изменения могут быть потеряны при обновлении темы. Используйте дочернюю тему или метод дополнительного HTML для более постоянного решения.
Шаг 3: Verify Installation
После сохранения изменений и очистки кэшей откройте сайт Moodle в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.
Виджет не отображается? Обязательно очистите все кэши Moodle: перейдите в Администрирование сайта → Разработка → Очистить все кэши. Также попробуйте очистить кэш браузера или открыть сайт в режиме инкогнито. Если используется плагин кэширования или обратный прокси, очистите их кэши тоже.
Weebly