Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Come aggiungere il chatbot IA Asyntai a Moodle

Guida passo passo per i siti web Moodle LMS

Ottieni il codice di incorporamento

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

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

Nota: Il codice sopra è solo un esempio. Devi copiare il tuo codice di incorporamento univoco dalla tua Dashboard poiché contiene il tuo ID widget personale.

Passaggio 2: Utilizzo di HTML aggiuntivo (consigliato)

Moodle dispone di una funzionalità integrata per aggiungere HTML/JavaScript personalizzato a tutte le pagine:

  1. Accedi al tuo sito Moodle come amministratore
  2. Vai su Site administration
  3. Naviga su Appearance → Additional HTML
  4. Scroll down to the "Before BODY is closed" section
  5. Incolla il codice di incorporamento Asyntai nell'area di testo
  6. Clicca su "Save changes"

Suggerimento: L'aggiunta del codice a "Before BODY is closed" lo posiziona appena prima del tag di chiusura </body>, che è il posizionamento consigliato per i widget chat e garantisce che si carichi dopo il contenuto principale della pagina.

Alternativa: Utilizzo delle impostazioni del tema

Molti temi Moodle (incluso Boost e le sue varianti) hanno le proprie impostazioni per aggiungere JavaScript personalizzato:

  1. Vai su Site administration → Appearance → Themes
  2. Clicca su Theme settings per il tuo tema attivo (ad es., Boost)
  3. Cerca la sezione "Raw SCSS", "Additional HTML" o "Custom JavaScript"
  4. If there's a JavaScript field, paste your Asyntai embed code there
  5. Clicca su "Save changes"
  6. Svuota le cache: Site administration → Development → Purge caches

Nota: Le impostazioni specifiche del tema variano tra i temi. Se il tuo tema non ha un campo JavaScript, utilizza il metodo HTML aggiuntivo descritto sopra.

Alternativa: Creazione di un plugin locale

Per un maggiore controllo, puoi creare un semplice plugin locale:

  1. Crea la struttura delle cartelle: local/asyntaichatbot/ nella tua installazione Moodle
  2. Crea version.php:
    <?php
    defined('MOODLE_INTERNAL') || die();
    $plugin->component = 'local_asyntaichatbot';
    $plugin->version = 2024010100;
    $plugin->requires = 2022041900;
  3. Crea 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 la cartella amd/src/ e il file 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. Sostituisci YOUR_WIDGET_ID con il tuo ID widget effettivo
  6. Vai su Site administration → Notifications per installare il plugin
  7. Svuota le cache dopo l'installazione

Importante: Il metodo del plugin locale richiede l'accesso alla riga di comando per creare i file. Per la maggior parte degli utenti, il metodo HTML aggiuntivo è più semplice e sufficiente.

Alternativa: Modifica il template del footer del tema

You can also edit your theme's footer template directly:

  1. Naviga nella cartella del tuo tema: theme/YOUR_THEME/
  2. Trova i file layout (ad es., layout/columns2.php o templates/columns2.mustache)
  3. Find the closing </body> tag or the footer section
  4. Add your Asyntai embed code just before </body>
  5. Salva il file
  6. Svuota le cache di Moodle

Importante: La modifica diretta dei file del tema significa che le modifiche potrebbero andare perse durante l'aggiornamento del tema. Utilizza un tema figlio o il metodo HTML aggiuntivo per una soluzione più permanente.

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche e svuotato le cache, visita il tuo sito Moodle in una nuova scheda del browser o in una finestra di navigazione in incognito. Dovresti vedere il pulsante del widget chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di svuotare tutte le cache di Moodle: vai su Site administration → Development → Purge all caches. Prova anche a svuotare la cache del browser o a visualizzare in una finestra di navigazione in incognito. Se utilizzi un plugin di caching o un reverse proxy, svuota anche quelle cache.