posts_per_pageがダッシュボードの設定よりも小さいときでも正しくページングさせる方法

投稿日 2012年9月6日
更新日 2013年1月4日
著者キタジマタカシ
カテゴリー WordPress

posts_per_pageの値が「1ページに表示する最大投稿数」よりも小さいとページングが正しく動作せず、「ページが見つかりません。」と表示されてしまう場合があります。とりあえず解決コードを。例を3パターンあげていますので、適当なものをfunctions.phpに記述します。

// 例1 : カスタム投稿タイプが「products」のときに表示件数を「9」に設定
add_filter( 'parse_query', 'parse_query' );
function parse_query( $query ) {
	if ( get_query_var( 'post_type' ) == 'products' ) {
		$query->set( 'posts_per_page', 9 );
	}
}

// 例2 : カスタムタクソノミーが「products_category」のときに表示件数を「9」に設定
add_filter( 'parse_query', 'parse_query' );
function parse_query( $query ) {
	if ( get_query_var( 'products_category' ) ) {
		$query->set( 'posts_per_page', 9 );
	}
}

// 例3 : カスタム投稿タイプが「products」のとき、もしくはカスタムタクソノミーが「products_category」のときに表示件数を「9」に設定
add_filter( 'parse_query', 'parse_query' );
function parse_query( $query ) {
	if ( get_query_var( 'post_type' ) == 'products' ) || get_query_var( 'products_category' ) ) {
		$query->set( 'posts_per_page', 9 );
	}
}

以下で、原因など解説します。

状況

カスタム投稿のアーカイブページを作成し、そのページだけ表示件数をようと思いposts_per_pageを設定したところ、2ページ目を表示したときに「ページが見つかりません。」になってしまいました。状況は下記の通りです。

カスタム投稿タイプ「products」を作成
「1ページに表示する最大投稿数」は10。

productsのアーカイブページのみ表示件数を9件にしたかったので、archive-products.phpの中に下記のコードを記述。

<?php
// archive-products.php
// もとのクエリの表示件数だけを上書き
query_posts( array_merge( $wp_query->query, array(
	'posts_per_page' => 9
) ) );
?>

登録されている記事数は10件。従って、ページングナビゲーションとして「1, 2」が表示される。
2ページ目へのリンクをクリックすると「ページが見つかりません。」

pagedが何らかの影響で上手くきいていないのかと思い、query_postsを下記のように変更。

<?php
$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;
query_posts( array_merge( $wp_query->query, array(
	'posts_per_page' => 9,
	'paged' => $paged
) ) );
?>

が、状況はかわらず。pagedは固定ページでカスタム投稿のアーカイブを作る場合などに使用するもので、設定忘れの場合は「常に1ページ目が表示される」という現象が起こるはずなので、解決しないのも当たり前か。

posts_per_pageの値が「1ページに表示する最大投稿数」よりも小さいとページングが正しく動作しない！？

同じような現象の方いないかググってみたところ、どうやら「posts_per_pageの値が「1ページに表示する最大投稿数」よりも小さいとページングが正しく動作しない」というのは定説らしい。

カテゴリの一覧ページで似た状況になったことがあります。
posts_per_pageの値が、ダッシュボードの表示設定の「1ページに表示する最大投稿数」よりも少ない場合に発生するかもしれません。
お試しください～

WordPress › フォーラム » トップページを固定ページにしたらページ送りができません。

このパラメータを使う時の注意点ですが、WordPressでは、管理画面の「設定」の「表示設定」の「1ページに表示する最大投稿数」と干渉しますので、もしこのパラメータを利用する場合は、「1ページに表示する最大投稿数」の値をposts_per_page=で指定する値より小さくする必要があります。

記事一覧を並び替えるquery_postsについて | たなブログ WordPress入門講座

「posts_per_pageの値が「1ページに表示する最大投稿数」よりも小さい」とダメなわけですから、解決方法として、「1ページに表示する最大投稿数を1にする」という方法が挙げられていました。そうすればposts_per_pageは必ず「1ページに表示する最大投稿数」より大きくなるわけだからページングはうまく動作するのでしょうが、どうにもダサい。他の一覧ページでもposts_per_pageを必ず指定しないといけなくなるし。