Înapoi la tabloul de bord

Documentație

Aflați cum să utilizați Asyntai

Cum să adăugați Chatbot-ul AI Asyntai în Moodle

Ghid pas cu pas pentru site-urile LMS Moodle

Obține codul de încorporare

Pasul 1: Obțineți codul de încorporare

Mai întâi, accesați Tabloul de bord Asyntai și derulați în jos până la secțiunea "Cod de încorporare". Copiați codul unic de încorporare care va arăta astfel:

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

Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.

Pasul 2: Utilizarea HTML adițional (Recomandat)

Moodle are o funcție integrată pentru a adăuga HTML/JavaScript personalizat pe toate paginile:

  1. Conectați-vă la site-ul Moodle ca administrator
  2. Mergeți la Site administration
  3. Navigați la Appearance → Additional HTML
  4. Derulați în jos la secțiunea "Before BODY is closed"
  5. Lipiți codul de integrare Asyntai în zona de text
  6. Faceți clic pe "Save changes"

Sfat: Adăugarea codului la "Before BODY is closed" îl plasează chiar înainte de eticheta de închidere </body>, ceea ce este plasarea recomandată pentru widget-urile de chat și asigură că se încarcă după conținutul principal al paginii.

Alternativă: Utilizarea setărilor temei

Multe teme Moodle (inclusiv Boost și variantele sale) au propriile setări pentru adăugarea JavaScript personalizat:

  1. Mergeți la Site administration → Appearance → Themes
  2. Faceți clic pe Theme settings pentru tema activă (de ex., Boost)
  3. Căutați secțiunea "Raw SCSS", "Additional HTML" sau "Custom JavaScript"
  4. Dacă există un câmp JavaScript, lipiți codul de integrare Asyntai acolo
  5. Faceți clic pe "Save changes"
  6. Curățați cache-urile: Site administration → Development → Purge caches

Notă: Setările specifice temei variază între teme. Dacă tema dvs. nu are un câmp JavaScript, utilizați metoda HTML adițional de mai sus.

Alternativă: Crearea unui plugin local

Pentru mai mult control, puteți crea un plugin local simplu:

  1. Creați structura de foldere: local/asyntaichatbot/ în instalarea Moodle
  2. Creați version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Creați lib.php:
    <?php
    defined('MOODLE_INTERNAL') || die();

    function local_asyntaichatbot_before_footer() {
      global $PAGE;
      $PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
    }
  4. Creați folderul amd/src/ și fișierul 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. Înlocuiți YOUR_WIDGET_ID cu ID-ul real al widget-ului dvs.
  6. Mergeți la Site administration → Notifications pentru a instala pluginul
  7. Curățați cache-urile după instalare

Important: Metoda pluginului local necesită acces la linia de comandă pentru a crea fișiere. Pentru majoritatea utilizatorilor, metoda HTML adițional este mai simplă și suficientă.

Alternativă: Editați șablonul footer al temei

De asemenea, puteți edita direct șablonul footer al temei:

  1. Navigați la folderul temei: theme/YOUR_THEME/
  2. Găsiți fișierele de layout (de ex., layout/columns2.php sau templates/columns2.mustache)
  3. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </body>
  5. Salvați fișierul
  6. Curățați cache-urile Moodle

Important: Editarea directă a fișierelor temei înseamnă că modificările pot fi pierdute la actualizarea temei. Utilizați o temă copil sau metoda HTML adițional pentru o soluție mai permanentă.

Pasul 3: Verificați instalarea

După ce ați salvat modificările și ați curățat cache-urile, vizitați site-ul Moodle într-o filă nouă de browser sau într-o fereastră incognito. Ar trebui să vedeți butonul widget-ului de chat în colțul din dreapta jos. Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect.

Nu vedeți widgetul? Asigurați-vă că curățați toate cache-urile Moodle: mergeți la Site administration → Development → Purge all caches. De asemenea, încercați să goliți cache-ul browserului sau să vizualizați într-o fereastră incognito. Dacă utilizați un plugin de caching sau un reverse proxy, curățați și acele cache-uri.