Passer au contenu principal
Cette page est un guide de référence complet de la syntaxe et des paramètres disponibles pour toutes les balises HubL standard, y compris les balises pour les pages système, telles que la page d’abonnement aux e-mails. Chaque balise ci-dessous contient un exemple de la syntaxe de base ainsi qu’un exemple avec des paramètres et une sortie de code. Si vous créez des zones de glisser-déposer, découvrez en davantage sur les balises des zones de glisser-déposer. Si vous gérez un site web plus ancien, vous pouvez également consulter la liste des balises HubL obsolètes.
La plupart des balises de cette page ont des équivalents dans les modules par défaut. Les modules peuvent être utilisés dans dnd_areas et des colonnes flexibles, ce qui les rend plus puissants et plus conviviaux que les balises que vous voyez ici.

Commentaires de blog

Restitue le code d’intégration des commentaires sur un modèle de blog, y compris les commentaires eux-mêmes et le formulaire de commentaire. Découvrez-en davantage sur la personnalisation des paramètres de commentaires de blog et des formulaires dans la base de connaissances.

Contenu du blog

Si les mises en page en glisser-déposer comprennent un module de contenu de blog, ces modules ne sont pas créés avec une seule balise. Ils utilisent plutôt une logique conditionnelle pour définir le rendu d’un article de blog et d’une liste de blogs. Découvrez-en davantage sur le codage des modèles de blog ici.

Filtre d’article de blog

Crée une liste associée d’articles par thème, par mois ou par auteur.

Remarque :

Ce module ne peut être utilisé que dans les modèles d’articles de blog.

Listing d’article de blog

Ajoute une liste des articles les plus populaires ou les plus importants.

Remarque :

Cette balise ne peut être utilisée que dans les modèles d’articles de blog. Le contenu de la balise est chargé de manière asynchrone côté client. Par conséquent, si vous souhaitez manipuler le flux après son chargement, vous devrez définir une fonction JS globale pour gérer cette manipulation. Utilisez la fonction hsPostListingComplete(feeds), où feeds est le sélecteur jQuery sur tous les flux qui ont été finalisés. Vous souhaiterez manipuler directement l’objet DOM dans cette fonction.

Articles de blog connexes

Ajoute une liste d’articles de blog basée sur un ensemble de paramètres partagés par les articles entre les blogs. Les articles sont sélectionnés en fonction de leur pertinence par rapport aux paramètres définis. Cette balise ne génère pas de module modifiable au niveau de la page/de l’article. Elle est entièrement configurée avec HubL.
Il est vivement recommandé d’utiliser le paramètre callback au lieu de post_formatter pour améliorer la vitesse de chargement des pages.

Exemples

L’exemple qui suit génère un listing d’articles rédigés par l’un des trois blog_authors indiqué sur deux blogs différents :
L’exemple qui suit génère un listing de 10 articles associés à un article de blog spécifique, avec la balise « développement des ventes » dans une période de publication spécifique. Cet exemple indique le paramètre blog_post_ids. Il sera donc utilisé sur une page :
L’exemple qui suit génère un listing de cinq articles à l’aide du paramètre callback pour contrôler la sortie HTML du listing d’articles :

Partage du blog sur les réseaux sociaux

Le partage de blogs sur les réseaux sociaux restitue les compteurs de partages sur vos articles de blog (si cette option est activée dans les paramètres de contenu).

Abonnement au blog

Une balise d’abonnement au blog restitue le formulaire d’abonnement au blog pour un blog particulier. Ce formulaire est automatiquement créé chaque fois qu’un blog est créé dans les paramètres de contenu. Un formulaire d’abonnement est associé par blog. Notez que les champs du formulaire d’abonnement sont configurés dans l’interface utilisateur de l’éditeur de formulaire.

Booléen

Une balise booléenne crée une case à cocher dans l’interface utilisateur qui affiche « vrai » ou « faux ». Outre l’impression de la valeur, ce module est utile pour définir une logique de modèle conditionnel, lorsqu’il est combiné avec le paramètre export_to_template_context.

Choix

Une balise de choix crée une liste déroulante dans l’interface utilisateur de l’éditeur de contenu qui imprime la valeur sélectionnée par l’utilisateur. Les balises de choix sont idéales pour donner à vos utilisateurs un ensemble d’options prédéfinies, comme l’impression du type de page dans un en-tête de page. Outre l’impression de la valeur du choix, cette balise est utile pour définir une logique de modèle conditionnel, lorsqu’elle est combinée avec le paramètre export_to_template_context.

Couleurs

La balise de couleur génère un sélecteur de couleur dans l’interface utilisateur de l’éditeur de page qui imprime une valeur de couleur hex dans un modèle. Notez que ce module ne peut être utilisé que dans les modèles, et pas dans les fichiers CSS. Si vous utilisez cette balise dans un élément <style> ou dans une CSS intraligne, vous souhaiterez utiliser le paramètre no_wrapper=True pour supprimer l’encadrement <span>.

CTA

Une balise call-to-action ou CTA permet aux utilisateurs d’ajouter un bouton call-to-action HubSpot à une zone prédéfinie d’une page.
*Si ces paramètres sont inclus ici par souci d’exhaustivité, le code généré par HubSpot pour les renseigner est très spécifique. Si vous avez besoin d’un CTA sélectionné par défaut, plutôt que d’essayer de développer les paramètres du CTA à partir de zéro, il est recommandé de configurer le CTA sur un modèle de mise en page, puis de le cloner dans le fichier. Vous pouvez ensuite copier le module HubL du CTA avec tous les paramètres correctement définis pour vous.Il existe également une fonction CTA qui génère un CTA à partir de l’ID.

HTML personnalisé

Un module HTML personnalisé permet aux utilisateurs de saisir du HTML brut dans l’éditeur de contenu. Si vous devez ajouter du HTML par défaut à la balise, vous pouvez utiliser la syntaxe de bloc.

Modules personnalisés

Les modules personnalisés permettent aux concepteurs de HubSpot de créer un groupe personnalisé d’objets de contenu modifiables à utiliser dans les modèles et les pages du CMS de HubSpot, tout en permettant aux responsables marketing de contrôler le contenu spécifique apparaissant dans ces modules, page par page. Découvrez-en davantage sur les modules personnalisés et leur syntaxe HubL simplifiée ici. Les modules personnalisés doivent être créés dans l’éditeur de modules personnalisés, mais ils peuvent être inclus dans les modèles codés et les modules HubL. Bloc d’utilisation s’affichera dans la barre latérale droite de l’éditeur de module personnalisé, sous Utilisation du modèle. Les modules personnalisés nécessitent l’ID du module sous forme de chaîne de caractères ainsi qu’un paramètre de chemin d’accès afin de préciser le module à charger. Le bloc d’utilisation comprendra également un paramètre de libellé. Consultez la syntaxe ci-dessous :

Variables d’éditeur

Pour restituer un contenu de variable pour un module dans l’éditeur, vous pouvez ajouter un contenu par défaut aux champs de module ou utiliser la balise HubL editor_placeholder. Cette balise peut être utile lorsque le module n’a pas de contenu par défaut ou n’en a pas besoin, ou pour simplifier la création du module.
module-placeholder-content
Pour ajouter une variable d’éditeur à un module personnalisé, ajoutez d’abord une fonction if au code HTML du module afin d’afficher la variable lorsqu’aucun contenu n’est sélectionné dans l’éditeur. Par exemple, le code suivant peut être utilisé pour ajouter une variable d’éditeur à un module CTA :
La première instruction conditionnelle if indique si le module est présent. Ensuite, l’instruction conditionnelle elif indique si le module est rendu dans le contexte de l’éditeur à l’aide de la variable is_in_editor.Cette variable renvoie true si le contenu est en cours de rendu dans n’importe quel éditeur de contenu, mais vous pouvez être plus spécifique avec d’autres variables d’éditeurs et de prévisualisation intégrées à l’application.
Ensuite, définissez le contenu de la variable dans le fichier du module meta.json.

Colonne flexible

Les colonnes flexibles sont des colonnes verticales dans un modèle qui permettent aux créateurs de contenu d’insérer et de supprimer des modules sur la page à l’aide de l’éditeur de contenu. Lorsque vous codez une colonne flexible avec HubL, vous pouvez choisir d’encadrer d’autres modules HubL pour qu’ils apparaissent par défaut dans la colonne flexible. L’exemple de code ci-dessous illustre la syntaxe de base et un exemple de colonne flexible avec un module de texte enrichi et de formulaire contenu par défaut. Notez que les colonnes flexibles ne peuvent être ajoutées qu’aux modèles de page, et pas aux modèles de blog ou d’e-mail. Les modules ne peuvent pas contenir de colonnes flexibles, mais peuvent contenir des champs et des groupes reproductibles, qui offrent une fonctionnalité similaire.

Remarque :

Lors de l’utilisation de cette balise, l’élément label doit respecter la valeur name pour que la colonne flexible fonctionne dans l’éditeur de contenu. Par exemple, la syntaxe suivante n’est pas valide :[% widget_container label="My label" "my_flexible_column" %}

Formulaire

Permet aux utilisateurs de sélectionner un formulaire HubSpot à ajouter à leur page. Le code ci-dessous inclut un exemple d’utilisation de la syntaxe de balise HubL standard et un exemple d’utilisation de la syntaxe de bloc.

Pied de page

Restitue les informations de droits d’auteur avec l’année et le nom de l’entreprise indiqués dans les paramètres d’e-mail marketing du compte.

Galerie

Génère une balise de galerie HubSpot. Cette balise de galerie est basée sur Slick. Alors que vous pouvez créer un module de galerie avec la syntaxe de module HubL standard, si vous souhaitez prédéfinir des diapositives par défaut en utilisant HubL, vous devez utiliser la syntaxe de bloc. Les deux méthodes sont présentées ci-dessous. Les images de la galerie sont chargées de manière asynchrone à l’aide de JavaScript.

En-tête

Génère un module d’en-tête qui restituera le texte sous forme de balise h1-h6.

Icône

Ajoute une balise d’icône qui permet aux utilisateurs de sélectionner une icône à utiliser. Les ensembles d’icônes pris en charge sont les suivants : FontAwesome 5.0.10, 5.14.0 et 6.4.2. Cette balise ne peut pas être utilisée dans les modules conçus pour les e-mails.

Image

Crée une balise d’image qui permet aux utilisateurs de sélectionner une image dans l’éditeur de contenu. Si vous souhaitez que l’image soit liée à une URL de destination, vous devez utiliser linked_image ci-dessous.

Source d’image

Un module de source d’image crée un sélecteur d’image dans l’éditeur de contenu, mais plutôt que d’imprimer une balise img, il restitue l’URL de l’image. Cette balise est généralement utilisée avec le paramètre no_wrapper=True, de sorte que la source de l’image puisse être ajoutée à une CSS intraligne ou à d’autres balises. Une alternative à l’utilisation de cette balise est d’utiliser le paramètre export_to_template_context.

Sélecteur de langue

Ajoute une icône de globe avec des liens vers les versions traduites d’une page de CMS donnée. Découvrez-en davantage sur le contenu multilingue ici.

Image liée

Crée une image sélectionnable par l’utilisateur qui est encadrée par un lien. Cette balise possède tous les paramètres d’un module image avec deux paramètres supplémentaires qui précisent l’URL de destination du lien et si le lien s’ouvre dans une nouvelle fenêtre.
Une balise de logo restitue le logo de votre entreprise à partir des paramètres du kit de marque du compte.
Génère un menu avancé basé sur une arborescence de menu dans Paramètres du contenu > Menus avancés. Consultez Menus et navigation pour plus d’informations sur l’utilisation des menus dans les modèles et les modules. Si la valeur id est définie sur null, la balise menu restituera le menu par défaut du compte HubSpot.

Require_css

Une balise HubL qui met en file d’attente un élément de style à restituer dans l’élément <head>. Cette balise est similaire à la fonction require_css, sauf qu’elle insère un style intraligne plutôt qu’à partir d’une feuille de style. Cette balise ne se déduplique pas non plus par rapport à d’autres instances de la CSS sur la même page. Si vous créez un module et que vous souhaitez insérer une feuille de style, mais que vous pouvez utiliser ce module plusieurs fois sur une seule page, vous pouvez utiliser la fonction require_css à la place.

Require_head

Une balise HubL qui met en file d’attente tout ce qui est placé à l’intérieur dans standard_header_includes qui se trouve dans le <head> du modèle. Pour la plupart des Javascript et CSS, consultez require_js et require_css. Parmi les cas d’utilisation de require_head figure la fourniture de méta-balises et de balises de liens spéciaux (comme prefetch et preconnect) à partir de modules.

Require_js

Une balise HubL qui met en file d’attente un élément de script à restituer. Pour mettre en file d’attente un script à restituer dans <head /> à partir d’un fichier différent via un élément <script /> (et non intraligne comme indiqué ici), utilisez plutôt la fonction HubL require_js(absolute_url).

Texte enrichi

Crée un éditeur de contenu WYSIWYG.

Listing RSS

Charge une liste de contenu à partir d’un flux RSS interne ou externe.

Remarque :

Ce module se charge de manière asynchrone côté client. Par conséquent, si vous souhaitez manipuler le flux après son chargement, vous devrez définir une fonction JS globale pour gérer cette manipulation. Utilisez la fonction hsRssFeedComplete(feeds), où feeds est le sélecteur jQuery sur tous les flux qui ont été finalisés. Vous pouvez directement manipuler l’objet DOM dans cette fonction.

En-tête de section

Génère un en-tête HTML et un sous-titre <p>.
Les menus simples vous permettent de créer des menus de navigation de base qui peuvent être modifiés au niveau de la page. Contrairement aux modules de menu ordinaires, les menus simples ne sont pas gérés à partir de l’écran de navigation dans les paramètres du site web, mais à partir des éditeurs de modèle et de page. Vous pouvez utiliser la syntaxe de bloc pour configurer une arborescence de menu par défaut.

Partage sur les réseaux sociaux

Les balises de partage sur les réseaux sociaux génèrent des icônes de réseaux sociaux qui peuvent être utilisées pour partager une page particulière. Ce module peut être utilisé avec la syntaxe de bloc pour personnaliser les images des icônes et plus encore.

Espacement

Une balise spacer génère une balise span vide. Cette balise peut être stylisée pour servir d’espacement. Dans les mises en page par glisser-déposer, le module d’espacement est encadré dans un conteneur dont la classe est span1-span12 afin de déterminer l’espace que le module doit occuper dans la grille adaptative à douze colonnes.

Balises de page système

Les balises suivantes peuvent être utilisées sur les pages système, telles que les pages de réinitialisation du mot de passe ou d’abonnement aux e-mails.

Désabonnement à la sauvegarde des e-mails

La page de désabonnement alternative s’affiche lorsque HubSpot ne parvient pas à identifier l’adresse e-mail du destinataire d’un e-mail qui cherche à se désabonner. Cette balise restitue un formulaire permettant au contact de saisir son adresse e-mail pour se désabonner des communications par e-mail. Elle doit être utilisée sur un modèle système de désabonnement alternatif.

Abonnements aux e-mails

Ce module s’affiche lorsqu’un destinataire d’un e-mail cherche à modifier ses préférences d’abonnement. Il doit être utilisé sur un modèle système de préférences d’abonnement.

Confirmation des abonnements aux e-mails

La confirmation des abonnements aux e-mails est un module qui peut être ajouté au modèle de remerciement lorsqu’un destinataire met à jour ses préférences d’abonnement ou se désabonne. Il doit être utilisé sur un modèle système de préférences d’abonnement.

Connexion des membres

Crée un formulaire de connexion pour donner accès à un contenu privé.

Inscription des membres

Crée un formulaire permettant de s’inscrire pour accéder à un contenu privé.

Demande de réinitialisation du mot de passe

Crée un formulaire pour envoyer un e-mail de réinitialisation de mot de passe pour l’accès aux pages protégées par un mot de passe.

Réinitialisation de mot de passe

Affiche un formulaire de réinitialisation de mot de passe pour accéder aux pages protégées par mot de passe.

Invite de mot de passe

Ajoute une invite de mot de passe pour les pages protégées par un mot de passe.

Texte

Crée une seule ligne de texte. Cette balise peut être utile pour être intégrée à votre balisage, lorsqu’elle est utilisée conjointement avec le paramètre no_wrapper=True. Par exemple, si vous souhaitez que vos utilisateurs finaux puissent définir la destination d’une ancre prédéfinie, vous pouvez renseigner l’élément href avec un module de texte ayant la forme no_wrapper=True.

Zone de texte

Une zone de texte est similaire à un module de texte dans la mesure où elle permet aux utilisateurs de saisir du texte brut, mais elle leur offre une plus grande zone dans l’éditeur de contenu. Ce module ne prend pas en charge le HTML. Si vous souhaitez l’utiliser directement à l’intérieur d’une balise d’encadrement prédéfinie, ajoutez le paramètre no_wrapper=true.

Lecteur vidéo

Restituez un lecteur vidéo pour un fichier vidéo à partir du gestionnaire de fichiers dont le paramètre Autoriser l’intégration, le partage et le suivi est activé.
Dernière modification le 10 février 2026