Comment ajouter le chatbot IA Asyntai à Moodle
Guide étape par étape pour les sites Moodle LMS
Étape 1 : Obtenir votre code d'intégration
Tout d'abord, rendez-vous sur votre Tableau de bord Asyntai et faites défiler jusqu'à la section « Code d'intégration ». Copiez votre code d'intégration unique qui ressemblera à ceci :
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Note : Le code ci-dessus n'est qu'un exemple. Vous devez copier votre propre code d'intégration depuis votre Tableau de bord car il contient votre identifiant de widget personnel.
Étape 2 : Utiliser le HTML additionnel (recommandé)
Moodle dispose d'une fonctionnalité intégrée pour ajouter du HTML/JavaScript personnalisé à toutes les pages :
- Log in to your Moodle site as an administrator
- Accédez à Administration du site
- Accédez à Appearance → Additional HTML
- Scroll down to the "Before BODY is closed" section
- Collez votre code d'intégration Asyntai dans la zone de texte
- Cliquez sur "Save changes"
Astuce : L'ajout du code dans « Before BODY is closed » le place juste avant la balise fermante </body>, ce qui est l'emplacement recommandé pour les widgets de chat et garantit qu'il se charge après le contenu principal de la page.
Alternative : Utilisation des paramètres du thème
De nombreux thèmes Moodle (y compris Boost et ses variantes) disposent de leurs propres paramètres pour ajouter du JavaScript personnalisé :
- Accédez à Administration du site → Apparence → Thèmes
- Cliquez sur Theme settings pour votre thème actif (par exemple, Boost)
- Recherchez une section « Custom Code », « Footer Scripts » ou « Custom JavaScript »
- If there's a JavaScript field, paste your Asyntai embed code there
- Cliquez sur "Save changes"
- Purgez les caches : Site administration → Development → Purge caches
Note : Les paramètres spécifiques au thème varient d'un thème à l'autre. Si votre thème ne dispose pas d'un champ JavaScript, utilisez la méthode HTML additionnel ci-dessus.
Alternative : Création d'un plugin local
Pour plus de contrôle, vous pouvez créer un plugin local simple :
- Créez l'arborescence de dossiers :
local/asyntaichatbot/dans votre installation Moodle - Créez version.php :
<?php
defined('MOODLE_INTERNAL') || die();
$plugin->component = 'local_asyntaichatbot';
$plugin->version = 2024010100;
$plugin->requires = 2022041900; - Créez lib.php :
<?php
defined('MOODLE_INTERNAL') || die();
function local_asyntaichatbot_before_footer() {
global $PAGE;
$PAGE->requires->js_call_amd('local_asyntaichatbot/loader', 'init');
} - Créez le dossier amd/src/ et le fichier 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);
}
};
}); - Replace
YOUR_WIDGET_IDwith your actual widget ID - Accédez à Administration du site → Notifications pour installer le plugin
- Purgez les caches après l'installation
Important : La méthode par plugin local nécessite un accès en ligne de commande pour créer des fichiers. Pour la plupart des utilisateurs, la méthode HTML additionnel est plus simple et suffisante.
Alternative : Modifier le template de pied de page du thème
You can also edit your theme's footer template directly:
- Accédez au dossier de votre thème :
theme/YOUR_THEME/ - Trouvez les fichiers de mise en page (par exemple,
layout/columns2.phpoutemplates/columns2.mustache) - Find the closing
</body>tag or the footer section - Add your Asyntai embed code just before
</body> - Enregistrez le fichier
- Purgez les caches Moodle
Important : La modification directe des fichiers du thème signifie que les modifications peuvent être perdues lors de la mise à jour de votre thème. Utilisez un thème enfant ou la méthode Additional HTML pour une solution plus pérenne.
Étape 3 : Vérifier l'installation
Après avoir enregistré vos modifications et purgé les caches, visitez votre site Moodle dans un nouvel onglet de navigateur ou en navigation privée. Vous devriez voir le bouton du widget de chat dans le coin inférieur droit. Cliquez dessus pour vérifier qu'il s'ouvre et fonctionne correctement.
Vous ne voyez pas le widget ? Assurez-vous de purger tous les caches Moodle : allez dans Site administration → Development → Purge all caches. Essayez également de vider le cache de votre navigateur ou de consulter le site dans une fenêtre de navigation privée. Si vous utilisez un plugin de cache ou un proxy inverse, videz également ces caches.
Weebly