We use cookies to improve your experience, analyze site traffic and measure how our Google ads perform. By clicking "Accept", you consent to analytics and advertising cookies. See our Privacy Policy for details.

Happy Thanksgiving - 15% off every paid plan Use code THANKYOU at checkout. Ends 30 November.See plans

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.

On this page

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

data-pub

Requerido

Slug de la publicacion (de la URL de la publicacion)

data-width

100%

Ancho de la integracion (valor CSS: 100%, 800px, 50vw)

data-height

600

Alto de la integracion (numero en pixeles o valor CSS)

data-auto-flip

false

Paso automatico de paginas a intervalos de tiempo

data-start-page

1

Numero de pagina para abrir en la carga inicial

data-base-url

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:

  1. Panel de control: Abre la publicacion y mira la URL en tu navegador: https://app.zenflip.io/publications/your-slug-here

  2. API: El campo slug en el objeto de publicacion devuelto por GET /publications

Resolucion de Problemas

La integracion no aparece

  • Verifica que el atributo data-pub coincida 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 private o esta protegida con contrasena, el endpoint del visor publico no devolvera datos de pagina. Establece la visibilidad en public para 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.

← Previous
Opciones Avanzadas de Integracion