WordPressの「1ページに表示する最大投稿数」の設定方法（反映されない時の対処法も紹介）

WordPressの「設定」 >「表示設定」には、「1ページに表示する最大投稿数」のオプションが存在します。こちらは、記事一覧の表示件数を変更する際に使用します。

1ページに表示する最大投稿数オプション

この記事では、

「1ページに表示する最大投稿数」の基本的な使い方
1ページに記事を全件表示する方法
「1ページに表示する最大投稿数」が反映されない時の対処法
記事の表示件数をページ毎に変更する方法

について解説していきます。

「1ページに表示する最大投稿数」とは？

冒頭で述べた通り、アーカイブページ等で1ページに表示する記事の数を変更する際に使用します。

初期値は「10」ですので、WordPressのインストール後に変更していなければ、1ページに表示される記事数は10件となります。こちらを「6」に変更すると、下記のように、1ページあたり6件表示されるようになります。（参考ページ：TCDテーマ「NULL」）

表示件数の違い

1ページに全ての記事を表示させる方法

「1ページに表示する最大投稿数」に設定できる値は、1以上の整数のみです。それでは、1ページに全ての記事を表示したければ、公開済みの記事数を上回る数を入力する必要があるのでしょうか？

上記の方法でも可能ですが、WordPressの「すべての設定」から簡単に設定できます。まずは、下記のURLにアクセスしてください。

【あなたのサイトのURL】/wp-admin/options.php

上記は、WordPressの様々なデータを一覧で閲覧できるページにアクセスできるURLです。項目が多いですが、ページ内にある下記の「posts_per_page」オプションに「-1」と入力し、「変更を保存」を押してください。

optionsページのpost_per_pageオプション

これで1ページに全ての記事が表示されるようになります。（ページャー等を表示させたくない方向けです。）

「1ページに表示する最大投稿数」が反映されない

テーマのPHPファイルで記事数を制御していることが原因と考えられます。

WordPressの記事一覧は、基本的にテーマファイル側で記事数を決めます。この記事数が優先されるため、「1ページに表示する最大投稿数」が反映されなくなってしまうんですね。

対処方法としては、テーマファイルに該当する記述を見つけて削除するか、数値を上書きするかになります。WordPressやPHPの専門的な知識が必要ですので、社内の開発者等に確認してもらいましょう。

なお、既存テーマの場合は、部分的に「1ページに表示する最大投稿数」に代わるオプションが別途用意されていることが多いです。マニュアルの確認やサポートに問い合わせるのがいいかもしれません。

ページ毎に表示件数を変更したい

「1ページに表示する最大投稿数」は、一括反映される仕様のため、特定のページだけ記事数を変更する等はできません。とある条件に応じて、記事数を変更したい場合は、下記を参考にテーマファイルのカスタマイズを行いましょう。

add_action( 'pre_get_posts', function( $query ){
  if ( is_admin() || ! $query->is_main_query() ) {
    return;
  }
  if ( is_search() ) {
    $query->set( 'posts_per_page', 15 );
    return;
  }
});

上記は、検索結果ページのみ、表示する記事数が15件になるカスタマイズです。他にも条件を足したい場合は、WordPressの条件分岐タグを使うとよいでしょう。

なお、既存テーマにこの記述を追加する場合は、アップデート作業を楽にするために、子テーマのfunctions.phpやCode snippets等をオススメします。

2019.08.31

2020.02.28

「functions.php」ファイルの直接編集が不要になるプラグイン「Code Snippets」

2020/02/28 情報を更新いたしました。 WordPressの「functions.php」ファイルは記述を間違えるとエラーが出てしまったりして、初心者にとってあまり触りたくないファイルですよね。また、テーマの色々な独自の機能を追加していると、テーマのアップデート時にうっかり消えてしまう...