WordPressの投稿一覧にページ送りを付ける方法
｜WP Query Builderでpagedを設定

ページ送りは、記事を取る処理とリンクを出す処理に分かれる

投稿一覧の下に「1・2・3」というページ送りを表示するには、記事を取得する処理とリンクを表示する処理を、それぞれ用意する必要があります。WP Query Builderで作るのは記事の取得条件です。生成後のコードに、URLから現在ページを読み取る処理と、ページ送りのリンクを表示する処理を追加します。

ブロックエディターで一覧を作っている方は、Query Loopブロックのページネーションで実現できるかを先に確認してみてください。PHPを書かずに済む場合があります。

この記事のPHP例は、クラシックテーマのテンプレートに投稿一覧を追加する場合が対象です。 本番サイトを直接編集せず、バックアップを取った検証環境で試しましょう。

まだ一覧を作っていない方は、次の設定手順から進めてください。すでに実装していて困っている方は、後半の症状別の確認表から確認する場所を選べます。

作る一覧の表示場所・投稿タイプ・件数を決める

今回は、通常の固定ページに「公開済みの通常投稿を新しい順に5件ずつ」表示する一覧を作ります。WP Query Builderでは、2ページ目の条件を確認するためにpagedへ2を入力します。あとで、この固定値をURLに応じて変わる値へ置き換えます。

固定ページをサイトのホームページに指定している場合は、現在ページ番号を読み取る方法が異なります。まずは次の4項目を決め、どちらの設置先なのかを確認しましょう。

WP Query Builderで5件・2ページ目の条件を入力する

公開中のWP Query Builderで「詳細設定（全項目）」を選び、「全項目を開く」を押します。「基本設定」で投稿タイプをpost、公開状態をpublish、取得件数を5にします。「ページング / 並び順」のページ番号へ2を入力し、並び方向はDESC、並べ替えの基準はdateを選びます。読み飛ばす件数（offset）は空のままです。

次の画面では、取得件数が5、ページ番号が2になっていることを見てください。この2つは「2ページ目から5件取得する」という別々の指定です。

no_found_rowsはfalseを明示する

確認した公開中のWP Query Builderでは、自動高速化がONでno_found_rowsを未指定にすると、生成コードへ’no_found_rows’ => trueが補われます。総件数や総ページ数を使わない一覧では有効な設定ですが、paginate_links()で総ページ数を使うページ送りには向きません。

ページ送りでは総ページ数が必要なので、「総件数の取得を省略」（no_found_rows）をfalseにします。「Performance / Cache」（性能・キャッシュ設定）を開いて変更してください。手動で選んだfalseは自動高速化より優先されます。

設定する場所が分かったら、WP Query Builderで同じ条件を入力してみましょう。生成したコードのpagedを現在ページの変数へ置き換える手順は、この後で説明します。

生成されたコードを確認し、pagedの固定値を置き換える

次は、2026年9月6日に公開中のWP Query Builderで上の設定を入力し、生成結果をそのままコピーしたコードです。キャッシュ関連の自動設定も省略していません。pagedが2なので、このまま実行すると常に2ページ目の投稿を取得します。

$args = array(    'post_type' => 'post',    'post_status' => 'publish',    'posts_per_page' => 5,    'paged' => 2,    'order' => 'DESC',    'orderby' => 'date',    'no_found_rows' => false,    'ignore_sticky_posts' => true,    'update_post_meta_cache' => false,    'update_post_term_cache' => false,    'lazy_load_term_meta' => false);

生成した’paged’ => 2を残すと、何ページ目を開いても2ページ目の投稿を取得します。 実装では、URLから読み取った現在ページ番号を$current_pageへ入れ、’paged’ => $current_pageへ置き換えます。取得条件の配列はこの1行だけを変更し、前後に現在ページの取得と表示処理を追加します。全体のコードは、この後で紹介します。

生成コードに表示処理を加えたら、本番と分けたWordPress環境でページ送りを試します。検証や公開に使うサーバーをこれから用意する方は、XserverのPHP対応・バックアップ・料金も確認できます。

日本語の物語でも条件を読み返してみる

コードの下にある「日本語の物語」では、同じ条件を文章でも確認できます。今回なら「通常投稿」「公開済み」「2ページ目」「5件」「公開日の降順」が出てくるので、入力したつもりの条件と合っているか読み返してみましょう。少し遊び心のある説明ですが、実際の投稿を取得した結果ではありません。動作は次のコードをWordPressで実行して確かめます。

通常のテンプレートでページ送りまで実装する

次は、生成した$argsの’paged’ => 2だけを’paged’ => $current_pageへ置き換え、現在ページの取得、投稿を表示するループ、ページ送り、投稿データのリセットを追加したコードです。自動で出力されたキャッシュ設定は残しています。今回はタイトルとリンクだけを表示しますが、画像・カテゴリー・カスタムフィールドを追加するときは、必要な先読み設定も見直してください。

子テーマのtemplate-parts/paginated-post-list.phpへ保存し、通常の固定ページを表示するpage.phpなどからget_template_part( ‘template-parts/paginated-post-list’ );で1回呼び出します。呼び出す場所は、固定ページの本文を出すメインループを終えた後など、一覧を表示したい位置です。すでに一覧がある場合は置き換え、二重に表示しないようにしてください。PHPを投稿エディターへ貼り付ける例ではありません。

次のコードにはPHP開始タグが付いています。新規ファイルならそのまま保存し、既存のPHP内へ追加するときは先頭の<?phpを除きます。page.phpから呼び出す1行もPHPの内側へ記述してください。

<?php$current_page = max( 1, absint( get_query_var( 'paged', 1 ) ) ); $args = array(    'post_type' => 'post',    'post_status' => 'publish',    'posts_per_page' => 5,    'paged' => $current_page,    'order' => 'DESC',    'orderby' => 'date',    'no_found_rows' => false,    'ignore_sticky_posts' => true,    'update_post_meta_cache' => false,    'update_post_term_cache' => false,    'lazy_load_term_meta' => false); $post_list = new WP_Query( $args ); if ( $post_list->have_posts() ) {   echo '<ul class="post-list">';    while ( $post_list->have_posts() ) {      $post_list->the_post();      printf(         '<li><a href="%1$s">%2$s</a></li>',         esc_url( get_permalink() ),         esc_html( get_the_title() )      );   }    echo '</ul>';    $pagination = paginate_links(      [         'total'   => $post_list->max_num_pages,         'current' => $current_page,         'type'    => 'list',      ]   );    if ( $pagination ) {      echo '<nav aria-label="投稿一覧のページ送り">';      echo wp_kses_post( $pagination );      echo '</nav>';   }} else {   echo '<p>表示できる記事がありません。</p>';} wp_reset_postdata();

最初のget_query_var( ‘paged’, 1 )は、WordPressがURLから読み取ったページ番号を取得する処理です。値がないときは第2引数の1を使います。absint()で0以上の整数へ整え、max()で最低でも1になるようにしています。

paginate_links()のtotalには、この独自WP_Queryが持つmax_num_pagesを渡します。currentには、取得条件のpagedへ渡したものと同じ$current_pageを使います。typeをlistにすると、ページ番号がul要素の一覧として返ります。最後のwp_kses_post()は、WordPressの記事本文で許可されるHTMLだけを残して出力する処理です。

投稿を取得するときとリンクを出すときで、同じ現在ページ番号と、同じクエリの総ページ数を使います。 参照先を混ぜると、表示中の記事とページ送りの現在位置がずれます。

固定フロントページではpageへ切り替える

通常の固定ページでは、上のコードのget_query_var( ‘paged’, 1 )を使います。一方、「設定 → 表示設定」で固定ページをホームページに指定し、そのホームページへ一覧を置く場合は、get_query_var( ‘page’, 1 )から番号を読み取ります。WP_Queryの取得条件へ渡すキーは、どちらもpagedのままです。

上のテンプレートパーツをfront-page.phpから呼ぶ場合は、パーツの先頭にある$current_pageの1行だけを次へ置き換えます。$argsを作る前に置き、元の行と重ねて書かないでください。

$current_page = max( 1, absint( get_query_var( 'page', 1 ) ) );

pageとpagedを推測で混ぜず、表示設定と実際のテンプレートを確認してください。通常ページで動くコードを固定フロントページへ移した後に2ページ目が同じになる場合は、最初にここを見直します。

1ページ5件で、最終ページまで表示を確かめる

23件の投稿を5件ずつ表示すると、1〜4ページ目は5件、最後の5ページ目は残り3件になります。次はWordPress 7.1／PHP 8.4.20のローカル環境で、本文と同じ日付降順の条件を使った結果です。IDは共通サンプルサイトの値なので、ご自身のサイトでは異なります。

同じ2ページ目の条件でno_found_rowsだけをtrueへ変更すると、5件は取得できても、found_postsとmax_num_pagesはどちらも0になりました。投稿が表示されるだけでは、総ページ数を使うページ送りの確認は終わりません。WP Query Builderではfalseを指定し、実装後に総ページ数も確認してください。

まずは先頭ページです。5件の記事と、現在ページ1を示すページ送りが表示されています。

最終ページでは記事が3件になり、現在ページが5へ移ります。「前へ」は残り、「次へ」がなくなるところまで見てください。

WP Query Builderで設定することと、実装後に確認すること

WP Query Builderでコードを生成できても、ページ送りのリンクや設置先が自動で用意されるわけではありません。まずは今回のように絞り込みを増やさず、5件ずつ取得してページを移動できるところまで試しましょう。その後にカテゴリーなどの条件を1つずつ加えると、どの変更で結果が変わったかを確認しやすくなります。

うまく動かないときは、症状から確認場所を選ぶ

完成コードを何度も足し引きするより、症状を一つに絞ると原因を見つけやすくなります。

2ページ目が同じになる、リンクが出ない、404になる場合は、次の記事で症状に合う確認手順をご覧ください。

公開前の確認は、1ページ目だけで終わらない

実装や公開へ進む前に、見落としやすい項目をまとめて確認します。

WP_Queryのページ送りに使う公式資料

WP_QueryではPagination Parametersのposts_per_page、paged、page、offsetと、結果のfound_posts・max_num_pagesを確認します。現在ページはget_query_var()、リンク生成はpaginate_links()を別に開くと、どの値がずれているか追いやすくなります。

URLに合わせて記事とページ番号が切り替われば完成

最後は実際にリンクを押し、1ページ目・2ページ目・最終ページで記事と現在ページの表示が一緒に切り替わることを確かめましょう。ページ数が多い場合はリンクの途中が省略されるため、画面に見えるリンクの個数だけでは判断しないでください。