Pegas un código para incrustar, pulsas Actualizar y el flipbook desaparece. Este artículo explica con exactitud por qué WordPress elimina los iframes, qué roles, editores y plugins lo provocan, y las soluciones seguras, paso a paso, para que tu flipbook vuelva a mostrarse de forma fiable.
Pegas el código para incrustar de Flipbooks AI en tu página de WordPress, pulsas Actualizar y el flipbook simplemente desaparece. El editor muestra un hueco en blanco, o el código que pegaste se ha convertido en texto plano, o la mitad ha desaparecido. Nada está roto en el lado del flipbook. WordPress hace lo que fue diseñado para hacer: filtrar el HTML en el que no confía. Una vez que sabes qué filtro se está activando, la solución suele llevar cinco minutos.
Este artículo repasa cada causa habitual, desde los roles de usuario hasta los plugins de seguridad, y te indica un orden claro para probarlas. También verás cómo elegir un método de incrustación que sobreviva a futuras ediciones, además de una lista de comprobación que puedes reutilizar en cada sitio de tus clientes.
WordPress trata cualquier contenido de una entrada como potencialmente hostil. Un iframe carga una página web completa dentro de la tuya, así que es una de las etiquetas más arriesgadas que puede añadir un autor. Para proteger el sitio, WordPress pasa el contenido por un sanitizador llamado KSES antes de guardarlo en la base de datos. KSES mantiene una lista de etiquetas y atributos permitidos. Todo lo que quede fuera de la lista se borra en silencio, sin aviso ni mensaje de error.
El detalle importante es que KSES no se aplica a todos por igual. Depende de quién guarda la entrada. Por eso el mismo código para incrustar funciona en un sitio y falla en otro, o funciona para ti pero falla para tu compañero de equipo.
WordPress concede la capacidad unfiltered_html a los Administradores y Editores en una instalación normal de un solo sitio. Los usuarios con esa capacidad se saltan KSES, así que sus iframes se guardan sin tocar. Los Autores y Colaboradores no la tienen, así que sus iframes se eliminan.
En WordPress Multisite, solo los Super Administradores tienen unfiltered_html. Un Administrador normal de un sitio dentro de una red no la tiene. Este dato por sí solo explica una gran parte de las consultas de soporte del tipo "mi iframe desaparece".
Cuando se activa el filtro, hace una de tres cosas:
allowfullscreen, style o sandbox, de modo que el flipbook carga pero se ve roto.💡 Comprueba el resultado guardado cambiando el editor a la vista de código. Lo que ves ahí es lo que conservó la base de datos, no lo que pegaste.
Antes de cambiar nada, relaciona tu síntoma con la causa probable. Así te ahorras muchos clics al azar.
| Síntoma | Causa más probable | Primera solución a probar |
|---|---|---|
| El iframe desaparece tras guardar | Tu rol no tiene unfiltered_html | Inicia sesión como Administrador |
| Funciona con el admin, falla con el autor | Filtrado KSES para roles inferiores | Usa un shortcode o un bloque |
| El iframe aparece como texto plano | Pegado en un párrafo o en la pestaña visual | Usa un bloque HTML personalizado |
| El flipbook carga pero no hay pantalla completa | Atributos eliminados | Vuelve a añadir allowfullscreen en la vista de código |
| Recuadro en blanco solo en la página publicada | Plugin de seguridad o cabecera CSP | Revisa la configuración del plugin y de la cabecera |
| Falla solo en Multisite | No es Super Administrador | Pide ayuda al administrador de la red |
El error más común es pegar un iframe en un bloque de Párrafo normal. Gutenberg entonces trata el código como texto al que dar formato. El contenedor correcto es el bloque HTML personalizado.
⚠️ Si la página sigue sin mostrar nada tras guardar, lo más probable es que tu rol esté siendo filtrado. Pasa a la Solución 2.
Si tu sitio usa el Editor clásico, cambia de la pestaña Visual a la pestaña Texto antes de pegar. La pestaña Visual usa TinyMCE, que reescribe o elimina las etiquetas que no reconoce. Pega en la pestaña Texto, guarda y evita volver a Visual después, porque ese cambio puede volver a borrar el código.
Si el iframe desaparece para unas personas y no para otras, compara sus roles. Esto es lo que puede hacer cada rol predeterminado.
| Rol | Tiene unfiltered_html (un solo sitio) | Tiene unfiltered_html (Multisite) | ¿El iframe sobrevive? |
|---|---|---|---|
| Administrador | Sí | No | Un solo sitio: sí |
| Editor | Sí | No | Un solo sitio: sí |
| Autor | No | No | Normalmente se elimina |
| Colaborador | No | No | Se elimina |
| Super Administrador | No aplica | Sí | Sí |
La solución más sencilla es que un Administrador añada la incrustación una vez y luego deje que los Autores editen el texto que la rodea. El iframe guardado se mantiene intacto mientras nadie edite ese bloque concreto con una cuenta filtrada.
💡 Nunca des acceso de Administrador solo para arreglar una incrustación. Usa una opción más segura de las siguientes secciones.
Los shortcodes son la respuesta más limpia para los equipos. Un shortcode es un texto corto, como [flipbook id="123"], que WordPress convierte en HTML completo al cargar la página. Como el HTML se genera en el servidor, KSES nunca ve la etiqueta iframe en el contenido guardado.
Añade esto al archivo functions.php de tu tema hijo o, mejor aún, a un pequeño plugin personalizado:
add_shortcode( 'flipbook', function ( $atts ) {
$atts = shortcode_atts( array(
'url' => '',
'height' => '600',
), $atts );
if ( empty( $atts['url'] ) ) {
return '';
}
$url = esc_url( $atts['url'] );
$height = intval( $atts['height'] );
return '<iframe src="' . $url . '" width="100%" height="' . $height . '" frameborder="0" allowfullscreen loading="lazy"></iframe>';
} );
Ahora cualquier autor puede escribir [flipbook url="https://your-flipbook-link" height="650"] y el iframe aparece en la página publicada. El código escapa la URL, así que conservas la seguridad que WordPress pretendía.
Si necesitas mantener iframes sin procesar en el contenido de las entradas para roles inferiores, puedes ampliar la lista de etiquetas permitidas. Es una excepción acotada, no una eliminación completa del filtro.
add_filter( 'wp_kses_allowed_html', function ( $tags, $context ) {
if ( 'post' === $context ) {
$tags['iframe'] = array(
'src' => true,
'width' => true,
'height' => true,
'frameborder' => true,
'allowfullscreen' => true,
'loading' => true,
'title' => true,
);
}
return $tags;
}, 10, 2 );
⚠️ Esto permite que todos los roles con derechos de edición inserten cualquier iframe de cualquier dominio. En un sitio con muchos autores, restringe el acceso comprobando el host
srco prefiere el enfoque del shortcode.
Si no puedes editar código, un plugin que ofrezca un bloque o shortcode de iframe con una lista de dominios permitidos hace el mismo trabajo desde una pantalla de ajustes.
A veces el iframe se guarda perfectamente y aun así no se muestra. Eso apunta al navegador, no al editor.
Los plugins de cortafuegos y de endurecimiento pueden eliminar o bloquear iframes por su cuenta. Entre los desencadenantes habituales están:
Desactiva un plugin cada vez, borra la caché y vuelve a probar. Si el flipbook reaparece, abre la configuración de ese plugin y añade el dominio del flipbook a la lista de permitidos.
Una cabecera Content-Security-Policy con una regla frame-src o default-src indica a los navegadores qué dominios pueden aparecer en marcos. Si tu dominio de flipbook no aparece en la lista, el navegador muestra un recuadro en blanco aunque el HTML esté bien. Abre la consola de desarrollador del navegador y busca un mensaje que mencione "Refused to frame". Añade el dominio del flipbook a la regla frame-src en tu servidor o en tu plugin de seguridad.
| Dónde ocurre el bloqueo | Cómo detectarlo | Dónde solucionarlo |
|---|---|---|
| KSES de WordPress | Etiqueta ausente en la vista de código | Rol, shortcode o filtro |
| Editor (TinyMCE) | El código cambia tras cambiar de pestaña | Usa la pestaña Texto o HTML personalizado |
| Plugin de seguridad | Etiqueta guardada pero en blanco en la página | Lista de permitidos del plugin |
| Cabecera CSP | La consola dice Refused to frame | Cabecera del servidor o del plugin |
| Capa de caché | Página antigua tras editar | Purgar la caché |
No todos los casos necesitan un iframe. Elementor, Divi, Beaver Builder y otros creadores de páginas similares incluyen un widget de HTML o Incrustar que maneja código sin procesar sin pasar por KSES, porque el creador guarda el contenido en su propio formato. Si tu sitio ya usa uno, coloca el flipbook en ese widget.
Como alternativa rápida, enlaza un botón o una imagen de portada atractiva directamente a la URL pública del flipbook. Los lectores obtienen la experiencia completa de la página y evitas todos los filtros mencionados antes.
Este es el proceso completo, desde el PDF hasta una página publicada. La primera vez te llevará unos diez minutos.
Los flipbooks no llevan marcas de agua, son adaptables a dispositivos móviles y admiten marca propia en todos los planes. Las estadísticas, la generación de contactos y las descargas sin conexión forman parte del plan Professional, así que consulta los precios si los necesitas.
| Método | Habilidad necesaria | Sobrevive a cambios de rol | Ideal para |
|---|---|---|---|
| Bloque HTML personalizado | Baja | No | Páginas sueltas de administradores |
| Shortcode | Media | Sí | Equipos y muchas páginas |
| Filtro KSES | Media | Sí | Sitios con autores de confianza |
| Widget del creador de páginas | Baja | Normalmente | Sitios con Elementor o Divi |
| Botón de enlace directo | Ninguna | Sí | Opción rápida e inmune a filtros |
Un restaurante añade su menú como flipbook con el Creador de flipbooks de menú de restaurante. La dueña es Editora, así que un bloque HTML personalizado funciona. La asistente de marketing de medio tiempo es Autora, así que usa el shortcode al actualizar las páginas de temporada.
Una agencia inmobiliaria publica sus propiedades con el Creador de folletos inmobiliarios. Los agentes son Autores en el sitio de la empresa, y sus iframes seguían desapareciendo. Pasar a un único shortcode compartido solucionó el problema para todo el equipo.
Un equipo de marketing en Multisite descubrió que incluso los Administradores del sitio perdían sus incrustaciones. El administrador de la red añadió una excepción de iframes para el filtro, limitada al dominio del flipbook, y el problema dejó de ocurrir.
Una vez que el iframe se mantiene en su sitio, dedica dos minutos a la presentación.
✅ Pruébalo en un teléfono real. La mayoría de los lectores abrirá tu flipbook desde dispositivos móviles, y un ancho fijo en píxeles puede provocar desplazamiento lateral.
Guarda una versión en texto plano de tu código para incrustar en un lugar seguro. Si un filtro daña la versión guardada, puedes volver a pegarla en segundos.
Repasa esta lista cada vez:
Un iframe que desaparece casi siempre es un problema de permisos, no un problema del flipbook. Revisa el tipo de bloque, revisa el rol del usuario y luego revisa los plugins y las cabeceras, en ese orden.
¿Listo para convertir tu próximo PDF en una publicación limpia y lista para incrustar? Empieza gratis en Flipbooks AI, explora todas las herramientas de flipbook para encontrar la plantilla adecuada, o compara los planes y precios para elegir las funciones que necesita tu sitio.
Elige tu idioma
