Inicio Rapido del Widget de Integracion
Anade publicaciones de flipbook interactivas a cualquier sitio web con una sola etiqueta script. Cubre la integracion basica, los atributos de datos y la resolucion de problemas comunes.
- Metodo 1: Etiqueta Script (El mas sencillo)
- Metodo 2: Contenedor Div
- Atributos de Datos
- Ejemplos Comunes
- Integracion en Entrada de Blog
- Integracion de Pagina Completa
- Integracion Responsiva
- Presentacion con Paso Automatico
- Multiples Publicaciones en Una Pagina
- Encontrar el Slug de Tu Publicacion
- Resolucion de Problemas
- La integracion no aparece
- Errores de CORS en la consola
- La Politica de Seguridad de Contenido (CSP) bloquea el script
- La integracion aparece pero las paginas no cargan
- El alto de la integracion no coincide con el contenido
- Proximos Pasos
Inicio Rapido del Widget de Integracion
El widget de integracion de ZenFlip te permite anadir publicaciones de flipbook interactivas a cualquier sitio web con codigo minimo. El widget crea un iframe responsivo que carga el visor de ZenFlip con tu publicacion.
Metodo 1: Etiqueta Script (El mas sencillo)
Anade una sola etiqueta script donde quieras que aparezca el flipbook. El widget renderiza la publicacion directamente despues del elemento script.
`html <script src="https://app.zenflip.io/embed.js" data-pub="your-publication-slug" data-width="100%" data-height="600"> </script> `
Eso es todo lo que necesitas. El widget de integracion se inicializa automaticamente cuando la pagina carga e inserta un iframe que contiene tu publicacion.
Metodo 2: Contenedor Div
Para mayor control sobre la ubicacion, usa un elemento div con la clase zenflip-embed e incluye el script de integracion por separado. Este es el enfoque recomendado cuando tienes multiples publicaciones en una sola pagina.
`html <div class="zenflip-embed" data-pub="your-publication-slug" data-width="100%" data-height="600"> </div>
<!-- Incluir el script una vez, en cualquier parte de la pagina --> <script src="https://app.zenflip.io/embed.js"></script> `
El script escanea la pagina en busca de todos los elementos con la clase zenflip-embed e inicializa cada uno.
Atributos de Datos
Configura la integracion usando atributos de datos HTML:
Atributo | Defecto | Descripcion |
|---|---|---|
| Requerido | Slug de la publicacion (de la URL de la publicacion) |
|
| Ancho de la integracion (valor CSS: |
|
| Alto de la integracion (numero en pixeles o valor CSS) |
|
| Paso automatico de paginas a intervalos de tiempo |
|
| Numero de pagina para abrir en la carga inicial |
| Auto | Sobreescribir la URL base del visor (avanzado) |
Los valores de alto numericos se tratan como pixeles. Tambien puedes usar unidades CSS como 80vh o 500px.
Ejemplos Comunes
Integracion en Entrada de Blog
Una integracion compacta adecuada para dentro del contenido de un articulo:
`html <div class="zenflip-embed" data-pub="quarterly-report-q1-2026" data-width="100%" data-height="500"> </div> `
Integracion de Pagina Completa
Llena toda la ventana del navegador con el flipbook:
`html <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Product Catalog</title> <style> * { margin: 0; padding: 0; box-sizing: border-box; } body { width: 100vw; height: 100vh; overflow: hidden; } .zenflip-embed { width: 100%; height: 100vh; } </style> </head> <body> <div class="zenflip-embed" data-pub="product-catalog-2026" data-width="100%" data-height="100vh"> </div> <script src="https://app.zenflip.io/embed.js"></script> </body> </html> `
Integracion Responsiva
Crea una integracion responsiva que se adapte al ancho del contenedor:
`html <div style="max-width: 960px; margin: 0 auto;"> <div class="zenflip-embed" data-pub="company-brochure" data-width="100%" data-height="700"> </div> </div> <script src="https://app.zenflip.io/embed.js"></script> `
El widget de integracion siempre establece max-width: 100% en su contenedor, por lo que se ajusta naturalmente dentro de cualquier contenedor sin desbordamiento horizontal.
Presentacion con Paso Automatico
Comienza en una pagina especifica con el paso automatico habilitado (util para pantallas de kiosco o presentaciones):
`html <script src="https://app.zenflip.io/embed.js" data-pub="investor-deck" data-width="100%" data-height="700" data-auto-flip="true" data-start-page="1"> </script> `
Multiples Publicaciones en Una Pagina
Usa el metodo div cuando integres mas de una publicacion:
`html <h2>Product Catalog</h2> <div class="zenflip-embed" data-pub="product-catalog-2026" data-width="100%" data-height="500"> </div>
<h2>Annual Report</h2> <div class="zenflip-embed" data-pub="annual-report-2025" data-width="100%" data-height="500"> </div>
<!-- Cargar el script una vez despues de todos los contenedores --> <script src="https://app.zenflip.io/embed.js"></script> `
Encontrar el Slug de Tu Publicacion
El slug de la publicacion es el identificador amigable para URLs visible en la URL de la publicacion. Puedes encontrarlo en dos lugares:
Panel de control: Abre la publicacion y mira la URL en tu navegador:
https://app.zenflip.io/publications/your-slug-hereAPI: El campo
slugen el objeto de publicacion devuelto porGET /publications
Resolucion de Problemas
La integracion no aparece
Verifica que el atributo
data-pubcoincida con un slug de publicacion existente y publicada.Revisa la consola del navegador en busca de errores. Un slug faltante produce la advertencia:
[ZenFlip] Missing data-pub attribute. Skipping embed.Confirma que el estado de la publicacion es
published(las publicaciones en borrador no son accesibles a traves del visor publico).
Errores de CORS en la consola
Si ves errores de Comparticion de Recursos de Origen Cruzado (CORS), el problema generalmente esta en tus encabezados de Politica de Seguridad de Contenido (CSP). Anade el dominio de ZenFlip a tu directiva CSP frame-src:
` Content-Security-Policy: frame-src 'self' https://app.zenflip.io; `
La Politica de Seguridad de Contenido (CSP) bloquea el script
Si tu sitio usa encabezados CSP estrictos, necesitas permitir el script de integracion:
` Content-Security-Policy: script-src 'self' https://app.zenflip.io; frame-src 'self' https://app.zenflip.io; `
La integracion aparece pero las paginas no cargan
La publicacion puede estar aun en proceso de conversion. La conversion de PDF se ejecuta de forma asincrona despues de la carga y puede tardar desde unos segundos hasta unos minutos dependiendo del numero de paginas.
Si la publicacion usa acceso
privateo esta protegida con contrasena, el endpoint del visor publico no devolvera datos de pagina. Establece la visibilidad enpublicpara las integraciones.
El alto de la integracion no coincide con el contenido
El widget de integracion usa un alto fijo basado en el atributo data-height. Si las paginas aparecen cortadas, aumenta el valor del alto. Para un enfoque mas dinamico, usa unidades de ventana CSS como 80vh para hacer el alto relativo a la ventana del navegador.
Proximos Pasos
[Opciones Avanzadas de Integracion](/docs/embed-advanced) --- API programatica, integracion SPA, manejo de eventos y estilos personalizados.
[API de Publicaciones](/docs/publications-api) --- Gestiona publicaciones y controla la visibilidad de forma programatica.