Chapitre 5 — H5P et le contenu interactif

Jusqu’ici, nous avons construit des cours à partir des briques natives de Moodle : sections, ressources, activités classiques. Ces briques sont robustes, mais elles montrent vite leurs limites dès qu’on veut proposer des interactions riches — une vidéo qui pose des questions en cours de lecture, un scénario à embranchements, un jeu de cartes mémoire, une visite virtuelle à 360 degrés. C’est exactement le territoire de H5P, un écosystème open source de contenus interactifs HTML5 qui s’est imposé comme le standard de fait dans le monde des LMS (Learning Management Systems, plateformes de gestion de l’apprentissage), et que Moodle intègre nativement dans son cœur depuis les versions 3.8 et 3.9.

Ce chapitre est l’un des plus importants de cette partie, pour deux raisons. D’abord parce que H5P est probablement l’outil qui transformera le plus la qualité pédagogique de vos cours pour un effort de création minimal. Ensuite parce que l’histoire de H5P dans Moodle est semée d’un piège classique — la coexistence de deux intégrations distinctes (le plugin historique mod_hvp et l’intégration cœur mod_h5pactivity) — qui a fait perdre des heures à des milliers d’administrateurs et d’enseignants. Nous allons démêler tout cela méthodiquement.

💡 Pour un dev React : pensez à H5P comme à une bibliothèque de composants interactifs packagés et prêts à l’emploi — un peu comme si quelqu’un avait publié sur npm une collection de composants pédagogiques (<InteractiveVideo>, <DragAndDrop>, <BranchingScenario>…) avec un éditeur WYSIWYG pour les configurer sans écrire une ligne de code. Le fichier .h5p que vous manipulerez est l’analogue d’un bundle npm avec ses dépendances vendorées : une archive zip contenant le JSON de contenu (les props), les bibliothèques JavaScript nécessaires (les node_modules), et un manifeste de dépendances (h5p.json ≈ package.json). Une fois cette analogie en tête, tout le fonctionnement de H5P devient limpide.

5.1 Qu’est-ce que H5P ?

5.1.1 Origines et philosophie

H5P signifie HTML5 Package (paquet HTML5). Le projet est né en Norvège au début des années 2010, porté par la société Joubel (aujourd’hui renommée H5P Group), avec un objectif simple : permettre à des enseignants et créateurs de contenus de produire des activités interactives riches sans coder, directement dans le navigateur, et de manière réutilisable entre plateformes.

La philosophie de H5P repose sur quatre piliers :

1. Créer sans coder : chaque « type de contenu » (content type) fournit un formulaire d’édition qui génère le contenu final. L’enseignant remplit des champs, glisse des images, écrit des questions ; H5P assemble le tout en une activité interactive fonctionnelle.
2. Tout dans le navigateur : le contenu H5P s’exécute intégralement côté client, en HTML5/JavaScript. Pas de Flash (H5P est d’ailleurs né en partie de la nécessité de remplacer Flash), pas de plugin navigateur, une compatibilité mobile native.
3. Réutilisable et téléchargeable : par défaut, un contenu H5P peut être téléchargé sous forme de fichier .h5p et réimporté sur n’importe quelle plateforme compatible (Moodle, WordPress, Drupal, h5p.com…). C’est une forme de portabilité que SCORM promettait sans jamais vraiment la tenir avec autant de simplicité.
4. Open source : le cœur de H5P (le H5P core JavaScript/PHP) et la grande majorité des types de contenus officiels sont publiés sous licence libre (licence MIT pour le cœur), avec un écosystème communautaire actif autour de h5p.org .

5.1.2 Anatomie d’un fichier .h5p

Un fichier .h5p est une archive zip renommée. Si vous en renommez un en .zip et l’ouvrez, vous trouverez une structure de ce genre :

mon-contenu.h5p
├── h5p.json                    ← manifeste : titre, type principal, dépendances
├── content/
│   ├── content.json            ← le contenu lui-même (textes, questions, réglages)
│   └── images/, videos/, ...   ← les médias embarqués
├── H5P.InteractiveVideo-1.27/  ← la bibliothèque du type de contenu
│   ├── library.json            ← métadonnées et dépendances de la bibliothèque
│   ├── scripts/  (JS)
│   └── styles/   (CSS)
├── H5P.Question-1.5/           ← dépendances transitives...
├── FontAwesome-4.5/
└── ...

Deux fichiers méritent votre attention :

• h5p.json déclare le type de contenu principal (mainLibrary) et la liste complète des bibliothèques requises avec leurs versions (preloadedDependencies). C’est le manifeste du paquet.
• content/content.json contient les données saisies par l’auteur : le texte des questions, les URL des vidéos, les positions des éléments glissables, etc. C’est un arbre JSON dont le schéma est défini par le semantics.json de la bibliothèque.

💡 Pour un dev React : la correspondance est presque terme à terme. h5p.json ≈ package.json (nom, version, dépendances). Les dossiers H5P.Xxx-1.y/ ≈ des paquets vendorés dans le bundle, avec versionnage sémantique partiel (majeure.mineure dans le nom du dossier, le patch dans library.json). content.json ≈ les props sérialisées passées au composant racine. Et le fichier semantics.json de chaque bibliothèque ≈ un schéma de validation (pensez Zod/JSON Schema) qui définit à la fois la structure des données et le formulaire d’édition généré automatiquement — une forme de schema-driven UI. Quand la plateforme importe un .h5p, elle dédoublonne les bibliothèques déjà installées, exactement comme un gestionnaire de paquets résout un lockfile.

5.1.3 Bibliothèques vs contenus : une distinction fondamentale

H5P distingue strictement :

• Les bibliothèques (libraries) : le code JavaScript/CSS des types de contenus, installé au niveau du site et partagé par tous les contenus. H5P.InteractiveVideo est une bibliothèque.
• Les contenus (contents) : les instances créées par les auteurs (telle vidéo interactive précise, avec telles questions), stockées dans les cours ou la banque de contenus.

Un même site n’installe qu’une fois la bibliothèque « Interactive Video » et peut héberger des milliers de vidéos interactives qui s’appuient dessus. Quand vous importez un fichier .h5p contenant des bibliothèques plus récentes que celles du site, Moodle peut les mettre à jour (selon les permissions) — et tous les contenus existants basés sur ces bibliothèques en profitent (ou en pâtissent, si la mise à jour change des comportements : nous y reviendrons dans la section gouvernance).

5.2 H5P dans Moodle : l’intégration native

5.2.1 Un peu d’histoire : mod_hvp, puis l’intégration cœur

L’histoire de H5P dans Moodle se joue en deux actes, et c’est la source de la confusion la plus fréquente sur le sujet.

Acte 1 — Le plugin tiers mod_hvp (2016 →). Joubel a publié très tôt un plugin d’activité tiers pour Moodle, nommé mod_hvp et affiché dans l’interface sous le libellé « Interactive Content » (Contenu interactif), avec une icône noire caractéristique. Ce plugin, installé manuellement par l’administrateur depuis le répertoire des plugins Moodle, offrait une intégration complète : éditeur H5P embarqué, connexion au hub de contenus h5p.org, remontée de notes vers le carnet de notes, émission de déclarations xAPI. Pendant des années, c’était la seule façon d’avoir H5P dans Moodle, et d’innombrables établissements ont bâti leurs contenus dessus.

Acte 2 — L’intégration au cœur de Moodle (3.8 → 3.9, 2019-2020). Moodle HQ a ensuite intégré H5P nativement dans le cœur du produit, en deux temps :

• Moodle 3.8 (novembre 2019) : introduction du framework H5P dans le cœur, avec la possibilité d’afficher des contenus H5P n’importe où via l’éditeur de texte (le filtre d’affichage H5P) et le lecteur H5P intégré.
• Moodle 3.9 (juin 2020) : arrivée de l’activité H5P (mod_h5pactivity), de la banque de contenus (content bank) et de l’éditeur H5P intégré au cœur, permettant de créer et modifier des contenus H5P directement dans Moodle sans aucun plugin tiers.

Depuis Moodle 3.9, et donc a fortiori dans Moodle 5.2, tout ce dont vous avez besoin pour H5P est déjà dans le cœur. Le plugin mod_hvp continue d’exister pour des raisons historiques, mais H5P Group et Moodle HQ recommandent depuis longtemps de ne plus démarrer de nouveaux projets avec lui.

⚠️ Piège : LA confusion classique. Sur un site où mod_hvp est (encore) installé, le sélecteur d’activités affiche deux entrées qui parlent toutes deux de H5P : « H5P » (icône bleue, mod_h5pactivity, l’intégration cœur) et « Interactive Content » / « Contenu interactif » (icône noire, mod_hvp, le plugin tiers historique). Ce sont deux modules totalement distincts : bibliothèques installées séparément (deux jeux de bibliothèques H5P sur le même site !), contenus stockés séparément, réglages d’administration séparés (Administration du site → Plugins → Contenu interactif pour hvp, Administration du site → H5P pour le cœur), et aucune synchronisation entre les deux. Un contenu créé dans l’un n’apparaît pas dans l’autre. Quand un enseignant vous dit « mon H5P ne marche pas », votre premier réflexe doit être d’identifier lequel des deux modules est en cause. Sur une installation neuve de Moodle 5.2 sans plugin tiers, seule l’entrée « H5P » bleue existe — et c’est très bien ainsi.

5.2.2 L’activité H5P (mod_h5pactivity)

L’activité H5P est le moyen canonique d’ajouter un contenu H5P noté et suivi dans un cours. Pour l’ajouter : mode édition activé, « Ajouter une activité ou ressource », choisir H5P.

Le formulaire de réglages comporte les sections suivantes :

Généraux :

• Nom et description classiques.
• Fichier de paquetage (Package file) : le champ central. Vous pouvez soit déposer un fichier .h5p (glisser-déposer ou sélecteur de fichiers), soit — et c’est la bonne pratique — choisir un contenu depuis la banque de contenus via le sélecteur de fichiers (dépôt « Banque de contenus » / Content bank). Le sélecteur propose alors deux modes : faire une copie du contenu (l’activité devient indépendante) ou créer un alias/raccourci (link to the file) vers le contenu de la banque — dans ce second cas, toute mise à jour du contenu dans la banque se répercute automatiquement dans l’activité. Cette distinction copie/alias reprend le mécanisme général des dépôts de fichiers Moodle vu dans les chapitres précédents.

Options H5P :

• Autoriser le téléchargement : affiche (ou non) le bouton permettant aux participants de télécharger le .h5p. À désactiver si vous ne voulez pas que vos contenus circulent.
• Bouton Embed (intégrer) : affiche le code d’intégration iframe.
• Bouton Copyright : affiche les informations de licence du contenu.

Tentatives (Attempt options) :

• Activer le suivi des tentatives (Enable attempt tracking) : indispensable pour la notation et les rapports.
• Méthode de notation (Grading method) : meilleure tentative, moyenne des tentatives, première tentative, dernière tentative, ou « ne pas calculer de note » (les tentatives sont alors tracées mais sans note). Nous détaillons cela en section 5.9.

Note : réglages standard de notation Moodle (note maximale, catégorie du carnet de notes, note pour passer).

Plus les sections communes habituelles : réglages courants, restrictions d’accès, achèvement d’activité, tags, compétences.

5.2.3 Le filtre d’affichage H5P : du H5P partout

L’activité H5P n’est pas le seul point d’entrée. Moodle 3.8+ fournit un filtre d’affichage H5P (Display H5P filter, activé par défaut) qui permet d’intégrer un contenu H5P dans n’importe quelle zone de texte riche : description de section, page, étiquette, énoncé de devoir, question de test, message de forum…

Deux façons de l’utiliser :

1. Le bouton H5P de l’éditeur : l’éditeur TinyMCE de Moodle 4/5 (comme l’ancien Atto) propose un bouton « Insérer H5P » qui ouvre un dialogue où vous pouvez coller une URL de contenu H5P, sélectionner un fichier .h5p (y compris depuis la banque de contenus), et régler les options d’affichage (téléchargement, embed, copyright).
2. Une simple URL : coller dans le texte un lien vers un fichier .h5p hébergé sur le site (ou une URL h5p.org) ; le filtre le détecte au rendu et remplace le lien par le lecteur H5P.

La différence capitale avec l’activité H5P : un contenu affiché via le filtre n’est pas noté et ne génère pas de rapport de tentatives. C’est de l’enrichissement de contenu, pas de l’évaluation. Utilisez le filtre pour l’entraînement informel et l’illustration ; utilisez mod_h5pactivity dès qu’une note ou un suivi est attendu.

💡 Pour un dev React : le lecteur H5P de Moodle rend chaque contenu dans une iframe sandboxée servie par h5p/embed.php. C’est le même raisonnement d’isolation que lorsque vous embarquez un widget tiers : le JavaScript du contenu H5P (potentiellement uploadé par un enseignant) s’exécute dans un contexte cadré plutôt que dans le DOM principal de la page Moodle, ce qui limite la surface XSS et les collisions CSS. La communication contenu → plateforme (résultats, redimensionnement) passe par des mécanismes de type postMessage et par l’API xAPI embarquée — l’analogue d’un event bus entre l’iframe et son hôte. Notez d’ailleurs que Moodle contrôle qui a le droit de déposer des .h5p avec des capacités dédiées, précisément parce qu’un paquet H5P contient du JavaScript exécutable.

5.2.4 mod_hvp vs mod_h5pactivity : le tableau comparatif

Formulons la recommandation sans ambiguïté : en 2026, sur Moodle 5.2, ne démarrez aucun nouveau projet sur mod_hvp. Le plugin reste installé sur beaucoup de sites pour des raisons de legacy, mais toute création nouvelle doit passer par le cœur (mod_h5pactivity + banque de contenus).

5.2.5 Migrer de mod_hvp vers le cœur

Pour les sites historiques, Moodle HQ fournit un outil de migration officiel : le plugin d’administration tool_migratehvp2h5p (« Migrate content from mod_hvp to mod_h5pactivity », disponible dans le répertoire des plugins Moodle). Une fois installé, il apparaît dans l’administration du site et permet de :

• lister les activités mod_hvp existantes ;
• les convertir en activités mod_h5pactivity, en transférant le contenu, et selon les options les notes et tentatives ;
• choisir le sort de l’activité d’origine (suppression, masquage, conservation).

Points de vigilance avant une migration en masse :

• Testez sur un environnement de préproduction avec un échantillon représentatif de types de contenus.
• Certains types installés côté hvp peuvent nécessiter que les bibliothèques équivalentes soient installées côté cœur ; vérifiez la liste des types dans Administration du site → H5P → Gérer les types de contenus H5P avant migration.
• Les comportements fins (affichage, historique de tentatives) peuvent différer légèrement ; prévenez les équipes enseignantes.
• Comme toujours : sauvegarde complète avant.

📚 Aller plus loin : la page « H5P » de la documentation officielle francophone (docs.moodle.org/fr/H5P ) détaille l’intégration cœur et ses différences avec le plugin hvp, et la fiche du plugin tool_migratehvp2h5p sur moodle.org/plugins  documente la procédure de migration pas à pas.

5.3 La banque de contenus (content bank)

5.3.1 Principe et contextes

Introduite en Moodle 3.9, la banque de contenus (content bank) est un espace de stockage et de création de contenus — aujourd’hui essentiellement des contenus H5P — attaché à un contexte Moodle : un cours, une catégorie de cours, ou le site entier. On y accède depuis le menu du cours (onglet ou lien « Banque de contenus » selon le thème) ou via l’URL /contentbank/index.php?contextid=....

Cette organisation par contexte suit la logique hiérarchique des permissions Moodle vue en Partie 2 :

• Banque d’un cours : contenus visibles et utilisables dans ce cours (par ses enseignants).
• Banque d’une catégorie : contenus partagés par tous les cours de la catégorie — idéal pour une équipe pédagogique ou un département.
• Banque du site : contenus partagés par tout l’établissement (chartes, tutoriels transverses…).

Un contenu placé dans un contexte parent est réutilisable dans les contextes enfants via le sélecteur de fichiers : lorsqu’un enseignant configure une activité H5P et ouvre le dépôt « Banque de contenus », il voit les contenus de son cours et ceux des contextes supérieurs auxquels il a accès.

5.3.2 Créer et éditer du H5P directement dans Moodle

C’est la grande avancée de 3.9, pleinement mature dans Moodle 5.2 : la banque de contenus embarque l’éditeur H5P officiel. Le bouton « Ajouter » de la banque déroule la liste des types de contenus H5P installés sur le site (Interactive Video, Course Presentation, Drag and Drop…). Vous choisissez un type, l’éditeur s’ouvre, vous créez votre contenu dans Moodle, sans passer par un outil externe ni manipuler de fichier .h5p.

L’éditeur H5P est le même que sur h5p.org ou h5p.com : formulaires générés depuis le semantics.json de chaque type, prévisualisation, gestion des médias. La courbe d’apprentissage dépend du type (Fill in the Blanks se maîtrise en cinq minutes ; Branching Scenario ou Interactive Video demandent une petite heure de prise en main).

5.3.3 Upload, remplacement, versions, renommage

Les autres opérations disponibles dans la banque :

• Téléverser (Upload) : importer un fichier .h5p existant (créé avec Lumi, exporté d’un autre Moodle, téléchargé depuis h5p.org…). Si le paquet contient des bibliothèques inconnues du site, leur installation dépend de vos permissions (les gestionnaires/administrateurs peuvent déployer de nouvelles bibliothèques, pas les enseignants ordinaires par défaut).
• Remplacer par un fichier : écraser le contenu par un nouveau .h5p en conservant le même identifiant — toutes les activités qui pointent vers ce contenu par alias affichent alors la nouvelle version. C’est votre mécanisme de « déploiement » de mise à jour de contenu.
• Renommer, télécharger (export .h5p), supprimer.

⚠️ Piège : la distinction copie vs alias au moment où vous insérez un contenu de la banque dans une activité est lourde de conséquences. Si vous avez choisi « faire une copie », modifier ensuite le contenu dans la banque ne changera rien dans l’activité (et inversement, éditer via l’activité ne touche pas la banque). Si vous avez créé un alias, la modification dans la banque se propage — y compris une modification malencontreuse. Beaucoup de tickets de support « j’ai corrigé mon H5P mais les étudiants voient toujours l’ancienne version » se résument à une copie là où l’auteur croyait avoir un alias. Prenez l’habitude de décider explicitement, et documentez la convention de votre équipe (règle saine : alias pour les contenus mutualisés en catégorie, copie pour les adaptations locales).

5.3.4 Permissions et visibilité

La banque de contenus est gouvernée par des capacités dédiées (préfixe moodle/contentbank:) : accéder à la banque, téléverser du contenu, créer du contenu, gérer ses propres contenus, gérer les contenus de n’importe qui, télécharger, copier. Par défaut, les enseignants (rôle editingteacher) peuvent créer et gérer des contenus dans leurs cours ; les gestionnaires le peuvent au niveau catégorie et site.

Chaque contenu possède en outre une visibilité : publié (public) — visible par tous les utilisateurs autorisés du contexte — ou non listé (unlisted) — visible uniquement par son auteur et les utilisateurs disposant de la capacité de gestion étendue. Le mode non listé sert de brouillon : vous préparez un contenu tranquillement, puis vous le publiez quand il est prêt.

💡 Pour un dev React : la banque de contenus joue le rôle d’un registre de paquets interne (pensez registre npm privé ou monorepo de composants partagés) : les contenus y sont versionnés implicitement par remplacement, consommés par référence (alias ≈ dépendance symlinkée en workspace, mise à jour instantanée) ou par copie (≈ fork/vendoring, isolation totale), avec un contrôle d’accès par périmètre (contexte cours/catégorie/site ≈ scopes d’un registre). Le couple publié/non listé correspond à un flag de publication latest vs une pre-release visible des seuls mainteneurs.

5.4 Gérer les types de contenus (bibliothèques H5P)

5.4.1 L’écran d’administration

La gestion des bibliothèques se fait dans Administration du site → H5P → Gérer les types de contenus H5P (Manage H5P content types). Cet écran liste toutes les bibliothèques installées avec leur version, le nombre de contenus qui les utilisent, et leur statut d’activation.

Trois façons d’installer ou mettre à jour des types :

1. Depuis le hub de contenus H5P : l’onglet dédié affiche le catalogue officiel de h5p.org  ; un clic installe le type et ses dépendances. Le site doit pouvoir joindre le hub (vérifiez proxy/pare-feu sur les infrastructures verrouillées).
2. Téléverser un fichier .h5p contenant les bibliothèques voulues (utile hors ligne : téléchargez un contenu d’exemple du type visé sur h5p.org, uploadez-le, les bibliothèques s’installent).
3. Implicitement, lorsqu’un utilisateur disposant de la capacité idoine dépose un .h5p embarquant des bibliothèques nouvelles ou plus récentes.

Moodle livre également, selon les versions, un petit lot de types de contenus pré-empaquetés, mais le catalogue complet passe par le hub.

5.4.2 Mettre à jour les bibliothèques

Quand H5P Group publie une nouvelle version d’un type (corrections, accessibilité, fonctionnalités), l’écran d’administration signale les mises à jour disponibles depuis le hub. Points d’attention :

• La mise à jour d’une bibliothèque affecte tous les contenus du site qui l’utilisent (rappel : bibliothèques mutualisées). Testez sur un contenu représentatif après mise à jour.
• Les versions majeures d’une bibliothèque coexistent (le dossier porte majeure.mineure) : un vieux contenu peut continuer à référencer H5P.CoursePresentation-1.24 pendant que les nouveaux utilisent la 1.25 ; l’éditeur propose la migration de version au moment de l’édition du contenu.
• Sur mod_hvp, la gestion des bibliothèques est séparée (dans les réglages du plugin) — encore un endroit où les deux mondes ne se parlent pas.

5.4.3 Verrouiller les types disponibles pour les enseignants

L’administrateur peut activer/désactiver chaque type de contenu dans l’écran de gestion. Un type désactivé n’apparaît plus dans le bouton « Ajouter » de la banque de contenus. Pourquoi verrouiller ?

• Cohérence pédagogique : proposer une liste courte de types maîtrisés et documentés en interne plutôt que les dizaines du catalogue.
• Accessibilité : exclure les types notoirement peu accessibles si votre établissement a des obligations (RGAA en France, EN 301 549 en Europe).
• Maintenance : moins de types = moins de surface de test à chaque mise à jour.

Par ailleurs, seuls les rôles disposant des capacités adéquates peuvent déployer de nouvelles bibliothèques via upload ; un enseignant qui téléverse un .h5p exigeant une bibliothèque absente du site verra le déploiement refusé — comportement voulu, qui centralise la gouvernance des bibliothèques chez l’administrateur.

5.5 Les types H5P populaires, un par un

Le catalogue h5p.org compte plus d’une cinquantaine de types. Voici les plus utilisés en formation, avec leurs cas d’usage. Le tableau donne la vue d’ensemble ; les descriptions détaillent les vedettes.

5.5.1 Interactive Video : la star

L’Interactive Video (vidéo interactive) est sans doute le type H5P le plus emblématique. À partir d’une vidéo (fichier MP4 déposé, ou URL YouTube/Vimeo), vous incrustez sur la ligne de temps :

• des questions (QCM, vrai/faux, texte à trous, glisser-déposer…) qui apparaissent à des instants choisis, avec option de pause obligatoire et même de blocage de la navigation tant que la réponse n’est pas correcte ;
• des étiquettes, textes, images, liens et signets (bookmarks) qui structurent la vidéo en chapitres navigables ;
• des sauts (crossroads/adaptivity) : selon la réponse, renvoyer l’apprenant à un passage de la vidéo — de quoi construire des micro-embranchements ;
• un écran de synthèse (summary) en fin de vidéo.

Cas d’usage typiques : transformer un cours magistral filmé en séquence active (une question toutes les 3-4 minutes maintient l’attention), créer des démonstrations logicielles auto-vérifiées, découper une conférence en chapitres. C’est l’antidote au visionnage passif.

Limite honnête : avec une source YouTube, vous dépendez du lecteur YouTube (publicités selon les comptes, suggestions, disponibilité) ; pour un contrôle total, hébergez le MP4 dans Moodle ou sur un serveur de streaming interne.

5.5.2 Course Presentation : le diaporama interactif

Course Presentation est un éditeur de diapositives dans le navigateur : textes, images, vidéos, audio, formes… et surtout la possibilité d’insérer des questions sur n’importe quelle diapositive. Le score cumulé de toutes les questions remonte comme note. Usage : remplacer un PDF de slides par une version où l’apprenant est régulièrement sollicité ; construire des modules courts d’auto-formation. Attention à ne pas reconstruire PowerPoint : l’éditeur est correct mais moins confortable qu’un vrai outil de présentation ; privilégiez des visuels simples.

5.5.3 Branching Scenario : l’alternative moderne à l’activité Leçon

Le Branching Scenario (scénario à embranchements) permet de construire un parcours arborescent : à chaque étape, l’apprenant consulte un contenu (texte, vidéo, présentation…) puis fait un choix qui détermine la suite. On peut attribuer des scores aux branches et définir plusieurs fins.

C’est l’outil roi pour : études de cas cliniques (« que faites-vous ensuite ? »), simulations d’entretien ou de gestion de conflit, formations à la décision (sécurité, éthique, procédure). Si vous avez lu le chapitre sur l’activité Leçon (Lesson) de Moodle, vous avez noté que son interface de création, héritée d’un autre âge, est laborieuse : le Branching Scenario offre l’essentiel de la même valeur pédagogique avec un éditeur visuel en arbre bien plus agréable. Réserve : l’activité Leçon garde l’avantage pour certains besoins fins (notation détaillée par page, intégration profonde aux rapports Moodle), mais pour la majorité des scénarios pédagogiques, H5P a pris le relais.

5.5.4 Interactive Book, Question Set, et les types de questions

L’Interactive Book (livre interactif) agrège plusieurs pages/chapitres pouvant chacun contenir d’autres types H5P (texte, vidéo interactive, quiz…), avec sommaire et score global cumulant les chapitres. C’est le format idéal pour un module d’auto-formation complet de 20 à 45 minutes.

Le Question Set (série de questions, souvent appelé « Quiz (Question Set) ») enchaîne des questions de types variés avec pourcentage de réussite, feedback global et vidéo de fin optionnelle. Ne le confondez pas avec l’activité Test (Quiz) de Moodle : le Question Set H5P est léger et rapide à créer, mais il n’offre ni banque de questions, ni tirage aléatoire avancé, ni protections anti-triche, ni les dizaines de réglages du Test Moodle. Règle pratique : Question Set pour l’entraînement formatif, activité Test Moodle pour l’évaluation qui compte.

Autour d’eux gravitent les types de questions unitaires, tous simples et efficaces : Fill in the Blanks (texte à trous, redoutable en langues et en vocabulaire technique), Drag the Words et Drag and Drop (association, catégorisation, légendage de schémas — pensez schéma anatomique ou architecture logicielle à légender), Multiple Choice, True/False, Mark the Words, Summary.

5.5.5 Cartes, jeux et découverte

• Dialog Cards : cartes recto (question/mot) verso (réponse/définition), l’apprenant s’auto-évalue (« je savais / je ne savais pas »). Pas de score : c’est de la répétition espacée artisanale. Flashcards, proche, demande une saisie de réponse et renvoie un score.
• Memory Game : jeu de paires d’images. Ludique, parfait en maternelle… comme en onboarding d’entreprise (associer logos et noms de services).
• Crossword et Find the Words : mots croisés et mots mêlés générés à partir de vos listes — révision de vocabulaire sans effort de création.
• Image Hotspots : une image avec des points cliquables ouvrant textes/vidéos — idéal pour explorer un schéma, une carte, une interface logicielle annotée. Sa variante évaluée, Find the Hotspot, demande de cliquer la bonne zone.
• Timeline : frise chronologique interactive (histoire, histoire des sciences, jalons d’un projet).
• Accordion : simples panneaux dépliants pour FAQ et synthèses — zéro interactivité pédagogique, mais une mise en forme propre.
• Agamotto : une série d’images que l’on fait défiler avec un curseur — parfait pour montrer une évolution (avant/après, étapes d’une dissection, couches d’une architecture).
• Virtual Tour (360) : visites virtuelles à partir de photos équirectangulaires, avec points d’intérêt et questions incrustées — visite de laboratoire, de chantier, de site patrimonial. Prévoyez du temps de production (les photos 360° de qualité ne s’improvisent pas).
• Documentation Tool : guide l’apprenant dans la rédaction structurée d’un document (objectifs, étapes, auto-évaluation) avec export du résultat — utile en gestion de projet ou en portfolio. Attention : l’export est côté client, le texte rédigé n’est pas sauvegardé dans Moodle par défaut.

5.5.6 Conseils de choix

1. Partez de l’intention pédagogique, pas du gadget : mémoriser → Dialog Cards/Flashcards ; comprendre une vidéo → Interactive Video ; décider en situation → Branching Scenario ; s’auto-tester → Question Set ; explorer → Image Hotspots/Virtual Tour.
2. Limitez la palette : trois à cinq types bien maîtrisés par équipe valent mieux que vingt types découverts au fil de l’eau. La cohérence réduit la charge cognitive des apprenants.
3. Vérifiez l’accessibilité du type choisi avant de généraliser (voir section 5.7).
4. Testez sur mobile : la plupart des types sont responsives, mais les Drag and Drop denses ou les Virtual Tours restent pénibles sur petit écran.

📚 Aller plus loin : chaque type dispose d’une page d’exemples et de tutoriels sur h5p.org/content-types-and-applications . Testez-y les démos avant d’installer un type sur votre site : c’est le moyen le plus rapide de juger de sa pertinence.

5.6 Créer du H5P en dehors de Moodle

L’éditeur intégré à la banque de contenus couvre la plupart des besoins, mais trois alternatives méritent d’être connues.

5.6.1 Lumi : l’éditeur H5P de bureau

Lumi (lumi.education ) est une application de bureau gratuite (Windows/macOS/Linux, avec aussi une offre en ligne) qui embarque l’éditeur H5P. Intérêts :

• Créer hors ligne, sans accès à un LMS — précieux pour les formateurs itinérants ou les phases de conception.
• Exporter en .h5p (à téléverser ensuite dans la banque de contenus Moodle) ou en fichier HTML autonome : un unique fichier .html contenant tout le contenu, lisible dans n’importe quel navigateur — parfait pour diffuser un contenu interactif par mail, clé USB, ou sur un simple site statique, sans aucun LMS.
• Prototyper et itérer vite, puis importer la version finale dans Moodle.

Limite : un contenu exporté en HTML autonome ne remonte évidemment aucun score nulle part ; et un .h5p créé dans Lumi devra trouver dans Moodle des bibliothèques compatibles (mêmes réflexes de gestion de versions qu’en section 5.4).

5.6.2 h5p.com : l’offre SaaS

h5p.com est l’offre commerciale hébergée de H5P Group : création, hébergement et diffusion de contenus H5P en SaaS, avec intégration aux LMS via LTI (Learning Tools Interoperability, le standard d’interconnexion des outils pédagogiques que nous verrons en Partie 7). C’est ce modèle payant qui finance le développement du H5P open source. h5p.com propose généralement les nouveautés en avant-première, des fonctions d’organisation avancées et un support professionnel. Pour un établissement déjà équipé de Moodle, l’intégration cœur gratuite suffit dans l’immense majorité des cas ; h5p.com se justifie pour des organisations multi-plateformes ou souhaitant externaliser l’hébergement des contenus interactifs. À noter : le site communautaire h5p.org n’est pas fait pour héberger des contenus de production (c’est une vitrine de test), c’est h5p.com qui joue ce rôle.

5.6.3 WordPress, Drupal et les autres

H5P fournit des plugins officiels pour WordPress et Drupal — historiquement, Drupal fut même la première plateforme hôte du projet. Un .h5p créé sur un site WordPress s’importe tel quel dans la banque de contenus Moodle, et réciproquement : c’est toute la promesse de portabilité du format. Dans un écosystème d’établissement où coexistent un site vitrine WordPress et un Moodle, les contenus interactifs peuvent ainsi circuler librement.

5.7 Limites, licences et gouvernance : les vérités qui fâchent

H5P est excellent, mais un expert se reconnaît à sa connaissance des limites. Passons-les honnêtement en revue.

5.7.1 Modèle économique et licences

Le cœur H5P (framework JS/PHP) est open source sous licence permissive (MIT), et les types de contenus officiels sont publiés sous licences libres. H5P Group vit de h5p.com ; le développement open source suit donc les priorités d’un éditeur commercial. Conséquences concrètes observées ces dernières années :

• certaines nouveautés arrivent d’abord (ou seulement) sur h5p.com ;
• le plugin mod_hvp pour Moodle est gelé : H5P Group a annoncé ne plus le faire évoluer activement et renvoie vers l’intégration cœur de Moodle (et vers h5p.com via LTI pour les fonctionnalités premium). Ne bâtissez rien de nouveau sur mod_hvp ; planifiez la migration de l’existant.

Côté contenus, l’éditeur H5P permet de renseigner les métadonnées de licence (titre, auteur, licence Creative Commons…) pour chaque média et chaque contenu — prenez l’habitude de les remplir : c’est ce qui s’affiche derrière le bouton Copyright et ce qui rend vos contenus réellement réutilisables en droit et pas seulement en technique.

5.7.2 Accessibilité : variable selon les types

L’accessibilité (navigation clavier, lecteurs d’écran, contrastes) est inégale d’un type à l’autre. H5P Group maintient une page de statut d’accessibilité par type de contenu sur h5p.org, régulièrement mise à jour ; référez-vous-y plutôt qu’à toute liste figée. À titre indicatif au moment de la rédaction :

Si votre établissement est soumis au RGAA (Référentiel Général d’Amélioration de l’Accessibilité), auditez chaque type avant de l’autoriser (section 5.4.3) et prévoyez systématiquement une alternative équivalente aux contenus non accessibles.

5.7.3 Le suivi et la triche : H5P n’est pas un outil d’examen

Deux limites structurelles à graver dans le marbre :

1. Suivi moins fin que SCORM sur certains points : H5P émet des déclarations xAPI riches, mais tous les types ne rapportent pas la même granularité, certains ne renvoient aucun score (Dialog Cards, Image Hotspots, Timeline, Accordion…), et vous n’avez pas l’équivalent systématique du modèle CMI de SCORM (temps passé normalisé, statut de complétion standardisé par le contenu, suspend data pour reprendre au milieu). Vérifiez type par type ce qui remonte réellement (section 5.9).
2. Tout s’exécute côté client : la logique de correction et le calcul du score ont lieu dans le navigateur de l’apprenant, avant envoi du résultat au serveur. Un utilisateur techniquement averti peut inspecter le JavaScript, lire les réponses dans content.json (téléchargeable si vous avez laissé le bouton actif !), ou forger des résultats. Conclusion sans appel : H5P est un outil d’apprentissage formatif, pas un outil d’évaluation sommative sécurisée. Pour une note qui compte, utilisez l’activité Test de Moodle (correction côté serveur), éventuellement nourrie par l’entraînement H5P en amont.

⚠️ Piège : ne mettez jamais un coefficient significatif sur une note issue de H5P dans un contexte à enjeu (examen, certification). Outre la falsifiabilité côté client, le bouton de téléchargement du .h5p — s’il est resté activé dans les options de l’activité — donne littéralement accès au corrigé (les bonnes réponses sont en clair dans content/content.json). Désactivez « Autoriser le téléchargement » au minimum, et réservez la notation H5P au formatif.

💡 Pour un dev React : c’est exactement le principe « never trust the client » que vous appliquez à toute app front. Un score H5P, c’est comme un état calculé dans le navigateur puis POSTé à votre API sans validation serveur : n’importe quel utilisateur peut ouvrir les DevTools et appeler l’API lui-même. L’activité Test de Moodle, elle, garde la logique de correction côté serveur — l’équivalent d’une validation dans votre route handler. Choisissez l’outil selon le modèle de menace.

5.7.4 Poids et performance

Chaque type de contenu embarque ses bibliothèques JS/CSS ; une page contenant plusieurs contenus H5P lourds (Interactive Video + Course Presentation + jeux) charge plusieurs iframes avec leurs assets. Les bibliothèques sont mutualisées et mises en cache côté site, mais restez raisonnable : un contenu H5P majeur par page, des médias compressés (la vidéo dans un service de streaming plutôt qu’en MP4 de 500 Mo dans le .h5p — le paquet embarquant ses médias, les fichiers .h5p peuvent devenir énormes et peser sur les sauvegardes de cours).

5.8 SCORM vs H5P vs xAPI : le comparatif

Ces trois noms reviennent sans cesse dans les discussions e-learning, souvent mélangés à tort : SCORM et xAPI sont des standards de communication, H5P est un format/écosystème de contenu. Ils ne jouent pas dans la même catégorie mais se recoupent en pratique.

Ce que Moodle sait faire de xAPI — point précis et souvent mal compris :

• mod_h5pactivity reçoit les déclarations xAPI (xAPI statements) émises par le contenu H5P (« l’utilisateur X a répondu à l’interaction Y avec le résultat Z »), les traite en interne et les stocke dans ses tables de tentatives — c’est ce qui alimente les rapports détaillés par interaction et le calcul de note. Un point de terminaison xAPI générique existe dans le cœur (le sous-système core_xapi, utilisé par H5P).
• En revanche, Moodle n’embarque pas de LRS (Learning Record Store, entrepôt de déclarations xAPI) : les déclarations ne sont pas conservées au format xAPI interrogeable ni exposées à des outils d’analytique externes par défaut.
• Pour cela, on installe un plugin de type Logstore xAPI (logstore_xapi), qui traduit les événements du journal Moodle en déclarations xAPI et les pousse vers un LRS externe — historiquement Learning Locker, aujourd’hui aussi des LRS modernes comme Ralph (LRS open source en Python soutenu par la communauté française OpenFUN) ou des offres commerciales. C’est l’architecture standard pour faire des learning analytics sérieux multi-sources.
• cmi5 en deux mots : cmi5 est un « profil » qui marie le meilleur des deux mondes — l’empaquetage et le lancement à la SCORM, avec le vocabulaire et le transport xAPI vers un LRS. C’est le successeur désigné de SCORM. Moodle ne le prend pas en charge nativement dans le cœur en 5.2 (des travaux et plugins existent) ; si un client vous parle de cmi5, sachez situer le sujet sans promettre un support natif.

💡 Pour un dev React : xAPI, c’est du event tracking/analytics pour l’apprentissage — pensez Segment/Amplitude/PostHog. Une déclaration xAPI est un événement JSON structuré {actor, verb, object, result, context} (« Alice - answered - question 3 - correct »), le LRS est votre entrepôt d’événements, et Logstore xAPI joue le rôle du SDK d’instrumentation qui expédie les événements du produit (Moodle) vers l’entrepôt. SCORM, en comparaison, ressemble à une vieille API propriétaire couplée au client : elle ne fonctionne que dans la page du LMS, avec un vocabulaire fermé. Et cmi5 serait la v2 qui migre l’ancienne API vers le pipeline d’événements moderne.

📚 Aller plus loin : la documentation développeur de Moodle décrit le sous-système xAPI du cœur et l’API H5P sur moodledev.io  (rubriques « xAPI » et « H5P »), utile le jour où vous écrirez un plugin consommant ces déclarations.

5.9 Notes, tentatives et achèvement

5.9.1 Comment mod_h5pactivity calcule la note

Lorsque le suivi des tentatives est activé, chaque « passage » de l’apprenant sur le contenu génère une tentative (attempt) contenant le score renvoyé par le contenu H5P (via ses déclarations xAPI, sous forme score obtenu / score max). Le réglage Méthode de notation (Grading method) détermine ce qui remonte au carnet de notes :

La note est ensuite mise à l’échelle de la note maximale définie dans la section Note (le score H5P 12/15 devient 16/20 si la note max est 20).

5.9.2 Quels types renvoient un score ?

Rappel opérationnel du tableau de la section 5.5 : les types évaluatifs (Question Set, Interactive Video, Course Presentation, Fill in the Blanks, Drag and Drop, Crossword, Interactive Book…) renvoient un score exploitable. Les types informatifs ou d’auto-évaluation (Dialog Cards, Image Hotspots, Timeline, Accordion, Agamotto, la plupart des jeux « libres ») n’en renvoient pas — une activité H5P bâtie dessus affichera des tentatives sans score, ou pas de donnée du tout selon le type. Nuance utile : dans une Course Presentation ou une Interactive Video sans aucune question, le score max est nul, et la notation n’a pas de sens ; vérifiez toujours en prévisualisation qu’un score cohérent est produit avant de brancher le carnet de notes.

5.9.3 Les rapports de tentatives

L’onglet Tentatives (accessible aux enseignants depuis l’activité) offre trois niveaux de lecture :

1. Vue par participants : liste des apprenants avec nombre de tentatives et note retenue.
2. Vue des tentatives d’un participant : chaque tentative avec score, date, durée.
3. Détail d’une tentative : la liste des interactions individuelles (chaque question, chaque geste évalué) avec la réponse donnée, la bonne réponse et le résultat — reconstruite à partir des déclarations xAPI stockées. C’est précieux pour repérer LA question que toute la cohorte rate.

La granularité du détail dépend du type de contenu (tous n’émettent pas des déclarations aussi riches) — encore une raison de tester votre type fétiche de bout en bout avant de généraliser.

5.9.4 Achèvement d’activité

L’activité H5P se branche sur le système d’achèvement d’activité (activity completion) standard vu au chapitre sur le suivi : achèvement manuel, ou automatique sur conditions — affichage de l’activité, obtention d’une note, et note pour passer (passing grade, définie dans la section Note), qui permet des conditions du type « a atteint la note de passage ». Combiné aux restrictions d’accès, cela donne des parcours conditionnels : « la section 3 s’ouvre quand la vidéo interactive de la section 2 est réussie à 70 % ». Gardez en tête la réserve de la section 5.7.3 : ce verrouillage est un guidage pédagogique, pas une barrière de sécurité.

5.10 Recette de bout en bout : une vidéo interactive notée

Mettons tout en pratique. Objectif : créer une vidéo interactive dans la banque de contenus, la proposer comme activité notée, et vérifier la remontée de note. Comptez 45 à 60 minutes la première fois.

Étape 1 — Vérifier le type de contenu (administrateur, une seule fois)

1. Administration du site → H5P → Gérer les types de contenus H5P.
2. Vérifiez que Interactive Video est installé et activé ; sinon, onglet du hub de contenus H5P, recherchez « Interactive Video », Installer.

Étape 2 — Créer le contenu dans la banque de contenus (enseignant)

1. Ouvrez votre cours, puis la Banque de contenus (menu du cours).
2. Ajouter → Interactive Video. L’éditeur H5P s’ouvre.
3. Onglet Upload/Embed Video : déposez votre MP4 ou collez une URL YouTube. Ajoutez un titre parlant (il nommera le contenu dans la banque).
4. Onglet Add interactions : placez la tête de lecture à ~25 % de la vidéo, cliquez l’outil Single Choice Set ou Multiple Choice, rédigez une question portant sur ce qui vient d’être vu. Dans les options de l’interaction, activez la pause à l’apparition. Répétez pour 2 à 4 questions réparties dans la vidéo.
5. Ajoutez un ou deux signets (bookmarks) aux changements de thème pour créer des chapitres.
6. Onglet Summary task (facultatif) : une tâche de synthèse de fin de vidéo.
7. Dans les Behavioural settings, décidez si l’apprenant peut sauter en avant (prevent skipping pour un premier visionnage guidé — à utiliser avec parcimonie, c’est frustrant en révision).
8. Enregistrer. Le contenu apparaît dans la banque ; laissez-le non listé le temps des tests, puis passez-le en publié.

Étape 3 — Créer l’activité notée

1. Dans le cours, mode édition, Ajouter une activité ou ressource → H5P.
2. Nommez l’activité (par exemple « Vidéo : les bases de HTTP — quiz intégré »).
3. Champ Fichier de paquetage : ouvrez le sélecteur de fichiers, dépôt Banque de contenus, choisissez votre vidéo. Sélectionnez « Lier au fichier » (alias) si vous comptez encore la retoucher, « Copier le fichier » pour figer une version.
4. Options H5P : décochez Autoriser le téléchargement (les réponses sont dans le paquet !).
5. Tentatives : suivi activé, méthode de notation Meilleure tentative.
6. Note : note maximale 100, note pour passer 70.
7. Achèvement d’activité : conditions automatiques, cocher « l’étudiant doit recevoir une note » et « note de passage requise ».
8. Enregistrer et afficher.

Étape 4 — Tester et vérifier la remontée de note

1. Prévisualisez en tant qu’enseignant : la vidéo se lance, les questions apparaissent, les signets fonctionnent.
2. Passez en revue avec un compte étudiant de test (ou « Prendre le rôle » — mais attention, la prise de rôle ne génère pas toujours des tentatives réalistes ; un vrai compte de test est plus fiable). Répondez aux questions, dont une fausse.
3. Retournez sur l’activité en enseignant : onglet Tentatives → votre étudiant de test apparaît avec sa tentative ; ouvrez le détail pour voir chaque interaction.
4. Ouvrez le carnet de notes (Notes dans le menu du cours) : la colonne de l’activité affiche la note à l’échelle (par exemple 75/100 pour 3 réponses sur 4).
5. Refaites une tentative complète avec le compte de test en répondant tout juste : la note passe à 100 (méthode « meilleure tentative ») et l’achèvement se coche (note ≥ 70).

Si la note ne remonte pas : vérifiez dans l’ordre (a) que le suivi des tentatives est activé, (b) que la méthode de notation n’est pas « ne pas calculer », (c) que le contenu comporte bien des interactions évaluées (une vidéo sans question ne produit aucun score), (d) que vous avez testé avec un compte réellement inscrit comme étudiant.

Checklist de fin de chapitre

• Je sais expliquer ce qu’est un fichier .h5p (zip : manifeste + bibliothèques + content.json).
• Je distingue sans hésiter mod_hvp (plugin tiers gelé, « Interactive Content ») et mod_h5pactivity (cœur 3.9+, « H5P ») et je sais lequel utiliser (le second, toujours).
• Je sais créer un contenu dans la banque de contenus, gérer sa visibilité, et choisir consciemment entre copie et alias en l’insérant dans une activité.
• Je sais où installer/mettre à jour/verrouiller les types de contenus (Administration du site → H5P).
• Je sais associer un type H5P à une intention pédagogique et je connais les types qui ne renvoient pas de score.
• Je sais configurer la méthode de notation d’une activité H5P et lire le rapport de tentatives jusqu’au détail par interaction.
• J’ai intégré les limites : exécution côté client (pas d’évaluation sommative à enjeu), accessibilité variable, bouton de téléchargement = corrigé en clair.
• Je situe H5P par rapport à SCORM et xAPI, et je sais que l’export vers un LRS passe par un plugin Logstore xAPI.

Transition

Vous savez désormais enrichir vos cours avec de l’interactivité créée en quelques minutes — et vous connaissez la frontière entre l’entraînement formatif (royaume de H5P) et l’évaluation qui compte. C’est précisément l’objet du chapitre 6, où nous plongerons dans le système d’évaluation le plus puissant de Moodle : l’activité Test (Quiz), sa banque de questions, ses types de questions et ses stratégies anti-triche — tout ce que H5P, par conception, ne peut pas offrir.