この記事は最後に更新してから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


お勧め

the_posts_navigation(2018年5月27日 更新)

void the_posts_navigation( [ array $args = array() ] )
投稿ページ向けのナビゲーションを表示する。

popuplinks(2016年4月22日 更新)

string popuplinks( string $text )
Aタグに別ウィンドウで開く属性を追加する

language_attributes(2018年11月16日 更新)

void language_attributes( [ string $doctype = 'html' ] )
HTMLまたはXHTMLのHTMLタグ属性を表示する。

add_management_page(2018年5月27日 更新)

mixed add_management_page( string $page_title, string $menu_title, mixed string $capability, string $menu_slug [ , mixed $function = '' ] )
ツールメニューにサブメニューを登録する。

wp_list_bookmarks(2018年5月27日 更新)

string wp_list_bookmarks( [ mixed $args = '' ] )
ブックマーク(管理画面の「リンク」)をパラメータ$argsのecho値が1ならば表示する。echo値が0ならばその文字列を取得する。