Как да добавите 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 към всички страници:
- Влезте в своя 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>или секцията за футър - Add your Asyntai embed code just before
</body> - Запазете файла
- Изчистете Moodle кешовете
Важно: Директното редактиране на файловете на темата означава, че промените могат да бъдат загубени при обновяване на темата. Използвайте дъщерна тема или метода с допълнителен HTML за по-трайно решение.
Стъпка 3: Проверка на инсталацията
След като запазите промените си и изчистите кешовете, посетете вашия Moodle сайт в нов раздел на браузъра или в режим инкогнито. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Щракнете върху него, за да се уверите, че се отваря и работи правилно.
Не виждате уиджета? Уверете се, че сте изчистили всички Moodle кешове: отидете на Site administration → Development → Purge all caches. Също опитайте да изчистите кеша на браузъра или да разгледате в режим инкогнито. Ако използвате плъгин за кеширане или обратен прокси, изчистете и тези кешове.
Weebly