Sådan tilføjer du Asyntai AI-chatbot til Moodle

Trin-for-trin vejledning til Moodle LMS-websteder

Platform:

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Brug af ekstra HTML (anbefalet)

Moodle har en indbygget funktion til at tilføje brugerdefineret HTML/JavaScript til alle sider:

Log ind på dit Moodle-websted som administrator
Gå til Webstedsadministration
Naviger til Udseende → Ekstra HTML
Rul ned til sektionen "Før BODY lukkes"
Indsæt din Asyntai-indlejringskode i tekstområdet
Klik på "Gem ændringer"

Tip: Tilføjelse af koden til "Før BODY lukkes" placerer den lige før det afsluttende </body>-tag, hvilket er den anbefalede placering for chat-widgets og sikrer, at den indlæses efter det primære sideindhold.

Alternativ: Brug af temaindstillinger

Mange Moodle-temaer (herunder Boost og dets varianter) har deres egne indstillinger til at tilføje brugerdefineret JavaScript:

Gå til Webstedsadministration → Udseende → Temaer
Klik på Temaindstillinger for dit aktive tema (f.eks. Boost)
Se efter sektionen "Rå SCSS", "Ekstra HTML" eller "Brugerdefineret JavaScript"
If there's a JavaScript field, paste your Asyntai embed code there
Klik på "Gem ændringer"
Ryd caches: Webstedsadministration → Udvikling → Ryd caches

Bemærk: Temaspecifikke indstillinger varierer mellem temaer. Hvis dit tema ikke har et JavaScript-felt, skal du bruge metoden med ekstra HTML ovenfor.

Alternativ: Oprettelse af et lokalt plugin

For mere kontrol kan du oprette et simpelt lokalt plugin:

Opret mappestrukturen: local/asyntaichatbot/ i din Moodle-installation
Opret version.php:
<?php defined('MOODLE_INTERNAL') || die(); $plugin->component = 'local_asyntaichatbot'; $plugin->version = 2024010100; $plugin->requires = 2022041900;
Opret lib.php:
<?php defined('MOODLE_INTERNAL') || die(); function local_asyntaichatbot_before_footer() { global $PAGE; $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init'); }
Opret mappen amd/src/ og filen 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); } }; });
Erstat YOUR_WIDGET_ID med dit faktiske widget-ID
Gå til Webstedsadministration → Meddelelser for at installere pluginnet
Ryd caches efter installation

Vigtigt: Metoden med det lokale plugin kræver kommandolinjeadgang for at oprette filer. For de fleste brugere er metoden med ekstra HTML enklere og tilstrækkelig.

Alternativ: Rediger temaets sidefodsskabelon

Du kan også redigere dit temas sidefodsskabelon direkte:

Naviger til din temamappe: theme/YOUR_THEME/
Find layout-filerne (f.eks. layout/columns2.php eller templates/columns2.mustache)
Find det afsluttende </body>-tag eller sidefodssektionen
Tilføj din Asyntai-indlejringskode lige før </body>
Gem filen
Ryd Moodle-caches

Vigtigt: Direkte redigering af temafiler betyder, at ændringer kan gå tabt, når du opdaterer dit tema. Brug et child-tema eller metoden med ekstra HTML for en mere permanent løsning.

Trin 3: Verificér installationen

Efter at have gemt dine ændringer og ryddet caches skal du besøge dit Moodle-websted i en ny browserfane eller et inkognitovindue. Du bør se chat-widget-knappen i nederste højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for at rydde alle Moodle-caches: gå til Webstedsadministration → Udvikling → Ryd alle caches. Prøv også at rydde din browsercache eller se siden i et inkognitovindue. Hvis du bruger et caching-plugin eller reverse proxy, skal du også rydde disse caches.