So fügen Sie den Asyntai AI 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. Log in to your Moodle site as an administrator
  2. Gehen Sie zu Site administration
  3. Navigieren Sie zu Appearance → Additional HTML
  4. Scroll down to the "Before BODY is closed" section
  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. Go to Site administration → Appearance → 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. If there's a JavaScript field, paste your Asyntai embed code there
  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. Replace YOUR_WIDGET_ID with your actual 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. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </body>
  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.