Hoe voegt u de Asyntai AI-chatbot toe aan Moodle

Stapsgewijze handleiding voor Moodle LMS-websites

Insluitcode ophalen

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:

  1. Log in op uw Moodle-site als beheerder
  2. Ga naar Sitebeheer
  3. Navigeer naar Uiterlijk → Aanvullende HTML
  4. Scroll down to the "Before BODY is closed" section
  5. Plak uw Asyntai-insluitcode in het tekstveld
  6. 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:

  1. Ga naar Sitebeheer → Uiterlijk → Thema's
  2. Klik op Thema-instellingen voor uw actieve thema (bijv. Boost)
  3. Zoek naar de sectie "Raw SCSS", "Additional HTML" of "Custom JavaScript"
  4. Als er een JavaScript-veld is, plak daar uw Asyntai-insluitcode
  5. Klik op "Save changes"
  6. 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:

  1. Maak de mapstructuur aan: local/asyntaichatbot/ in uw Moodle-installatie
  2. Maak version.php aan:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. 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');
    }
  4. 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);
        }
      };
    });
  5. Vervang YOUR_WIDGET_ID door uw werkelijke widget-ID
  6. Ga naar Sitebeheer → Meldingen om de plugin te installeren
  7. 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:

  1. Navigeer naar uw themamap: theme/YOUR_THEME/
  2. Zoek de layout-bestanden (bijv. layout/columns2.php of templates/columns2.mustache)
  3. Zoek de afsluitende </body>-tag of de footersectie
  4. Voeg uw Asyntai-insluitcode toe net voor </body>
  5. Sla het bestand op
  6. 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.