Balisage des modèles de blogs

Découvrez ci-dessous le balisage des modèles de blog, les composants des modèles et les options de personnalisation.

Pour créer un modèle qui restitue les pages de listing et d'article, ajoutez l'annotation templateType: blog en haut de votre fichier de modèle. Si vous utilisez un modèle pour restituer les deux, vous utiliserez une fonction Si 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.

Vous pouvez également choisir d'avoir un modèle distinct pour les pages d'article de blog et de listing. Ainsi, votre code est plus propre et plus facile à lire en tant que développeur, et les modèles sont plus faciles à sélectionner pour les créateurs de contenu. Le boilerplate du CMS comporte un modèle de listing et un modèle d'article distincts. Si vous créez des modèles d'article et de listing distincts, la vérification de is_listing_view n'est pas nécessaire. Vous devez simplement vous assurer de sélectionner les modèles distincts dans Paramètres > Site web > Blog > Modèles. 

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 contenus dans ce blog.

Le contenu de la page de listing de blog du boilerplate pour la boucle for est restitué avec le balisage suivant :

Dans le balisage standard de listing de blog de HubSpot, il existe une fonction if blog_author. Cette fonction aura la valeur true si vous consultez une page de listing d'auteur. Une page de listing d'auteurs est une page regroupant les articles d'un seul auteur. Le modèle de boilerplate comprend le nom de l'auteur, sa biographie et ses comptes de réseaux sociaux.

En plus de la fonction if blog_author qui définit le balisage qui doit être restitué uniquement sur les pages de listing d'auteur, il existe une variable tag qui peut être utilisée pour restituer le code uniquement sur une page de listing de thème de blog. 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. Ce bloc de texte prédéfini peut être ajouté au code de listing de blog.

Dans la boucle for, une fonction if détermine ce qui doit être restitué dans une liste simple par rapport à une liste ordinaire.

• 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.
• 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.

L'adresse de votre page de listing simple est l'URL de votre blog avec /all ajouté à la fin du chemin.

Le code suivant est une version simplifiée de cette fonction if qui définit ce qui doit être itéré dans une page de listing simple. Notez que la fonction if utilise une logique inverse ; par conséquent, la fonction else définit la vue de liste simple. Vous pouvez utiliser une fonction unless à la place.

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 :

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 :

Les informations sur l'auteur de l'article de blog sont également disponibles dans les données content.