この記事は最後に更新してから1年以上経過しています。

全投稿を取得するのはnopaging=1でいい

説明

query_posts関数(またはWP_Queryクラス)を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」-「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには?
query_posts関数において取得する件数を指定するパラメータはposts_per_pageがある(showpostsでもいい)。これはその名の通り1ページ分の投稿件数を指定するもので、例えば20件分を取得する場合は
query_posts( $query_string.'&posts_per_page=20' );
と記述すればいい(グローバル変数$query_stringの条件のまま、最大20件分の投稿情報を取得する)。
さて、ニュースのようなアーカイブページの場合、四半期分や一年分といった一定期間の投稿情報をすべて取得して表示したいケースがある。posts_per_pageの値として適当に大きな数値を指定してもいいのだが、全件を取得することを明示的に指定するなら
query_posts( $query_string.'&year=2011&nopaging=1' );
と記述すればいい。これで「1ページに表示する最大件数」の指定に関わらず、2011年の投稿情報がすべて取得できる。
またposts_per_pageの値に-1を指定しても同様の結果となる。
query_posts( $query_string.'&year=2011&posts_per_page=-1' );
これはquery_posts関数の内部では「posts_per_page=-1」の場合、「nopaging=1」と同じ意味に解釈されるためである。
query_posts関数のパラメータは実に種類が多い。その中には名前は違っても同じ(ような)意味のパラメータもいくつか存在しており、ちょっと紛らわしい。作ったテーマやプラグインは作者以外も見ることを考えると、できるだけ明示的でわかりやすい(と思う)記述に心がけたい。

最終更新 : 2011年08月31日 14:55


お勧め

determine_locale(2018年12月8日 更新)

string determine_locale()
リクエストに応じたロケールを取得する。

get_oembed_response_data_for_url(2018年12月7日 更新)

object|bool get_oembed_response_data_for_url( string $url, array $args )
URLからoEmbedレスポンスデータを取得する。

current_theme_supports(2018年10月19日 更新)

bool current_theme_supports( string $feature [ , mixed $args ] )
テーマ機能を取得する。

get_permalink(2018年5月27日 更新)

string get_permalink( [ int $id = 0 [ , bool $leavename = false ] ] )
現在の投稿情報(グローバル変数$post)または指定した投稿情報のパーマリンクを取得する。

get_post_permalink(2014年6月12日 更新)

string get_post_permalink( [ int $id = 0 [ , bool $leavename = false [ , bool $sample = false ] ] ] )
カスタム投稿タイプの投稿ページのパーマリンクを取得する。