Embed

O bloco embed insere código de embed bruto de terceiros (um <iframe>, um mapa, um player de vídeo e similares) diretamente em uma página. Use-o sempre que precisar incorporar conteúdo de um serviço externo que forneça seu próprio trecho de HTML.

Como este bloco renderiza HTML arbitrário sem escape, o editor de administração exibe um aviso de segurança ao lado do campo de código: cole apenas código de embed de fontes em que você confia.

Campos

Campo	Descrição	Obrigatório?
body_text	O HTML de embed/iframe a ser renderizado, por exemplo <iframe src="https://..." ...></iframe>.	Sim
heading	Legenda opcional exibida acima do conteúdo incorporado. Exemplo de placeholder: "Embedded map showing our office location".	Não
border_enabled	Caixa de seleção. Quando marcada, desenha uma borda ao redor do conteúdo incorporado.	Não
border_width	Espessura da borda (ex. 2px), exibida apenas quando border_enabled está marcada. O padrão é 1px se deixada em branco enquanto habilitada.	Não
privacy_mode	Caixa de seleção. Quando marcada, o embed não é carregado até que o visitante clique em um placeholder, em vez de carregar automaticamente na visualização da página.	Não

Diferentemente da maioria dos tipos de bloco, o embed não tem campos de cor de fundo, cor do texto, padding ou margin; seus controles de aparência se limitam à opção de borda e à largura acima.

Segurança de HTML

body_text é renderizado sem escape, por design. É o único campo deste bloco destinado a conter HTML bruto, já que esse é justamente o propósito de um trecho de código de embed. heading (a legenda) é escapado e renderizado como texto simples.

Como usar

{{block:office-location-map​}}

Normalmente posicionado em uma página "Contact" ou "Locations" (para um embed de mapa), ou dentro de um post de blog para incorporar um vídeo ou widget interativo.

Exemplo

Uma página "Contact" incorporando um iframe de mapa, com legenda e uma borda leve, usando o modo de privacidade para que o mapa de terceiros não seja carregado (nem defina cookies) até que o visitante opte por isso:

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

Com privacy_mode ativado, os visitantes primeiro veem um placeholder "Click to load" no lugar do mapa; o HTML real do iframe só é inserido na página depois que clicam nele, o que evita carregar rastreadores de terceiros a cada visualização de página.