Hoe voegt u de Asyntai AI-chatbot toe aan Moodle
Stapsgewijze handleiding voor Moodle LMS-websites
Stap 1: Uw insluitcode ophalen
Ga eerst naar uw Asyntai Dashboard en scroll naar het gedeelte "Insluitcode". Kopieer uw unieke insluitcode die er als volgt uitziet:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Opmerking: De bovenstaande code is slechts een voorbeeld. U moet uw eigen unieke insluitcode kopiëren vanuit uw Dashboard omdat deze uw persoonlijke widget-ID bevat.
Stap 2: Aanvullende HTML gebruiken (aanbevolen)
Moodle heeft een ingebouwde functie om aangepaste HTML/JavaScript aan alle pagina's toe te voegen:
- Log in op uw Moodle-site als beheerder
- Ga naar Sitebeheer
- Navigeer naar Uiterlijk → Aanvullende HTML
- Scroll down to the "Before BODY is closed" section
- Plak uw Asyntai-insluitcode in het tekstveld
- Klik op "Save changes"
Tip: Het toevoegen van de code bij "Before BODY is closed" plaatst deze net voor de afsluitende </body>-tag. Dit is de aanbevolen plaatsing voor chatwidgets en zorgt ervoor dat deze wordt geladen na de hoofdinhoud van de pagina.
Alternatief: Thema-instellingen gebruiken
Veel Moodle-thema's (waaronder Boost en varianten ervan) hebben hun eigen instellingen voor het toevoegen van aangepast JavaScript:
- Ga naar Sitebeheer → Uiterlijk → Thema's
- Klik op Thema-instellingen voor uw actieve thema (bijv. Boost)
- Zoek naar de sectie "Raw SCSS", "Additional HTML" of "Custom JavaScript"
- Als er een JavaScript-veld is, plak daar uw Asyntai-insluitcode
- Klik op "Save changes"
- Wis de caches: Sitebeheer → Ontwikkeling → Caches wissen
Opmerking: Themaspecifieke instellingen variëren per thema. Als uw thema geen JavaScript-veld heeft, gebruik dan de bovenstaande methode met aanvullende HTML.
Alternatief: Een lokale plugin maken
Voor meer controle kunt u een eenvoudige lokale plugin maken:
- Maak de mapstructuur aan:
local/asyntaichatbot/in uw Moodle-installatie - Maak version.php aan:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Maak lib.php aan:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - Maak de map amd/src/ en het bestand loader.js aan:
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);
}
};
}); - Vervang
YOUR_WIDGET_IDdoor uw werkelijke widget-ID - Ga naar Sitebeheer → Meldingen om de plugin te installeren
- Wis de caches na de installatie
Belangrijk: De lokale pluginmethode vereist opdrachtregeltoegang om bestanden aan te maken. Voor de meeste gebruikers is de methode met aanvullende HTML eenvoudiger en voldoende.
Alternatief: Thema-footertemplate bewerken
U kunt ook de footertemplate van uw thema rechtstreeks bewerken:
- Navigeer naar uw themamap:
theme/YOUR_THEME/ - Zoek de layout-bestanden (bijv.
layout/columns2.phpoftemplates/columns2.mustache) - Zoek de afsluitende
</body>-tag of de footersectie - Voeg uw Asyntai-insluitcode toe net voor
</body> - Sla het bestand op
- Wis de Moodle-caches
Belangrijk: Het rechtstreeks bewerken van themabestanden betekent dat wijzigingen verloren kunnen gaan bij het bijwerken van uw thema. Gebruik een child-thema of de methode met aanvullende HTML voor een meer permanente oplossing.
Stap 3: Installatie verifiëren
Bezoek na het opslaan van uw wijzigingen en het wissen van de caches uw Moodle-site in een nieuw browsertabblad of incognitovenster. U zou de chatwidgetknop rechtsonder in de hoek moeten zien. Klik erop om te controleren of deze correct opent en werkt.
Ziet u de widget niet? Zorg ervoor dat u alle Moodle-caches wist: ga naar Sitebeheer → Ontwikkeling → Alle caches wissen. Probeer ook uw browsercache te wissen of bekijk de pagina in een incognitovenster. Als u een cachingplugin of reverse proxy gebruikt, wis dan ook die caches.
Weebly