Zurück zum Dashboard

Dokumentation

Erfahren Sie, wie Sie Asyntai verwenden

So fügen Sie den Asyntai-KI-Chatbot zu Moodle hinzu

Schritt-für-Schritt-Anleitung für Moodle LMS-Websites

Einbettungscode erhalten

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:

  1. Melden Sie sich als Administrator bei Ihrer Moodle-Website an
  2. Gehen Sie zu Site administration
  3. Navigieren Sie zu Appearance → Additional HTML
  4. Scrollen Sie nach unten zum Abschnitt "Vor Schließen von BODY"
  5. Fügen Sie Ihren Asyntai-Einbettungscode in das Textfeld ein
  6. 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:

  1. Gehen Sie zu Website-Administration → Darstellung → Themes
  2. Klicken Sie auf Theme settings für Ihr aktives Theme (z. B. Boost)
  3. Suchen Sie nach dem Abschnitt "Raw SCSS", "Additional HTML" oder "Custom JavaScript"
  4. Wenn es ein JavaScript-Feld gibt, fügen Sie Ihren Asyntai-Einbettungscode dort ein
  5. Klicken Sie auf "Save changes"
  6. 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:

  1. Erstellen Sie die Ordnerstruktur: local/asyntaichatbot/ in Ihrer Moodle-Installation
  2. Erstellen Sie version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. 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');
    }
  4. 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);
        }
      };
    });
  5. Ersetzen Sie YOUR_WIDGET_ID durch Ihre tatsächliche Widget-ID
  6. Gehen Sie zu Site administration → Notifications, um das Plugin zu installieren
  7. 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:

  1. Navigieren Sie zu Ihrem Theme-Ordner: theme/YOUR_THEME/
  2. Suchen Sie die Layout-Dateien (z. B. layout/columns2.php oder templates/columns2.mustache)
  3. Suchen Sie das schließende </body>-Tag oder den Fußzeilenbereich
  4. Fügen Sie Ihren Asyntai-Einbettungscode direkt vor </body> ein
  5. Speichern Sie die Datei
  6. 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.