O escríbenos a soporte@educaplay.com
Cómo integrar Educaplay en una página web
Nos comprometemos a mejorar continuamente tu experiencia; puede que algunos elementos de la interfaz del vídeo no se correspondan con la actual.
Qué hace la integración
Tus juegos de Educaplay se cargan dentro de tu propia página web, blog o CMS, sin que el visitante tenga que abrir otra pestaña.
Tres formas de integrar
- Iframe: pegas un bloque de HTML. Funciona en cualquier web que acepte HTML. Es la opción universal.
- Plugin oficial de WordPress: pegas el enlace del juego en un bloque y queda incrustado. Sin tocar HTML. Gratis.
- Descarga del HTML: empaqueta el juego para alojarlo en tu propio servidor. Disponible a partir del Plan Académico.
Dónde encuentras las opciones
Todas las opciones de integración están dentro del cuadro Compartir del juego. Puedes abrirlo desde tres sitios:
- En Mis juegos: el icono de compartir (tres puntos conectados) junto a cada juego publicado.
- En la página del juego: el mismo icono a la derecha del título.
- Justo después de publicar un juego: Educaplay muestra una pantalla de confirmación con el botón a mano.
Opción A: Insertar con iframe
En el cuadro Compartir, debajo del enlace, está el bloque Incrusta el juego en tu página con el código iframe, listo para copiar y pegar.
- Pulsa el botón de copiar a la derecha del código.
- En tu página web o blog, abre el editor de la sección donde quieras insertar el juego.
- Pega el código en un bloque que acepte HTML. Si tu editor no permite pegar HTML directamente, ábrelo en modo código y pégalo ahí.
- Guarda y publica.
Para adaptar el tamaño, modifica los atributos width y height del iframe. Con width="100%", el juego ocupará todo el ancho disponible en cualquier dispositivo.
Opción B: Plugin oficial de WordPress
Si tu web es un WordPress, este plugin gratuito te ahorra el iframe.
- Instala el plugin Embed Activities for Educaplay desde el repositorio oficial de WordPress.
- En el editor de la página o entrada, añade el bloque de Educaplay.
- Pega el enlace del juego que has copiado del cuadro Compartir.
- Guarda y publica. El juego queda incrustado, igual que el bloque de YouTube con la URL de un vídeo.
Opción C: Descargar el HTML del juego
Con un Plan Académico o Plan Comercial, en el cuadro Compartir aparece el bloque Descarga con la opción de descargar el HTML del juego. Sirve para alojarlo en tu propio servidor en lugar de incrustarlo desde educaplay.com.
Casos en los que tiene sentido:
- Servir el juego desde tu propio dominio.
- Incluirlo en proyectos web cerrados o intranets sin acceso a internet (siempre que el servidor lo sirva).
- Integrarlo en frameworks o sistemas que prefieren ficheros locales a iframes.
Limitaciones importantes:
- El HTML descargado tiene que estar servido desde un servidor web: no se ejecuta abriendo el archivo directamente.
- Las puntuaciones de las partidas no se registran en Informes de Educaplay cuando el juego se sirve desde tu HTML.
- Para guardar puntuaciones en el libro de calificaciones de una plataforma LMS, usa la descarga SCORM (también desde Plan Académico) o las credenciales LTI del cuadro Compartir.
Compartir solo con enlace o con QR
Si no necesitas incrustar el juego, en el cuadro Compartir tienes:
- Enlace directo con botón de copiar. Útil para correos, redes sociales o aulas virtuales.
- Código QR del enlace. Útil para sesiones presenciales: proyectas el QR y los jugadores lo escanean con el móvil.
Identificación de los jugadores y puntuaciones
Las partidas se guardan en tu sección Informes de Educaplay aunque el jugador no se identifique; en ese caso quedan como Anónimo. Para que cada partida lleve el nombre de quien la ha jugado, los jugadores tienen que identificarse antes de jugar. En el editor del juego (pestaña Opciones → Opciones avanzadas → Privacidad) puedes:
- Hacer obligatoria la Identificación del jugador (Nickname, código de invitado o cuenta de Educaplay).
- Cambiar la Visibilidad si no quieres que el juego aparezca en buscadores ni en el catálogo de Educaplay.
Estas opciones requieren Plan Avanzado, Plan Académico o Plan Comercial.
Extraer las puntuaciones de forma programática
Si integras los juegos en tu propia web y quieres llevar las puntuaciones a tus sistemas, Educaplay ofrece una API de Informes para consultar las puntuaciones de tus jugadores de forma programática. Está disponible para los Planes Académico y Comercial, tanto individuales como de Equipo. Solo devuelve las partidas de juegos servidos desde Educaplay (iframe, plugin o enlace): las de la copia HTML autoalojada (Opción C) no se sincronizan con Educaplay, por lo que tampoco aparecen en la API. Tienes la documentación en api.educaplay.com/docs/, enlazada también desde Desarrolladores, en el pie de página de Educaplay.
Preguntas frecuentes
¿Tengo que saber HTML para insertar un juego?
Normalmente no. Si pegas el iframe en un editor visual suele funcionar; si tu editor no acepta HTML en el contenido directo, tendrás que abrir el modo código y pegarlo ahí. En WordPress te puedes saltar el HTML con el plugin gratuito Embed Activities for Educaplay: pegas el enlace del juego y listo.
¿Cómo cambio el tamaño del juego en mi página?
Modificando los atributos width y height del iframe. Con width="100%", el juego ocupará todo el ancho de la sección.
¿Cómo funciona el plugin de WordPress?
Añade un bloque de Educaplay al editor. Pegas el enlace del juego y el plugin lo convierte en un juego incrustado, igual que el bloque de YouTube con la URL de un vídeo. El plugin se llama Embed Activities for Educaplay y se instala gratis desde el repositorio oficial de WordPress.
¿Puedo descargar el HTML del juego para alojarlo yo?
Sí, a partir del Plan Académico. En el cuadro Compartir, el bloque Descarga incluye un icono de HTML que empaqueta el juego para subirlo a tu propio servidor. El HTML no se ejecuta abriendo el archivo directamente: tiene que estar servido desde un servidor web. Y las partidas en esa copia no se sincronizan con Informes de Educaplay.
¿Los jugadores necesitan tener cuenta en Educaplay?
No necesariamente. Según cómo hayas configurado el juego, pueden identificarse con un Nickname (basta con escribir un nombre), con un código de invitado o con una cuenta propia de Educaplay. Si quieres que cada partida lleve nombre, el juego tiene que pedir identificación antes de empezar; si no, se guardará como Anónimo.
¿Las puntuaciones se guardan cuando alguien juega desde mi web?
Sí. Las partidas quedan en tu sección Informes de Educaplay; las de quien no se identifica, como Anónimo. Excepción: si has descargado el HTML y lo sirves desde tu servidor, esas partidas no se sincronizan con Educaplay.
¿Puedo personalizar el aspecto del juego en mi web?
Por el iframe en sí no, pero sí puedes personalizar el propio juego desde su editor: añadir una imagen de fondo u ocultar elementos de la interfaz con un Plan Avanzado; aplicar tus colores corporativos, logotipo, pie corporativo y ocultar la marca de Educaplay con un Plan Comercial.
¿Puedo llevar las puntuaciones a mi propia web o sistema?
Sí. Además de consultarlas en tu sección Informes, con un Plan Académico o Comercial puedes usar la API de Informes para obtener las puntuaciones de forma programática. La documentación está en api.educaplay.com/docs/. Ten en cuenta que la API no incluye las partidas de la copia HTML autoalojada (Opción C), porque esas no se sincronizan con Educaplay.
