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

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

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

Как добавить ИИ-чат-бот 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 на все страницы:

  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. Очистите кэши: Администрирование сайта → Разработка → Очистить кэши

Примечание: Специфичные для темы настройки различаются между темами. Если в вашей теме нет поля 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. Перейдите в Администрирование сайта → Уведомления для установки плагина
  7. Очистить кэши после установки

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

Альтернатива: Шаблон подвала темы

You can also edit your theme's footer template directly:

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

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

Шаг 3: Verify Installation

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

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