この記事は最後に更新してから1年以上経過しています。
説明
query_posts関数(またはWP_Queryクラス)を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」-「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには?query_posts関数において取得する件数を指定するパラメータはposts_per_pageがある(showpostsでもいい)。これはその名の通り1ページ分の投稿件数を指定するもので、例えば20件分を取得する場合は
query_posts( $query_string.'&posts_per_page=20' );
さて、ニュースのようなアーカイブページの場合、四半期分や一年分といった一定期間の投稿情報をすべて取得して表示したいケースがある。posts_per_pageの値として適当に大きな数値を指定してもいいのだが、全件を取得することを明示的に指定するなら
query_posts( $query_string.'&year=2011&nopaging=1' );
またposts_per_pageの値に-1を指定しても同様の結果となる。
query_posts( $query_string.'&year=2011&posts_per_page=-1' );
query_posts関数のパラメータは実に種類が多い。その中には名前は違っても同じ(ような)意味のパラメータもいくつか存在しており、ちょっと紛らわしい。作ったテーマやプラグインは作者以外も見ることを考えると、できるだけ明示的でわかりやすい(と思う)記述に心がけたい。
最終更新 : 2011年08月31日 14:55
関連
お勧め
get_userdata(2022年2月4日 更新)
mixed get_userdata( int $user_id )
ユーザIDを指定し、マッチするユーザ情報を取得する。
has_filter(2022年11月8日 更新)
mixed has_filter( $tag, [ mixed $function_to_check = false ] )
WordPressタグにフィルターが登録されているか調べる。
wp_add_object_terms(2013年8月6日 更新)
mixed wp_add_object_terms( int $object_id, mixed $terms, mixed $taxonomy )
投稿情報などにタクソノミーを追加する。
is_tag(2018年5月27日 更新)
bool is_tag( [ mixed $slug = '' ] )
要求されているページが、タグアーカイブページか調べる。
add_meta_box(2014年11月16日 更新)
void add_meta_box( string $id, string $title, string $callback, string $page [, string $context = 'advanced' [, string $priority = 'default' [, array $callback_args = null ] ] ] )
投稿ページに独自のメタボックスを表示する。