Embed

Le block embed insère du code d'intégration tiers brut (une <iframe>, une carte, un lecteur vidéo, etc.) directement dans une page. Utilisez-le chaque fois que vous devez intégrer du contenu d'un service externe qui fournit son propre extrait HTML.

Comme ce block rend du HTML arbitraire sans échappement, l'éditeur d'administration affiche un avertissement de sécurité à côté du champ de code : ne collez que du code d'intégration provenant de sources de confiance.

Champs

Champ	Description	Requis ?
body_text	Le HTML d'embed/iframe à rendre, par ex. <iframe src="https://..." ...></iframe>.	Oui
heading	Légende facultative affichée au-dessus du contenu intégré. Exemple de placeholder : "Embedded map showing our office location".	Non
border_enabled	Case à cocher. Lorsqu'elle est cochée, dessine une bordure autour du contenu intégré.	Non
border_width	Épaisseur de la bordure (par ex. 2px), affichée uniquement lorsque border_enabled est cochée. Vaut 1px par défaut si laissée vide tout en étant activée.	Non
privacy_mode	Case à cocher. Lorsqu'elle est cochée, l'embed n'est pas chargé tant que le visiteur n'a pas cliqué sur un placeholder, au lieu d'être chargé automatiquement à la consultation de la page.	Non

Contrairement à la plupart des types de block, embed n'a pas de champs de couleur de fond, de couleur de texte, de padding ni de margin ; ses contrôles d'apparence se limitent à l'interrupteur et à la largeur de bordure ci-dessus.

Sécurité HTML

body_text est rendu sans échappement, par conception. C'est le seul champ de ce block destiné à contenir du HTML brut, puisque c'est là tout l'intérêt d'un extrait de code d'embed. Le heading (la légende) est échappé et rendu en texte brut.

Utilisation

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

Généralement placé sur une page "Contact" ou "Locations" (pour l'embed d'une carte), ou dans un article de blog pour intégrer une vidéo ou un widget interactif.

Exemple

Une page "Contact" intégrant une iframe de carte, avec une légende et une bordure légère, en utilisant le mode privacy afin que la carte tierce ne se charge pas (et ne dépose pas de cookies) tant que le visiteur n'a pas consenti :

Champ	Valeur
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	Coché
border_width	2px
privacy_mode	Coché

Avec privacy_mode activé, les visiteurs voient d'abord un placeholder "Click to load" à la place de la carte ; le HTML de l'iframe n'est inséré dans la page qu'après leur clic, ce qui évite de charger des traceurs tiers à chaque consultation de page.