{"id":219,"date":"2025-10-16T22:43:44","date_gmt":"2025-10-16T20:43:44","guid":{"rendered":"https:\/\/www.rezeau.org\/wp-h5p\/\/?page_id=219"},"modified":"2026-06-11T23:16:12","modified_gmt":"2026-06-11T21:16:12","slug":"documentation-2","status":"publish","type":"page","link":"https:\/\/www.rezeau.org\/wp-h5p\/fr\/documentation-2\/","title":{"rendered":"DC Documentation"},"content":{"rendered":"\n

Dialog Cards ‘papi Jo’ 1.17.0 de <\/em>juin 2026<\/h4>\n\n\n\n

IMPORTANT ! Cette version est compatible avec la version H5P API 1.28 ‘new look’<\/strong><\/p>\n\n\n\n

ATTENTION Cette documentation est traduite de la documentation anglaise et n’est pas forc\u00e9ment \u00e0 jour ni compl\u00e8te. Pour une documentation vraiment \u00e0 jour, affichez la doc. anglaise<\/strong><\/p>\n\n\n\n

Introduction<\/h4>\n\n\n\n

Vous trouverez ici le d\u00e9tail des diverses diff\u00e9rences entre la distribution officielle H5P du type de contenu Dialog Cards et la version ‘papi Jo’.<\/p>\n\n\n\n

1. \u00c9diteur des cartes de dialogue<\/h4>\n\n\n\n

Ajout de quelques fonctions \u00e0 l’\u00e9diteur de texte : Taille de police, couleur(s) de police, listes \u00e0 puces et num\u00e9rot\u00e9es, r\u00e8gle horizontale et bouton “lien”.<\/h6>\n\n\n\n
Correction de l’erreur d’alignement \/ centr\u00e9 \u00e0 gauche.<\/h6>\n\n\n\n
Il est maintenant possible de laisser le texte du champ R\u00e9ponse<\/em> vide.<\/h6>\n\n\n\n
Image optionnelle pour le recto de la carte.<\/h6>\n\n\n\n

Cette image sera \u00e9galement affich\u00e9e au dos de la carte si aucune image arri\u00e8re n’est fournie.<\/p>\n\n\n\n

Ajouter une image au dos de la carte.<\/h6>\n\n\n\n

Une carte peut avoir l’une des caract\u00e9ristiques suivantes : aucune image attach\u00e9e du tout ; une image attach\u00e9e \u00e0 la face avant seulement (qui sera affich\u00e9e sur le recto et le verso) ; une image avant et une image arri\u00e8re ; aucune image avant et une image arri\u00e8re.<\/p>\n\n\n\n

La combinaison de texte de r\u00e9ponse vide et d’aucune image pour le recto de la carte mais d’une image pour le verso est illustr\u00e9e dans l’exemple Drapeaux et pays.<\/p>\n\n\n\n

Ajout d’un lien web aux \u00e9diteurs de texte et de r\u00e9ponse<\/h6>\n\n\n\n
Ajouter un fichier audio au dos des cartes.<\/h6>\n\n\n\n
Ajout d’une option de filtrage des cartes par cat\u00e9gories.<\/h6>\n\n\n\n

Juste au-dessus de la liste des cartes\/dialogues lorsque l’option Activer les cat\u00e9gories dans les cartes<\/em> est s\u00e9lectionn\u00e9e, un champ suppl\u00e9mentaire Cat\u00e9gorie(s) de carte(s)<\/em> est disponible \u00e0 la fin des param\u00e8tres de chaque carte.<\/p>\n\n\n\n

Il indique : Optionnel. Cat\u00e9gorie(s) \u00e0 laquelle\/auxquelles cette carte appartient. Saisissez le(s) nom(s) de la ou des cat\u00e9gories, s\u00e9par\u00e9(s) par une virgule et sans espace<\/em>.<\/p>\n\n\n\n

Ajout d’une option “Cacher les textes?”<\/h6>\n\n\n\n

2 – Param\u00e8tres \/ Options g\u00e9n\u00e9rales<\/h4>\n\n\n\n

2.1.1 Filtres sur les cat\u00e9gories<\/h5>\n\n\n\n

Cr\u00e9er un ou plusieurs filtres \u00e0 utiliser pour filtrer les cartes affich\u00e9es \u00e0 l’utilisateur final. Utilisez les cat\u00e9gories de cartes saisies pour les cartes ci-dessus. Chaque filtre se compose de 2 champs :<\/em><\/p>\n\n\n\n

    \n
  • la liste de la\/des cat\u00e9gorie(s) \u00e0 utiliser dans ce filtre<\/li>\n\n\n\n
  • un op\u00e9rateur bool\u00e9en de filtrage<\/li>\n<\/ul>\n\n\n\n

    S\u00e9lectionnez l’op\u00e9rateur bool\u00e9en qui doit traiter la liste de filtres d\u00e9finie ci-dessus. La valeur par d\u00e9faut est ET. L’op\u00e9rateur ET limitera le choix aux cartes qui appartiennent \u00e0 TOUTES les cat\u00e9gories \u00e9num\u00e9r\u00e9es dans ce filtre. L’op\u00e9rateur OU \u00e9largira le choix \u00e0 toutes les cartes qui appartiennent \u00e0 au moins UNE cat\u00e9gorie. L’op\u00e9rateur SAUF exclura toutes les cartes appartenant \u00e0 toute cat\u00e9gorie \u00e9num\u00e9r\u00e9e dans le filtre.<\/em><\/p>\n\n\n\n

    2.1.2 Filtre par cat\u00e9gories<\/h5>\n\n\n\n

    Apr\u00e8s avoir cr\u00e9\u00e9 un ou plusieurs filtres dans l’option Filtres sur les cat\u00e9gories<\/em>, vous pouvez utiliser la liste de s\u00e9lection d\u00e9roulante suivante pour activer le mode de filtrage, parmi 3 options :<\/p>\n\n\n\n

      \n
    • Pas de filtrage<\/li>\n\n\n\n
    • Si plus d’un filtre a \u00e9t\u00e9 d\u00e9fini, permettre \u00e0 l’utilisateur de s\u00e9lectionner un filtre au moment de l’ex\u00e9cution.<\/li>\n<\/ul>\n\n\n\n

      Remarque importante <\/strong>: cette option de filtrage par cat\u00e9gories doit \u00eatre soigneusement planifi\u00e9e pour donner les r\u00e9sultats souhait\u00e9s. Malheureusement, en raison des limites du mode auteur H5P dit “s\u00e9mantique”, il n’est pas possible de v\u00e9rifier que l’auteur de l’activit\u00e9 (vous) utilisera des noms de cat\u00e9gories coh\u00e9rents \u00e0 la fois dans les param\u00e8tres de chaque carte et dans le(s) filtre(s) cr\u00e9\u00e9(s). Vous devez faire particuli\u00e8rement attention \u00e0 l’orthographe et n’utiliser que les m\u00eames noms de cat\u00e9gories dans les cartes et dans le(s) filtre(s). Vous devez \u00e9galement vous assurer que vous comprenez les concepts de filtrage par op\u00e9rateurs bool\u00e9ens.<\/p>\n\n\n\n

      D’un point de vue p\u00e9dagogique, vous devez vous assurer que vous utilisez un ensemble utile et significatif de cat\u00e9gories de filtrage dans votre activit\u00e9. L’exemple des drapeaux et des pays (avec cat\u00e9gories) est, \u00e0 mon avis, la meilleure d\u00e9monstration de ces caract\u00e9ristiques.<\/p>\n\n\n\n

      2.2 Mode<\/h5>\n\n\n\n

      La Navigation libre<\/strong> est le mode par d\u00e9faut. En mode Appariement<\/strong>, l’utilisateur devra apparier le recto et le verso des cartes. En mode Autocorrection<\/strong>, il pourra deviner l’autre c\u00f4t\u00e9 des cartes et confirmer s’il l’avait devin\u00e9 ou non.<\/p>\n\n\n\n

      J’ai d\u00e9j\u00e0 introduit le mode auto-correction dans une pull request<\/em> sur le Github H5P il y a quelques ann\u00e9es, mais ma suggestion a \u00e9t\u00e9 remplac\u00e9e par le nouveau “Mode R\u00e9p\u00e9tition”. Mon propre mode ‘auto-correction’ est similaire mais diff\u00e9rent du mode R\u00e9p\u00e9tition de la version officielle.<\/p>\n\n\n\n

      Le mode Appariement <\/strong>est la grande nouveaut\u00e9 ‘Papi Jo’ pour cette activit\u00e9 H5P.<\/p>\n\n\n\n

      Lorsque les modes Appariement <\/strong>ou Autocorrection <\/strong>sont s\u00e9lectionn\u00e9s, 2 autres options sont disponibles :<\/p>\n\n\n\n

      2.3 Note maximale<\/h5>\n\n\n\n

      Score maximum \u00e0 donner \u00e0 l’utilisateur \u00e0 la fin de cette activit\u00e9. Mettez ce champ \u00e0 0 (z\u00e9ro) si aucune note n’est donn\u00e9e. Si un score est donn\u00e9, il est enregistr\u00e9 dans les r\u00e9sultats H5P de l’utilisateur.<\/p>\n\n\n\n

      2.4 Pourcentage de p\u00e9nalit\u00e9<\/h5>\n\n\n\n

      Chaque tour suppl\u00e9mentaire co\u00fbtera \u00e0 l’utilisateur ce pourcentage du score maximum. Entrez 0 pour AUCUNE p\u00e9nalit\u00e9. La p\u00e9nalit\u00e9 maximale est de 50(%). N’inscrivez PAS le signe % dans la case.<\/p>\n\n\n\n

      <\/p>\n\n\n\n

      2.6 Ordre des cartes<\/h5>\n\n\n\n

      S\u00e9lectionnez l’ordre des cartes affich\u00e9es \u00e0 l’utilisateur. Les options sont : Ordre normal \/ Ordre al\u00e9atoire \/ Choix de l’utilisateur<\/em>. Si “Choix de l’utilisateur” et que l’utilisateur s\u00e9lectionne “Al\u00e9atoire”, il pourra choisir le nombre de cartes puis\u00e9es dans le pool de cartes.<\/p>\n\n\n\n

      Lorsque Ordre al\u00e9atoire<\/strong> ou Au choix de l’utilisateur<\/strong> sont s\u00e9lectionn\u00e9s, une autre option devient disponible :<\/p>\n\n\n\n

      2.7 S\u00e9lectionner le nombre de cartes affich\u00e9es<\/h5>\n\n\n\n

      Permet \u00e0 l’utilisateur de choisir le nombre de cartes tir\u00e9es dans le paquet de cartes.<\/p>\n\n\n\n

      2.8 Affichez d’abord de quel c\u00f4t\u00e9 :<\/h5>\n\n\n\n

      S\u00e9lectionnez le mode d’affichage des cartes. Les options sont : Afficher d’abord la face avant (affichage normal) \/ Afficher d’abord la face arri\u00e8re (affichage invers\u00e9) \/ Choix de l’utilisateur<\/em>. Cette option est surtout utile si le recto des cartes n’est pas vraiment une question.<\/p>\n\n\n\n

      Actuellement, cette option n’est disponible que dans les modes Navigation libre et Autocorrection.<\/p>\n\n\n\n

      2.9 Ajout d’une option “Cacher les textes?”<\/h5>\n\n\n\n

      Description <\/strong>: “Cochez cette case si vous n’utilisez que des images et du son au recto et au verso des cartes, pas de texte”. M\u00eame si vous avez saisi du texte pour les cartes du recto ou du verso, si vous cochez cette option, ces textes ne seront pas affich\u00e9s \u00e0 l’utilisateur final (l’\u00e9l\u00e8ve). Cette option r\u00e9duit notablement la hauteur des cartes de dialogue, en supprimant l’espace vide inutilis\u00e9 sous les images (ou les boutons audio).<\/p>\n\n\n\n

      \n\n\n\n

      2.10 Nouvelle option disponible en mode Auto-correction<\/h4>\n\n\n\n

      \u00c0 partir de la version 1.16.14 d’ao\u00fbt 2025, une nouvelle option est disponible : Masquer le bouton \u00ab Retourner \u00bb au dos des cartes ?<\/em><\/strong> Cochez cette case si vous souhaitez remplacer le libell\u00e9 \u00ab Retourner \u00bb par \u00ab V\u00e9rifier \u00bb et le masquer au dos des cartes. Justification : en mode Auto-correction, une fois que l’utilisateur final est pass\u00e9 du recto au verso de la carte, il n’est g\u00e9n\u00e9ralement pas n\u00e9cessaire de retourner la carte pour revenir au recto. Notez que cette option n’est pas activ\u00e9e par d\u00e9faut.<\/p>\n\n\n\n

      \n\n\n\n

      Remarque g\u00e9n\u00e9rale<\/strong> – Dans chaque “paquet de cartes”, il n’est pas conseill\u00e9 de m\u00e9langer des cartes avec diff\u00e9rents types de contenu, par exemple, la carte n\u00b0 1 ne comportant qu’une image au recto, la carte n\u00b0 2 comportant de l’audio au recto et au verso mais pas d’image ni de texte, etc. Si vous le faites, des probl\u00e8mes d’affichage ind\u00e9sirables peuvent survenir. Essayez d’\u00eatre coh\u00e9rent !<\/p>\n\n\n\n

      3.- Disponibilit\u00e9 des fonctionnalit\u00e9s H5P<\/h4>\n\n\n\n

      3.1 – La fonction Enregistrer l’\u00e9tat du contenu <\/em>est disponible (si elle est activ\u00e9e sur votre site).<\/p>\n\n\n\n

      3.2 – Les r\u00e9sultats <\/em>de l’utilisateur sont sauvegard\u00e9s sur le site, si vous avez d\u00e9fini une valeur Maximum Score dans les param\u00e8tres, bien s\u00fbr. Cette fonction n’est actuellement pas disponible dans la version officielle<\/p>\n\n\n\n

      3.2- Langues<\/h5>\n\n\n\n

      A partir de la version 1.16.14 d’ao\u00fbt 2025, l’interface d’\u00e9dition et l’interface pour l’utilisateur final sont disponibles dans ces largues :<\/p>\n\n\n\n

        \n
      • Anglais<\/li>\n\n\n\n
      • Fran\u00e7ais<\/li>\n\n\n\n
      • Portuguais<\/li>\n\n\n\n
      • Turc<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n
        \n

        Edit\u00e9 le<\/p>\n\n\n