Обратно към таблото

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

Научете как да използвате Asyntai

Как да добавите Asyntai AI чатбот към Moodle

Ръководство стъпка по стъпка за уебсайтове с Moodle LMS

Вземете код за вграждане

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

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

Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.

Стъпка 2: Използване на допълнителен HTML (Препоръчително)

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

  1. Влезте в своя Moodle сайт като администратор
  2. Отидете на Site administration
  3. Навигирайте до Appearance → Additional HTML
  4. Превъртете надолу до секцията "Before BODY is closed"
  5. Поставете вашия Asyntai код за вграждане в текстовото поле
  6. Щракнете върху "Save changes"

Съвет: Добавянето на кода в "Before BODY is closed" го поставя точно преди затварящия таг </body>, което е препоръчителното местоположение за чат уиджети и гарантира зареждане след основното съдържание на страницата.

Алтернатива: Използване на настройки на темата

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

  1. Отидете на Site administration → Appearance → Themes
  2. Щракнете върху Theme settings за вашата активна тема (напр. Boost)
  3. Потърсете секция "Raw SCSS", "Additional HTML" или "Custom JavaScript"
  4. Ако има поле за JavaScript, поставете вашия Asyntai код за вграждане там
  5. Щракнете върху "Save changes"
  6. Изчистете кешовете: 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. Отидете на Site administration → Notifications, за да инсталирате плъгина
  7. Изчистете кешовете след инсталацията

Важно: Методът с локален плъгин изисква достъп до командния ред за създаване на файлове. За повечето потребители методът с допълнителен HTML е по-прост и достатъчен.

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

Можете също да редактирате директно шаблона за футър на вашата тема:

  1. Навигирайте до папката на вашата тема: 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: Проверка на инсталацията

След като запазите промените си и изчистите кешовете, посетете вашия Moodle сайт в нов раздел на браузъра или в режим инкогнито. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Щракнете върху него, за да се уверите, че се отваря и работи правилно.

Не виждате уиджета? Уверете се, че сте изчистили всички Moodle кешове: отидете на Site administration → Development → Purge all caches. Също опитайте да изчистите кеша на браузъра или да разгледате в режим инкогнито. Ако използвате плъгин за кеширане или обратен прокси, изчистете и тези кешове.