A blog page: posts, categories and page numbers

What you get

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

Step by step

1. Name the field group

   wp-fields-group on the <body> of archive-post.html: it builds the blog page template.

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

2. Heading and intro

   wp="post-title" above the list shows the title of the “Blog” page, and fld-area is a field of that page. The client edits them like any page.

   <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. Categories with counts

   wp-term-query="category" goes through the blog’s categories. The sample is the first element: a wp="term-link" link with the name and the number of posts inside (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. The list of posts

   wp="posts" is the main list of the page, the blog’s posts in order. Inside is a post card, and next to it a wp="no-results" block for an empty blog.

   <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. Page numbers

   wp-paginate on an empty block after the list; the “Newer” and “Older” labels go in the attribute’s value.

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

What matters

• Which page is the blog and how many posts it shows is set in Settings → Reading: “Posts page” and “Blog pages show at most”.
• Categories without posts are left out of the list.
• A single category’s page is a separate template: see the category page recipe.

Common mistakes

The build log is the “Logs” tab of your project on themeforge.pro; the free markup check shows the same notes.

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

Attributes in this recipe

More recipes