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

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

Платформа:

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

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

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

Стъпка 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

Забележка: Специфичните за темата настройки се различават при различните теми. Ако вашата тема няма поле за 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 на уиджета
Отидете на Site administration → Notifications, за да инсталирате плъгина
Изчистете кешовете след инсталацията

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

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

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

Навигирайте до папката на вашата тема: theme/YOUR_THEME/
Намерете файловете за layout (напр. layout/columns2.php или templates/columns2.mustache)
Намерете затварящия таг </body> или секцията за футър
Добавете вашия Asyntai код за вграждане точно преди затварящия таг </body>
Запазете файла
Изчистете Moodle кешовете

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

Стъпка 3: Проверка на инсталацията

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

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