Flipbooks elegantes
en tu sitio de WordPress

Qué añade el plugin a tu sitio — y qué no

Un plugin entra en tu propia instalación, así que es justo preguntar qué trae consigo. Este es deliberadamente pequeño. En la parte pública genera un único <div> con un <iframe> dentro, marcado con loading="lazy": un flipbook situado abajo en una página larga solo se carga cuando el lector llega hasta él.

No carga ninguna hoja de estilos ni JavaScript en la parte pública. No crea tablas en la base de datos ni añade menús al escritorio. No llama a casa, no cuenta nada y no pide ninguna clave de API. Todo lo que hace funcionar el flipbook ocurre dentro del iframe, en nuestro lado — y por eso tu puntuación de velocidad no se mueve cuando añades uno.

Desactivarlo es igual de tranquilo: el shortcode deja de reconocerse, así que [toombler id="…"] aparece como texto normal en la entrada hasta que lo quites. No queda nada en la base de datos, porque nunca se puso nada allí.

La versión en texto, y por qué conviene activarla

Un flipbook es una imagen de tus páginas. Está bien para quien ve y tiene ratón, y no sirve para un lector de pantalla, que encuentra un marco y nada que leer. Si añades text="1" al shortcode, debajo del libro aparece un panel plegable Read the text version, relleno con la capa de texto real de tu PDF.

La descarga ocurre en tu servidor, no en el navegador del visitante, y el resultado se guarda en un transient de WordPress: doce horas si se encontró texto, una hora si no — así un flipbook cuyo texto todavía se está extrayendo lo recoge poco después y no al día siguiente. Se almacenan como mucho 60.000 caracteres, más que un folleto corriente, y lo suficiente para que un manual de cuatrocientas páginas no te llene la tabla de opciones.

Hay un segundo motivo, menos noble pero real: ese texto está en tu página, en tu HTML, bajo tu dominio. Un buscador que lea la entrada ve lo que el documento dice de verdad en lugar de un marco en el que no puede entrar. Si publicas catálogos o boletines que quieres que se encuentren, este único atributo hace más que todo lo demás de esta página.

Solo funciona con PDF que contengan texto real. Un escaneo sin OCR no tiene capa de texto, y entonces el panel no aparece en vez de abrirse vacío.

Requisitos, versiones y licencia

El plugin necesita WordPress 5.8 o posterior y PHP 7.4 o posterior, y se prueba contra la versión actual de WordPress. Esos listones son bajos a propósito: el código no usa nada exótico, así que sigue funcionando en alojamientos que van unos años por detrás.

Como es un shortcode corriente, funciona en el editor de bloques, en el editor clásico, en un widget de texto y en constructores de páginas como Elementor, Divi, Beaver Builder y Bricks — en cualquier sitio donde se procesen shortcodes. El bloque de Gutenberg es una comodidad añadida, no un requisito.

Es software libre bajo la GPL, versión 2 o posterior, la misma licencia que el propio WordPress. Puedes leerlo, modificarlo y ejecutar tu propia versión en tus propios sitios.

Cómo trata lo que escribes

Todo lo que acaba en el HTML de una página merece una mirada desconfiada, así que esto es lo que pasa con tus atributos. El ID de archivo tiene que encajar en [A-Za-z0-9_-] y medir entre diez y sesenta caracteres; cualquier otra cosa se rechaza con un mensaje visible en lugar de pegarse en una URL. El ancho y el alto pasan por absint(), de modo que una letra perdida da el valor por defecto en vez de romper la maquetación. La URL montada se escapa antes de llegar al src.

Hay algo que conviene saber porque sorprende: WordPress descarta en silencio los atributos de shortcode que no conoce. Si escribes hight="600" no se rompe nada — simplemente obtienes la altura por defecto y ningún aviso en ninguna parte. Si una opción parece no hacer nada, comprueba primero la ortografía contra la tabla de arriba.

El plugin hace exactamente una petición de tu servidor al nuestro, y solo cuando text="1" está activo: pide el texto de ese flipbook concreto. No se envía nada sobre tus visitantes, porque no sabe nada de ellos.

¿Bloque o shortcode?

Generan el mismo HTML, así que es cuestión de cómo te guste trabajar. El bloque te da una vista previa en vivo en el editor y una barra lateral con las opciones como controles de verdad, lo cual es más cómodo mientras pruebas tamaños. El shortcode es texto, y eso facilita copiarlo entre entradas, pegarlo en un constructor de páginas y buscarlo después cuando quieras localizar todos los flipbooks del sitio.

Si llevas el sitio para otra persona, el shortcode tiene una ventaja práctica: sobrevive a un cambio de tema, a un cambio de editor y a una mudanza a un constructor de páginas sin tener que rehacerse. Para una comparación del plugin con las otras tres formas de insertar — iframe simple, fragmento de JavaScript y oEmbed — consulta la guía sobre insertar un PDF en WordPress.