Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Dernière modification : 28 août 2025
Les blogs HubSpot sont constitués de pages de listing de blog et des articles de blog individuels. En plus de répertorier les articles de blog individuels, le modèle de listing de blog est également utilisé pour restituer les pages de listing d’auteur et de balise. Vous pouvez créer un modèle unique pour restituer toutes les pages de listing et d’article de blog ou créer deux modèles distincts.
Découvrez ci-dessous le balisage des modèles de blog, les composants des modèles et les options de personnalisation.
Créer un modèle commun pour les pages de listing et d’articles
Pour créer un modèle qui restitue les pages de listing et d’article, ajoutez l’annotationtemplateType: blog
en haut de votre fichier de modèle. Si vous utilisez un modèle pour restituer les deux, vous utiliserez une fonction if qui détermine si l’utilisateur consulte une page de listing ou un article individuel. Si vous utilisez les mises en page du gestionnaire de conception en glisser-déposer, cette fonction if
est intégrée à l’interface utilisateur des boutons de module de contenu du blog.
En utilisant l’instruction if is_listing_view
, vous pouvez écrire séparément le code de l’article et celui de la liste.
Créer des modèles de listing et d’articles distincts
Vous pouvez également choisir d’avoir des modèles distincts pour les articles de blog et les pages de listing, ce qui peut contribuer à rendre votre code plus propre et plus facile à lire en tant que développeur, tout en rendant les modèles plus faciles à sélectionner pour les créateurs de contenu. Plutôt que d’utiliser l’annotationtemplateType: blog
en haut d’un modèle, incluez les annotations suivantes en haut de vos deux modèles :
- Modèle d’article de blog :
templateType: blog_post
- Modèle de liste de blog :
templateType: blog_listing

is_listing_view
n’est pas nécessaire. Au lieu de cela, vous devez sélectionner manuellement des modèles distincts dans les paramètres de blog du compte.
Vous pouvez également migrer un modèle de blog unifié existant pour en faire un modèle d’article de blog ou un modèle de liste de blogs.
Modèles de pages de listing
L’annotationtemplateType: blog_listing
rend le modèle disponible pour la sélection dans les paramètres du blog, spécifiquement pour la vue de la liste. Avec ce type de modèle, les créateurs de contenu peuvent également modifier la page d’inscription dans l’éditeur de pages. En incluant également des zones de glisser-déposer dans le modèle, les modules peuvent être ajoutés et supprimés dans l’éditeur en glisser-déposer, comme c’est le cas pour les autres pages du CMS. Consultez les modèles de blog CMS boilerplate pour voir des exemples d’inclusion de zones de glisser-déposer.
La liste des articles est générée par une boucle for qui parcourt les articles de votre blog. contents
est une séquence prédéfinie de contenu qui contient tous les articles de ce blog.
Il est recommandé de faire en sorte que toutes les chaînes de texte de votre modèle de liste de blogs soient contrôlées par des champs. Cela facilite la création de blogs multilingues et donne plus de contrôle aux créateurs de contenu.
Créer un module de liste de blogs
Vous pouvez permettre aux créateurs de contenu de placer des modules sur le périmètre du contenu de la liste de blogs, par exemple sur les côtés, ou au-dessus et en dessous. Pour ce faire, il est recommandé de créer un module de liste de blogs qui utilise une boucle for liste de blogs. À titre d’exemple, consultez le module de liste de blog CMS boilerplate. Bien que HubSpot fournisse des paramètres de blog pour l’affichage de résumés et l’utilisation d’images en vignette, vous pouvez également intégrer ces fonctionnalités dans votre module. Cela permet aux créateurs de contenu de définir ces fonctionnalités dans l’éditeur de page, plutôt que dans les paramètres du blog.Pages d’auteur de blog, de balise et de liste simple
En plus des pages d’articles de blog et de listes de blogs, les blogs HubSpot ont également des pages pour les auteurs de blogs, les balises d’articles de blog et des pages de listes simples. Ces pages supplémentaires utilisent le même modèle que la page de listing du blog pour restituer leur contenu.Comme le modèle de page de liste est également partagé par la page d’auteur du blog, de balise et d’annonce simple, les mises à jour publiées sur le modèle s’appliqueront également à ces pages.
if
pour restituer le contenu de chaque type de page de manière conditionnelle.
Fonction if blog_author
Dans le balisage standard de listing de blog de HubSpot, il existe une instruction conditionnelleif blog_author
. Cette affirmation est considérée comme vraie lorsque l’on consulte la page d’un auteur, qui répertorie les articles publiés par l’auteur. Le modèle de boilerplate comprend le nom de l’auteur, sa biographie et ses comptes de réseaux sociaux.
Fonction if tag
Vous pouvez utiliser une instructionif tag
pour ne restituer le code que sur une page de liste de sujets de blog, que les visiteurs peuvent voir lorsqu’ils cliquent sur un sujet de blog sur votre site. L’exemple ci-dessous est un bloc de texte prédéfini qui utilise la variable de titre de page pour imprimer automatiquement le nom de la balise en haut d’une page de listing de balise.
Fonction if not simple_list_page
Il existe deux types de pages de liste de blogs qui peuvent être restituées pour afficher les articles de blogs : la page de liste ordinaire et la page de liste simple.- La liste ordinaire parcourt le nombre d’articles spécifié par le paramètre de blog de listing d’article et pagine en conséquence.
- Une liste simple est une liste de tous vos articles et ne prend pas en charge la pagination. La liste simple n’est pas affectée par le paramètre de limite d’articles de blog et contient généralement les liens vers les 200 articles de blog les plus récents. L’adresse de votre page de listing simple est l’URL de votre blog avec
/all
ajouté à la fin du chemin.
if not simple_list_page
pour déterminer ce qui doit être restitué dans une liste simple par rapport à une liste ordinaire. Une version simplifiée de cette instruction est présentée ci-dessous.
Notez que l’instruction
if
utilise la logique inverse, ce qui signifie que l’instruction else
définit la vue en liste simple. Vous pouvez éventuellement utiliser une fonction unless à la place.Pagination de listing
Les pages de listing de blog ont une pagination générée automatiquement. Votre modèle de listing peut inclure une logique permettant aux visiteurs de consulter facilement les articles de votre blog. Le blog de boilerplate permet une pagination simple et numérique grâce au balisage suivant :Balisage boilerplate
Ci-dessous, vous trouverez le balisage boilerplate des modèles d’article de blog et de page de liste de blogs. Vous pouvez également consulter ce balisage dans le boilerplate du CMS sur GitHub, comme indiqué dans chaque section.Balisage des modèles d’article
Tous les articles d’un blog sont générés par un seul modèle de blog.Content
est un objet de données prédéfini qui contient des informations sur l’article de blog demandé. Les articles de boilerplate sont restitués avec le balisage suivant :
content
.