WordPressでコンテンツごとにアーカイブページの表示件数を変更するベストな方法

システム開発 / 2015.05.18

WordPressでコンテンツごとにアーカイブページの表示件数を変更するベストな方法

#WordPress

例えば、WordPressをお使いで、お知らせ一覧ページでは１０件表示させたいけど、商品一覧ページでは１ページに多くの情報を表示させたいので３０件表示させたい・・・など思ったことはありませんか？

コンテンツごとに表示件数を設定する方法は幾つかありますが、その中でも「これはいいな！」と思った方法を今回ご紹介させていただきたいと思います。

WordPressで、すべてのアーカイブページ共通の最大件数を設定する場合は、管理画面＜設定＞→＜表示設定＞の「1ページに表示する最大投稿数」で変更を行うことができます。

しかし、管理画面で設定をした１ページ内の最大表示件数は、すべてのアーカイブページ共通の最大表示件数の設定になるので、コンテンツによって表示される最大件数を異なる件数に設定する場合は少し工夫が必要になってきます。

よく使われる方法としては、テーマファイルのループ前に以下のような「query_posts」関数を呼び出して表示件数を強制的に書き換えてしまう説明をよく見かけます。

<?php
query_posts('&posts_per_page=10');
if (have_posts()) : while (have_posts()) : the_post();　← ループスタート
?>

<?php

query_posts('&posts_per_page=10');

if (have_posts()) : while (have_posts()) : the_post();　← ループスタート

ですが、冷静にWordPressが裏側で行っている処理の順序を追っていくと（下図参照）、ループ前でquery_postsを呼び出してしまうと結果的にDBへのアクセスが増えることになるので、あまりいい方法とは言えないかもしれません。できれば無駄なDBへのアクセスを避けたいものです。これでは、せっかくCSSスプライトや無駄のないJSを書いて少しでもパフォーマンスを改善しようとしても、ループ前に無駄な処理が増えてしまうので本末転倒といったところでしょうか。

下図は、ページにアクセスがあった際のWordPressの処理の流れを簡単にまとめたものです。

先程のソースコードは、query_posts()を使って最大表示件数を１0件に設定した場合のコードになりますが、上図の３の処理の場面で赤文字の箇所に該当します。表示件数を変更したいだけなのに、わざわざDBへ再アクセスしなければいけないのは、一度締めたドアをまた開けて中に入るみたいですっきりしなくありませんか？

では、どう対応するのか？

一番いい方法は、表示するコンテンツの内容（投稿タイプなど）に応じて、管理画面のデフォルトで設定されている表示件数を下図の１の段階で事前に変更してしまう方法があります。この方法を使うと、下図１の段階で表示件数の設定を書き換えて処理が進んでいくので、query_posts()を使うことなく、無駄なDBへのアクセスを減らすことができます。

下の例は「投稿」のカテゴリーアーカイブページの表示件数を５件にした場合のコードです。使用方法は、function.phpへ以下のコードを張り付けます。

function change_posts_per_page($query) {
    if ( is_admin() || ! $query->is_main_query() )
        return;

    if ( $query->is_archive() ) { /* アーカイブページの時に表示件数を5件にセット */
        $query->set( 'posts_per_page', '5' );
    }
}
add_action( 'pre_get_posts', 'change_posts_per_page' );

function change_posts_per_page($query) {

if ( is_admin() || ! $query->is_main_query() )

return;

if ( $query->is_archive() ) { /* アーカイブページの時に表示件数を5件にセット */

$query->set( 'posts_per_page', '5' );

}

add_action( 'pre_get_posts', 'change_posts_per_page' );

WordPressは、アーカイブページならば「is_archive()」、カテゴリーアーカイブならば「is_category()」といったように、閲覧しているページの種類によって条件分岐をかけることができるのはご存知かと思います。代表的なものとしては以下のような条件分岐がありますが、アーカイブページならば10件、ポストタイプならば30件のように分岐をさせる場合は、6行目から8行目の部分を条件に合わせて増やしていきます。

function change_posts_per_page($query) {
    if ( is_admin() || ! $query->is_main_query() )
        return;

    /* アーカイブページの時に表示件数を10件にセット */
    if ( $query->is_archive() ) {
        $query->set( 'posts_per_page', '10' );
    }
    /* ポストアーカイブの時に表示件数を30件にセット */
　 if ( $query->is_post_type_archive() ) {
        $query->set( 'posts_per_page', '30' );
    }
    /* 検索ページの時に表示件数を20件にセット */
    if ( $query->is_search() ) {
        $query->set( 'posts_per_page', '20' );
    }
}
add_action( 'pre_get_posts', 'change_posts_per_page' );