La page du blog : articles, catégories et numéros de page

Ce que vous obtenez

<body wp-fields-group="Blog">
<header class="blog-hero">
  <h1 wp="post-title">From the blog</h1>
  <p class="blog-hero__lead" fld-area="Blog lead">Notes from the roastery: new beans, brewing tips and events.</p>
</header>
<nav class="blog-cats" wp-term-query="category">
  <a class="blog-cats__link" href="#" wp="term-link"><span wp="term-title">Coffee</span> <span class="blog-cats__count" wp="term-count">5</span></a>
</nav>
<div class="posts" wp="posts">
  <article class="post-card">
    <a href="#" wp="post-link"><img src="images/news.jpg" alt="" wp="post-image"></a>
    <p class="post-card__date" wp="post-date">October 1</p>
    <h3><a href="#" wp="post-title-link">New autumn menu</a></h3>
    <div class="post-card__text" wp="post-excerpt">Pumpkin latte is back, and so is the apple pie.</div>
  </article>
</div>
<div class="posts__empty" wp="no-results">No posts yet</div>
<div class="pagination" wp-paginate="mid_size=1&prev_text=Newer&next_text=Older"></div>
</body>

Étape par étape

1. Nommez le groupe de champs

   wp-fields-group sur le <body> de archive-post.html : ce fichier sert à générer le modèle de la page du blog.

   <body wp-fields-group="Blog">

2. Titre et introduction

   wp="post-title" au-dessus de la liste affiche le titre de la page « Blog », et fld-area est un champ de cette page. Le client les modifie comme une page ordinaire.

   <h1 wp="post-title">From the blog</h1>
   <p class="blog-hero__lead" fld-area="Blog lead">Notes from the roastery: new beans, brewing tips and events.</p>

3. Les catégories avec compteurs

   wp-term-query="category" parcourt les catégories du blog. Le premier élément sert de modèle : un lien wp="term-link", avec à l’intérieur le nom et le nombre d’articles (wp="term-title", term-count).

   <nav class="blog-cats" wp-term-query="category">
     <a class="blog-cats__link" href="#" wp="term-link"><span wp="term-title">Coffee</span> <span class="blog-cats__count" wp="term-count">5</span></a>
   </nav>

4. La liste des articles

   wp="posts" est la liste principale de la page : les articles du blog, dans l’ordre. À l’intérieur, une carte d’article ; à côté, un bloc wp="no-results" pour un blog encore vide.

   <div class="posts" wp="posts">
     <article class="post-card">
       <a href="#" wp="post-link"><img src="images/news.jpg" alt="" wp="post-image"></a>
       <p class="post-card__date" wp="post-date">October 1</p>
       <h3><a href="#" wp="post-title-link">New autumn menu</a></h3>
       <div class="post-card__text" wp="post-excerpt">Pumpkin latte is back, and so is the apple pie.</div>
     </article>
   </div>
   <div class="posts__empty" wp="no-results">No posts yet</div>

5. Les numéros de page

   wp-paginate sur un bloc vide placé après la liste ; les libellés « Newer » et « Older » se mettent dans la valeur de l’attribut.

   <div class="pagination" wp-paginate="mid_size=1&prev_text=Newer&next_text=Older"></div>

À retenir

• La page qui sert de blog et le nombre d’articles qu’elle affiche se règlent dans Réglages → Lecture : « Page des articles » et « Les pages du site doivent afficher au plus ».
• Les catégories sans articles n’apparaissent pas dans la liste.
• La page d’une seule catégorie est un modèle à part : voir la recette « Page de catégorie ».

Erreurs fréquentes

Le journal de génération est l’onglet « Journaux » de votre projet sur themeforge.pro ; la vérification gratuite du balisage affiche les mêmes remarques.

<div class="posts" wp="posts">
  <article class="post-card">
    <h3 wp="post-title">New autumn menu</h3>
  </article>
  <div class="pagination" wp-paginate="mid_size=1"></div>
</div>

<div class="posts" wp="posts">
  <article class="post-card">
    <h3 wp="post-title">New autumn menu</h3>
  </article>
</div>
<div class="pagination" wp-paginate="mid_size=1"></div>

<nav class="blog-cats" wp-term-query="category">
  <a href="#" wp="term-title">Coffee</a>
</nav>

<nav class="blog-cats" wp-term-query="category">
  <a href="#" wp="term-title-link">Coffee</a>
</nav>

Attributs de cette recette

Autres recettes