Како додати Asyntai AI чатбот на Moodle

Водич корак по корак за Moodle LMS веб-сајтове

Платформа:

Корак 1: Набавите свој код за уграђивање

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<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>

Напомена: Код изнад је само пример. Морате копирати свој јединствени код за уграђивање са своје Контролне табле јер садржи ваш лични ИД виџета.

Корак 2: Коришћење додатног HTML-а (препоручено)

Moodle има уграђену функцију за додавање прилагођеног HTML/JavaScript кода на све странице:

Пријавите се на ваш Moodle сајт као администратор
Идите на Администрација сајта
Навигирајте до 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, користите горе наведену методу Additional 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 стварним ИД-ом виџета
Идите на Site administration → Notifications да инсталирате додатак
Очистите кешеве након инсталације

Важно: Метода локалног додатка захтева приступ командној линији за креирање фајлова. За већину корисника, метода Additional HTML је једноставнија и довољна.

Алтернатива: Уредите шаблон подножја теме

Такође можете директно уредити шаблон подножја ваше теме:

Навигирајте до фасцикле ваше теме: theme/YOUR_THEME/
Пронађите layout фајлове (нпр. layout/columns2.php или templates/columns2.mustache)
Пронађите затварајућу ознаку </body> у коду шаблона
Додајте ваш Asyntai код за уградњу пре ознаке </body>
Сачувајте фајл
Очистите Moodle кешеве

Важно: Директно уређивање фајлова теме значи да се измене могу изгубити приликом ажурирања теме. Користите подтему или методу Additional HTML за трајније решење.

Корак 3: Верификујте инсталацију

Након чувања промена и чишћења кешева, посетите ваш Moodle сајт у новој картици прегледача или инкогнито прозору. Требало би да видите дугме виџета за ћаскање у доњем десном углу. Кликните на њега да проверите да ли се отвара и ради исправно.

Не видите виџет? Обавезно очистите све Moodle кешеве: идите на Site administration → Development → Purge all caches. Такође покушајте да обришете кеш прегледача или да прегледате у инкогнито прозору. Ако користите додатак за кеширање или реверзни прокси, очистите и те кешеве.