So fügen Sie den Asyntai AI Chatbot zu Moodle hinzu
Schritt-für-Schritt-Anleitung für Moodle LMS-Websites
Schritt 1: Ihren Einbettungscode erhalten
Gehen Sie zunächst zu Ihrem Asyntai Dashboard und scrollen Sie zum Abschnitt "Einbettungscode". Kopieren Sie Ihren einzigartigen Einbettungscode, der so aussieht:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Hinweis: Der obige Code ist nur ein Beispiel. Sie müssen Ihren eigenen einzigartigen Einbettungscode von Ihrem Dashboard kopieren, da er Ihre persönliche Widget-ID enthält.
Schritt 2: Zusätzliches HTML verwenden (Empfohlen)
Moodle verfügt über eine integrierte Funktion zum Hinzufügen von benutzerdefiniertem HTML/JavaScript auf allen Seiten:
- Log in to your Moodle site as an administrator
- Gehen Sie zu Site administration
- Navigieren Sie zu Appearance → Additional HTML
- Scroll down to the "Before BODY is closed" section
- Fügen Sie Ihren Asyntai-Einbettungscode in das Textfeld ein
- Klicken Sie auf "Save changes"
Tipp: Das Hinzufügen des Codes zu "Before BODY is closed" platziert ihn direkt vor dem schließenden </body>-Tag, was die empfohlene Platzierung für Chat-Widgets ist und sicherstellt, dass er nach dem Hauptseiteninhalt geladen wird.
Alternative: Theme-Einstellungen verwenden
Viele Moodle-Themes (einschließlich Boost und seiner Varianten) haben eigene Einstellungen zum Hinzufügen von benutzerdefiniertem JavaScript:
- Go to Site administration → Appearance → Themes
- Klicken Sie auf Theme settings für Ihr aktives Theme (z. B. Boost)
- Suchen Sie nach dem Abschnitt "Raw SCSS", "Additional HTML" oder "Custom JavaScript"
- If there's a JavaScript field, paste your Asyntai embed code there
- Klicken Sie auf "Save changes"
- Leeren Sie die Caches: Site administration → Development → Purge caches
Hinweis: Theme-spezifische Einstellungen variieren zwischen Themes. Wenn Ihr Theme kein JavaScript-Feld hat, verwenden Sie die oben beschriebene Methode mit Additional HTML.
Alternative: Lokales Plugin erstellen
Für mehr Kontrolle können Sie ein einfaches lokales Plugin erstellen:
- Erstellen Sie die Ordnerstruktur:
local/asyntaichatbot/in Ihrer Moodle-Installation - Erstellen Sie version.php:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Erstellen Sie lib.php:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - Erstellen Sie den Ordner amd/src/ und die Datei 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 - Gehen Sie zu Site administration → Notifications, um das Plugin zu installieren
- Leeren Sie die Caches nach der Installation
Wichtig: Die lokale Plugin-Methode erfordert Kommandozeilenzugriff zum Erstellen von Dateien. Für die meisten Benutzer ist die Additional HTML-Methode einfacher und ausreichend.
Alternative: Theme-Footer-Vorlage bearbeiten
Sie können auch die Footer-Vorlage Ihres Themes direkt bearbeiten:
- Navigieren Sie zu Ihrem Theme-Ordner:
theme/YOUR_THEME/ - Suchen Sie die Layout-Dateien (z. B.
layout/columns2.phpodertemplates/columns2.mustache) - Find the closing
</body>tag or the footer section - Add your Asyntai embed code just before
</body> - Speichern Sie die Datei
- Leeren Sie die Moodle-Caches
Wichtig: Das direkte Bearbeiten von Theme-Dateien bedeutet, dass Änderungen bei einer Aktualisierung Ihres Themes verloren gehen können. Verwenden Sie ein Child-Theme oder die Additional HTML-Methode für eine dauerhaftere Lösung.
Schritt 3: Installation überprüfen
Besuchen Sie nach dem Speichern Ihrer Änderungen und dem Leeren der Caches Ihre Moodle-Website in einem neuen Browser-Tab oder Inkognito-Fenster. Sie sollten den Chat-Widget-Button in der unteren rechten Ecke sehen. Klicken Sie darauf, um sicherzustellen, dass er sich öffnet und korrekt funktioniert.
Widget nicht sichtbar? Stellen Sie sicher, dass Sie alle Moodle-Caches leeren: Gehen Sie zu Site administration → Development → Purge all caches. Versuchen Sie auch, Ihren Browser-Cache zu leeren oder die Seite in einem Inkognito-Fenster anzuzeigen. Wenn Sie ein Caching-Plugin oder einen Reverse-Proxy verwenden, leeren Sie auch diese Caches.
Weebly