Shortcode web_iframe
El shortcode web_iframe incrusta una página de confianza usando el contenedor de iframe del tema y su política de carga. Sigue disponible cuando la administración de Page Builder está deshabilitada. Los editores de Gutenberg pueden usar el bloque Iframe.
Los atributos siguientes coinciden con los controles actuales de Page Builder y con la salida pública. Usa la sintaxis sin procesar solo para contenido revisado que no pueda mantenerse mediante los controles visuales.
Uso
[web_iframe url="https://example.org/embed" width="100%" height="480" additional_attrs='title="Embedded service"']Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
url |
— | URL web HTTP(S) o relativa | Documento de origen. Los esquemas vacíos o no compatibles no producen salida. Usa la URL de incrustación del proveedor. |
width |
100% |
Cadena, salvo que se indique lo contrario | Introduce solo el número para píxeles o la unidad porcentual para el ancho relativo (p. ej., 100%). |
height |
800 |
Cadena, salvo que se indique lo contrario | Introduce solo el número para píxeles o la unidad porcentual para la altura relativa (p. ej., 100%). |
iframe_loading |
lazy |
lazy, eager, auto |
Lazy usa el reproductor existente del tema cuando Advanced → Lazy Load está habilitado. Eager carga de inmediato. Auto omite el analizador del tema y suprime el atributo HTML de carga; no emite loading="auto". |
iframe_fetchpriority |
— | high, low, auto |
Usa high solo para iframes situados en la parte superior de la página. La prioridad high fuerza la carga eager. |
additional_attrs |
— | Atributos permitidos entre comillas | Incluye un title descriptivo. Admite allow, allowfullscreen, allowpaymentrequest, credentialless, frameborder, fullscreen, marginheight, marginwidth, name, referrerpolicy, sandbox, scrolling, tabindex, title y atributos descriptivos aria/data. El origen, el ID, las dimensiones, la carga, la prioridad y las clases no se pueden anular. Los eventos, el CSS en línea y srcdoc se rechazan. Las comillas invertidas dobles pueden sustituir a las comillas dobles. |
custom_class |
— | Cadena, salvo que se indique lo contrario | Controla las clases css adicionales. |
device_visibility |
— | Cadena, salvo que se indique lo contrario | Aplica la regla de visibilidad adaptable seleccionada. |
el_id |
— | ID HTML único válido | ID opcional en el elemento iframe. |
Verificación
Revisa el destino, el título y las dimensiones, también en móvil. Los títulos vacíos o ausentes reciben la alternativa “Embedded content”; es preferible un título descriptivo escrito por el autor. La prioridad high fuerza la carga eager incluso con auto seleccionado. La compatibilidad de los navegadores con las indicaciones de prioridad de iframe varía.
El contenido incrustado puede contactar con su proveedor, y la carga diferida no es un mecanismo de consentimiento. Siguen aplicándose el sandbox, el consentimiento del visitante y las propias políticas de incrustación del proveedor. El shortcode no omite las restricciones de encuadre ni añade un script u hoja de estilos de iframe independiente.