Ou écrivez au support@educaplay.com
Comment intégrer Educaplay dans une page web
Nous nous engageons à améliorer continuellement votre expérience ; certains éléments de l'interface de la vidéo peuvent ne pas correspondre à l'interface actuelle.
Ce que fait l'intégration
Vos jeux Educaplay se chargent à l'intérieur de votre propre site web, blog ou CMS, sans que le visiteur ait à ouvrir un autre onglet.
Trois façons d'intégrer
- Iframe : vous collez un bloc de HTML. Fonctionne sur n'importe quel site qui accepte le HTML. C'est l'option universelle.
- Plugin officiel de WordPress : vous collez le lien du jeu dans un bloc et il est intégré. Sans toucher au HTML. Gratuit.
- Téléchargement du HTML : empaquette le jeu pour l'héberger sur votre propre serveur. Disponible à partir du plan Académique.
Où trouver les options
Toutes les options d'intégration se trouvent dans la fenêtre Partager du jeu. Vous pouvez l'ouvrir depuis trois endroits :
- Dans Mes jeux : l'icône de partage (trois points connectés) à côté de chaque jeu publié.
- Sur la page du jeu : la même icône à droite du titre.
- Juste après avoir publié un jeu : Educaplay affiche un écran de confirmation avec le bouton à portée de main.
Option A : intégrer avec un iframe
Dans la fenêtre Partager, sous le lien, se trouve le bloc Intégrez le jeu sur votre page avec le code iframe, prêt à copier-coller.
- Cliquez sur le bouton de copie à droite du code.
- Sur votre site web ou blog, ouvrez l'éditeur de la section où vous voulez intégrer le jeu.
- Collez le code dans un bloc qui accepte le HTML. Si votre éditeur ne permet pas de coller du HTML directement, ouvrez-le en mode code et collez-le là.
- Enregistrez et publiez.
Pour adapter la taille, modifiez les attributs width et height de l'iframe. Avec width="100%", le jeu occupera toute la largeur disponible sur n'importe quel appareil.
Option B : le plugin officiel de WordPress
Si votre site est un WordPress, ce plugin gratuit vous évite l'iframe.
- Installez le plugin Embed Activities for Educaplay depuis le dépôt officiel de WordPress.
- Dans l'éditeur de la page ou de l'article, ajoutez le bloc Educaplay.
- Collez le lien du jeu que vous avez copié depuis la fenêtre Partager.
- Enregistrez et publiez. Le jeu est intégré, comme le bloc YouTube avec l'URL d'une vidéo.
Option C : télécharger le HTML du jeu
Avec un plan Académique ou un plan Commercial, le bloc Téléchargement apparaît dans la fenêtre Partager, avec l'option de télécharger le HTML du jeu. Il sert à l'héberger sur votre propre serveur au lieu de l'intégrer depuis educaplay.com.
Cas où cela a du sens :
- Servir le jeu depuis votre propre domaine.
- L'inclure dans des projets web fermés ou des intranets sans accès à internet (à condition que le serveur le serve).
- L'intégrer dans des frameworks ou des systèmes qui préfèrent les fichiers locaux aux iframes.
Limitations importantes :
- Le HTML téléchargé doit être servi depuis un serveur web : il ne s'exécute pas en ouvrant le fichier directement.
- Les scores des parties ne sont pas enregistrés dans les Rapports d'Educaplay lorsque le jeu est servi depuis votre HTML.
- Pour enregistrer les scores dans le carnet de notes d'une plateforme LMS, utilisez le téléchargement SCORM (également à partir du plan Académique) ou les identifiants LTI de la fenêtre Partager.
Partager uniquement avec un lien ou un QR
Si vous n'avez pas besoin d'intégrer le jeu, dans la fenêtre Partager vous avez :
- Lien direct avec bouton de copie. Utile pour les e-mails, les réseaux sociaux ou les classes virtuelles.
- Code QR du lien. Utile pour les séances en présentiel : vous projetez le QR et les joueurs le scannent avec leur téléphone.
Identification des joueurs et scores
Les parties sont enregistrées dans votre section Rapports d'Educaplay même si le joueur ne s'identifie pas ; dans ce cas, elles le sont sous le nom Anonyme. Pour que chaque partie porte le nom de celui qui l'a jouée, les joueurs doivent s'identifier avant de jouer. Dans l'éditeur du jeu (onglet Options → Réglages avancés → Confidentialité), vous pouvez :
- Rendre obligatoire l'Identification du joueur (Pseudo, code d'invité ou compte Educaplay).
- Changer la Visibilité si vous ne voulez pas que le jeu apparaisse dans les moteurs de recherche ni dans le catalogue d'Educaplay.
Ces options nécessitent un plan Avancé, un plan Académique ou un plan Commercial.
Récupérer les scores de façon programmatique
Si vous intégrez les jeux sur votre propre site et que vous voulez transférer les scores vers vos systèmes, Educaplay propose une API de Rapports pour consulter les scores de vos joueurs de façon programmatique. Elle est disponible avec les plans Académique et Commercial, aussi bien individuels que d'Équipe. Elle ne renvoie que les parties des jeux servis par Educaplay (iframe, plugin ou lien) : les parties de la copie HTML auto-hébergée (Option C) ne sont pas synchronisées avec Educaplay et n'apparaissent donc pas non plus dans l'API. Vous trouverez la documentation sur api.educaplay.com/docs/, également accessible via Développeurs, dans le pied de page d'Educaplay.
Questions fréquentes
Dois-je connaître le HTML pour intégrer un jeu ?
Normalement non. Si vous collez l'iframe dans un éditeur visuel, cela fonctionne en général ; si votre éditeur n'accepte pas le HTML dans le contenu direct, vous devrez ouvrir le mode code et le coller là. Sur WordPress, vous pouvez vous passer du HTML avec le plugin gratuit Embed Activities for Educaplay : vous collez le lien du jeu et c'est tout.
Comment changer la taille du jeu sur ma page ?
En modifiant les attributs width et height de l'iframe. Avec width="100%", le jeu occupera toute la largeur de la section.
Comment fonctionne le plugin WordPress ?
Il ajoute un bloc Educaplay à l'éditeur. Vous collez le lien du jeu et le plugin le transforme en un jeu intégré, comme le bloc YouTube avec l'URL d'une vidéo. Le plugin s'appelle Embed Activities for Educaplay et s'installe gratuitement depuis le dépôt officiel de WordPress.
Puis-je télécharger le HTML du jeu pour l'héberger moi-même ?
Oui, à partir du plan Académique. Dans la fenêtre Partager, le bloc Téléchargement inclut une icône HTML qui empaquette le jeu pour le mettre en ligne sur votre propre serveur. Le HTML ne s'exécute pas en ouvrant le fichier directement : il doit être servi depuis un serveur web. Et les parties sur cette copie ne se synchronisent pas avec les Rapports d'Educaplay.
Les joueurs ont-ils besoin d'avoir un compte sur Educaplay ?
Pas nécessairement. Selon la façon dont vous avez configuré le jeu, ils peuvent s'identifier avec un Pseudo (il suffit de saisir un nom), avec un code d'invité ou avec leur propre compte Educaplay. Si vous voulez que chaque partie porte un nom, le jeu doit demander une identification avant de commencer ; sinon, elle sera enregistrée sous le nom Anonyme.
Les scores sont-ils enregistrés quand quelqu'un joue depuis mon site ?
Oui. Les parties restent dans votre section Rapports d'Educaplay ; celles des joueurs qui ne s'identifient pas sont enregistrées sous le nom Anonyme. Exception : si vous avez téléchargé le HTML et le servez depuis votre serveur, ces parties ne se synchronisent pas avec Educaplay.
Puis-je personnaliser l'apparence du jeu sur mon site ?
Par l'iframe lui-même non, mais vous pouvez personnaliser le jeu lui-même depuis son éditeur : ajouter une image de fond ou masquer des éléments de l'interface avec un plan Avancé ; appliquer vos couleurs d'entreprise, votre logo, votre pied de page et masquer la marque Educaplay avec un plan Commercial.
Puis-je transférer les scores vers mon propre site ou système ?
Oui. En plus de les consulter dans votre section Rapports, avec un plan Académique ou Commercial vous pouvez utiliser l'API de Rapports pour récupérer les scores de façon programmatique. La documentation est sur api.educaplay.com/docs/. Notez que l'API n'inclut pas les parties de la copie HTML auto-hébergée (Option C), car elles ne sont pas synchronisées avec Educaplay.
