Hur du lägger till Asyntai AI-chattbot i Moodle

Steg-för-steg-guide för Moodle LMS-webbplatser

Hämta inbäddningskod

Steg 1: Hämta din inbäddningskod

Gå först till din Asyntai-instrumentpanel och scrolla ner till avsnittet "Inbäddningskod". Kopiera din unika inbäddningskod som ser ut så här:

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

Obs! Koden ovan är bara ett exempel. Du måste kopiera din egen unika inbäddningskod från din instrumentpanel eftersom den innehåller ditt personliga widget-ID.

Steg 2: Använda ytterligare HTML (rekommenderas)

Moodle har en inbyggd funktion för att lägga till anpassad HTML/JavaScript på alla sidor:

  1. Logga in på din Moodle-sajt som administratör
  2. Gå till Webbplatsadministration
  3. Navigera till Utseende → Ytterligare HTML
  4. Scrolla ner till avsnittet "Before BODY is closed"
  5. Klistra in din Asyntai-inbäddningskod i textområdet
  6. Klicka på "Save changes"

Tips: Att lägga till koden i "Before BODY is closed" placerar den precis före den avslutande </body>-taggen, vilket är den rekommenderade placeringen för chattwidgetar och säkerställer att den laddas efter sidans huvudinnehåll.

Alternativ: Använda temainställningar

Många Moodle-teman (inklusive Boost och dess varianter) har egna inställningar för att lägga till anpassad JavaScript:

  1. Gå till Webbplatsadministration → Utseende → Teman
  2. Klicka på Temainställningar för ditt aktiva tema (t.ex. Boost)
  3. Leta efter avsnittet "Raw SCSS", "Additional HTML" eller "Custom JavaScript"
  4. If there's a JavaScript field, paste your Asyntai embed code there
  5. Klicka på "Save changes"
  6. Rensa cacheminnen: Webbplatsadministration → Utveckling → Rensa cacheminnen

Obs! Temaspecifika inställningar varierar mellan teman. Om ditt tema inte har ett JavaScript-fält, använd metoden Ytterligare HTML ovan.

Alternativ: Skapa ett lokalt plugin

För mer kontroll kan du skapa ett enkelt lokalt plugin:

  1. Skapa mappstrukturen: local/asyntaichatbot/ i din Moodle-installation
  2. Skapa version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Skapa lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Skapa mappen amd/src/ och 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);
        }
      };
    });
  5. Ersätt YOUR_WIDGET_ID med ditt faktiska widget-ID
  6. Gå till Webbplatsadministration → Aviseringar för att installera tillägget
  7. Rensa cacheminnen efter installationen

Viktigt: Den lokala plugin-metoden kräver kommandoradsåtkomst för att skapa filer. För de flesta användare är metoden med ytterligare HTML enklare och tillräcklig.

Alternativ: Redigera temats sidfotsmall

Du kan också redigera ditt temas sidfotsmall direkt:

  1. Navigera till din temamapp: theme/YOUR_THEME/
  2. Hitta layout-filerna (t.ex. layout/columns2.php eller templates/columns2.mustache)
  3. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </body>
  5. Spara filen
  6. Rensa Moodle-cacheminnen

Viktigt: Att redigera temafiler direkt innebär att ändringar kan gå förlorade vid temauppdateringar. Använd ett underordnat tema eller metoden för ytterligare HTML för en mer permanent lösning.

Steg 3: Verifiera installationen

Efter att du har sparat dina ändringar och rensat cachen, besök din Moodle-webbplats i en ny webbläsarflik eller ett inkognitofönster. Du bör se widgetknappen för chatten i det nedre högra hörnet. Klicka på den för att kontrollera att den öppnas och fungerar korrekt.

Ser du inte widgeten? Se till att rensa alla Moodle-cacher: gå till Webbplatsadministration → Utveckling → Rensa alla cacher. Prova också att rensa webbläsarens cache eller visa i ett inkognitofönster. Om du använder ett cachningsplugin eller en omvänd proxy, rensa även dessa cacher.