Jak dodać chatbota AI Asyntai do Moodle
Przewodnik krok po kroku dla witryn Moodle LMS
Krok 1: Pobierz swój kod osadzania
Najpierw przejdź do swojego Panelu Asyntai i przewiń w dół do sekcji "Kod osadzania". Skopiuj swój unikalny kod osadzania, który będzie wyglądał tak:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Uwaga: Powyższy kod to tylko przykład. Musisz skopiować swój własny unikalny kod osadzania z Panelu, ponieważ zawiera on Twój osobisty identyfikator widgetu.
Krok 2: Użycie dodatkowego kodu HTML (zalecane)
Moodle posiada wbudowana funkcje dodawania niestandardowego kodu HTML/JavaScript do wszystkich stron:
- Log in to your Moodle site as an administrator
- Przejdź do Site administration
- Przejdź do Appearance → Additional HTML
- Przewin w dol do sekcji "Before BODY is closed"
- Wklej kod osadzania Asyntai w polu tekstowym
- Kliknij "Save changes"
Wskazówka: Dodanie kodu w sekcji "Before BODY is closed" umieszcza go tuz przed zamykającym tagiem </body>, co jest zalecanym umiejscowieniem dla widgetów czatu i zapewnia ładowanie po głównej zawartości strony.
Alternatywa: Użycie ustawień motywu
Wiele motywów Moodle (w tym Boost i jego warianty) ma własne ustawienia do dodawania niestandardowego kodu JavaScript:
- Przejdź do Site administration → Appearance → Themes
- Kliknij Theme settings dla aktywnego motywu (np. Boost)
- Poszukaj sekcji "Raw SCSS", "Additional HTML" lub "Custom JavaScript"
- Jeśli istnieje pole JavaScript, wklej tam swoj kod osadzania Asyntai
- Kliknij "Save changes"
- Wyczyść pamięci podreczne: Site administration → Development → Purge caches
Uwaga: Ustawienia specyficzne dla motywu roznia sie między motywami. Jeśli Twój motyw nie ma pola JavaScript, użyj powyzszej metody Additional HTML.
Alternatywa: Tworzenie lokalnej wtyczki
Aby uzyskać większą kontrolę, możesz utworzyć prosta lokalna wtyczkę:
- Utwórz strukture folderow:
local/asyntaichatbot/w swojej instalacji Moodle - Utwórz version.php:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Utwórz lib.php:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - Utwórz folder amd/src/ i plik 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);
}
};
}); - Replace
YOUR_WIDGET_IDwith your actual widget ID - Przejdź do Site administration → Notifications, aby zainstalować wtyczkę
- Wyczyść pamięci podreczne po instalacji
Ważne: Metoda lokalnej wtyczki wymaga dostępu do wiersza polecen w celu tworzenia plików. Dla większości użytkowników metoda Additional HTML jest prostsza i wystarczajaca.
Alternatywa: Edycja szablonu stopki motywu
Możesz również edytować szablon stopki motywu bezpośrednio:
- Przejdź do folderu motywu:
theme/YOUR_THEME/ - Znajdź pliki ukladu (np.
layout/columns2.phplubtemplates/columns2.mustache) - Znajdź zamykający tag
</body>lub sekcję stopki - Dodaj swoj kod osadzania Asyntai tuz przed
</body> - Zapisz plik
- Wyczyść pamięci podreczne Moodle
Ważne: Bezpośrednia edycja plików motywu oznacza, ze zmiany mogą zostac utracone podczas aktualizacji motywu. Użyj motywu potomnego lub metody Additional HTML jako bardziej trwalego rozwiązania.
Krok 3: Weryfikacja instalacji
Po zapisaniu zmian i wyczyszczeniu pamięci podrecznych odwiedź swoja witrynę Moodle w nowej karcie przeglądarki lub w oknie incognito. Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu. Kliknij go, aby upewnić sie, ze otwiera sie i działa poprawnie.
Nie widzisz widgetu? Upewnij sie, ze wyczysciles wszystkie pamięci podreczne Moodle: przejdź do Site administration → Development → Purge all caches. Spróbuj również wyczyść pamięć podręczna przeglądarki lub wyświetlić stronę w oknie incognito. Jeśli używasz wtyczki buforujacej lub odwrotnego serwera proxy, wyczyść również te pamięci podreczne.
Weebly