Назад к панели управления

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

Узнайте, как использовать Asyntai

Как добавить ИИ-чат-бот Asyntai в Moodle

Пошаговое руководство для сайтов на Moodle LMS

Получить код встраивания

Шаг 1: Получите код встраивания

Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.

Шаг 2: Через дополнительный HTML (рекомендуется)

Moodle имеет встроенную функцию для добавления пользовательского HTML/JavaScript на все страницы:

  1. Войдите на ваш сайт Moodle как администратор
  2. Перейдите в Site administration
  3. Перейдите в Appearance → Additional HTML
  4. Прокрутите вниз до раздела «Перед закрытием BODY»
  5. Вставьте код встраивания Asyntai в текстовую область
  6. Нажмите «Save changes»

Совет: Добавление кода в «Перед закрытием BODY» размещает его непосредственно перед закрывающим тегом </body>, что является рекомендуемым расположением для виджетов чата и гарантирует загрузку после основного содержимого страницы.

Альтернатива: Через настройки темы

Многие темы Moodle (включая Boost и его вариации) имеют собственные настройки для добавления пользовательского JavaScript:

  1. Перейдите в Site administration → Appearance → Themes
  2. Нажмите на Настройки темы для вашей активной темы (например, Boost)
  3. Найдите раздел «Raw SCSS», «Additional HTML» или «Custom JavaScript»
  4. Если есть поле для JavaScript, вставьте туда код встраивания Asyntai
  5. Нажмите «Save changes»
  6. Purge the caches: Site administration > Development > Purge caches

Примечание: Специфичные для темы настройки различаются между темами. Если в вашей теме нет поля 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. Замените YOUR_WIDGET_ID на ваш реальный ID виджета
  6. Go to Site administration > Notifications to install the plugin
  7. Очистить кэши после установки

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

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

Вы также можете отредактировать шаблон футера вашей темы напрямую:

  1. Перейдите в папку вашей темы: theme/YOUR_THEME/
  2. Найдите файлы layout (например, layout/columns2.php или templates/columns2.mustache)
  3. Найдите закрывающий тег </body> или раздел футера
  4. Добавьте код вставки Asyntai перед тегом </body>
  5. Сохраните файл
  6. Очистить кэши Moodle

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

Шаг 3: Проверка установки

После сохранения изменений и очистки кэшей откройте сайт Moodle в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.

Виджет не отображается? Обязательно очистите все кэши Moodle: перейдите в Администрирование сайта → Разработка → Очистить все кэши. Также попробуйте очистить кэш браузера или открыть сайт в режиме инкогнито. Если используется плагин кэширования или обратный прокси, очистите их кэши тоже.