Embed
El block embed inserta código de embed de terceros sin procesar (un <iframe>, un mapa, un reproductor de video y similares) directamente en una página. Úsalo siempre que necesites insertar contenido de un servicio externo que proporciona su propio fragmento de HTML.
Como este block renderiza HTML arbitrario sin escapar, el editor del backend muestra una advertencia de seguridad junto al campo de código: pega únicamente código de embed de fuentes en las que confíes.
Campos
| Campo | Descripción | ¿Obligatorio? |
|---|---|---|
body_text | El HTML de embed/iframe a renderizar, por ejemplo <iframe src="https://..." ...></iframe>. | Sí |
heading | Leyenda opcional mostrada encima del contenido insertado. Ejemplo de placeholder: "Embedded map showing our office location". | No |
border_enabled | Casilla de verificación. Cuando está marcada, dibuja un borde alrededor del contenido insertado. | No |
border_width | Grosor del borde (por ejemplo 2px), mostrado solo cuando border_enabled está marcada. De forma predeterminada es 1px si se deja en blanco mientras está habilitada. | No |
privacy_mode | Casilla de verificación. Cuando está marcada, el embed no se carga hasta que el visitante hace clic en un placeholder, en lugar de cargarse automáticamente al ver la página. | No |
A diferencia de la mayoría de los tipos de block, embed no tiene campos de color de fondo, color de texto, padding ni margin; sus controles de apariencia se limitan al interruptor y al ancho del borde anteriores.
Seguridad HTML
body_text se renderiza sin escapar, por diseño. Es el único campo de este block pensado para llevar HTML sin procesar, ya que de eso se trata un fragmento de código de embed. heading (la leyenda) se escapa y renderiza como texto plano.
Cómo usarlo
{{block:office-location-map}}Normalmente se coloca en una página de "Contacto" o "Ubicaciones" (para el embed de un mapa), o dentro de una entrada de blog para insertar un video o un widget interactivo.
Ejemplo
Una página de "Contacto" que inserta un iframe de un mapa, con una leyenda y un borde ligero, usando privacy mode para que el mapa de terceros no se cargue (ni establezca cookies) hasta que el visitante lo acepte:
| Campo | Valor |
|---|---|
body_text | <iframe src="https://maps.example.com/embed?q=..." width="600" height="450" loading="lazy"></iframe> |
heading | Embedded map showing our office location |
border_enabled | Marcada |
border_width | 2px |
privacy_mode | Marcada |
Con privacy_mode activado, los visitantes ven primero un placeholder de "Click to load" en lugar del mapa; el HTML real del iframe solo se inserta en la página después de que hacen clic en él, lo que evita cargar rastreadores de terceros en cada vista de página.