【WordPress】全記事一覧ページを作成する方法｜ページテンプレート・ページネーション対応

<?php
/*
Template Name: 全記事一覧
*/
get_header();

$paged = max(1, get_query_var('paged')); // 1ページ目は0が返るため1に

$query = new WP_Query(array(
  'post_type'      => 'post',
  'posts_per_page' => 20,  // 全件(-1)にせず件数を指定
  'paged'          => $paged,
));

if ($query->have_posts()) :
  echo '<ul class="all-posts-list">';
  while ($query->have_posts()) : $query->the_post();
    echo '<li>';
    echo '<h2><a href="' . esc_url(get_permalink()) . '">' . esc_html(get_the_title()) . '</a></h2>';
    the_excerpt(); // the_content() ではなく抜粋を表示
    echo '</li>';
  endwhile;
  echo '</ul>';

  // the_posts_pagination() はグローバル$wp_queryしか見ないため、
  // 固定ページ(メインクエリのmax_num_pagesは常に1)ではpaginate_links()を使う
  echo paginate_links(array(
    'total'    => $query->max_num_pages, // このカスタムクエリの総ページ数
    'current'  => $paged,
    'mid_size' => 2,
  ));
  wp_reset_postdata(); // サブループ後は必ずリセット
else :
  echo '<p>記事が見つかりませんでした。</p>';
endif;

get_footer();
?>