Come aggiungere il chatbot IA Asyntai a Moodle
Guida passo passo per i siti web Moodle LMS
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:
- Accedi al tuo sito Moodle come amministratore
- Vai su Site administration
- Naviga su Appearance → Additional HTML
- Scroll down to the "Before BODY is closed" section
- Incolla il codice di incorporamento Asyntai nell'area di testo
- 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:
- Vai su Site administration → Appearance → Themes
- Clicca su Theme settings per il tuo tema attivo (ad es., Boost)
- Cerca la sezione "Raw SCSS", "Additional HTML" o "Custom JavaScript"
- If there's a JavaScript field, paste your Asyntai embed code there
- Clicca su "Save changes"
- 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:
- Crea la struttura delle cartelle:
local/asyntaichatbot/nella tua installazione Moodle - Crea version.php:
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Crea lib.php:
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - 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);
}
};
}); - Sostituisci
YOUR_WIDGET_IDcon il tuo ID widget effettivo - Vai su Site administration → Notifications per installare il plugin
- 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:
- Naviga nella cartella del tuo tema:
theme/YOUR_THEME/ - Trova i file layout (ad es.,
layout/columns2.phpotemplates/columns2.mustache) - Find the closing
</body>tag or the footer section - Add your Asyntai embed code just before
</body> - Salva il file
- 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.
Weebly