この記事は最後に更新してから1年以上経過しています。
説明
WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近まで get_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。WP_Queryクラスはとても多機能であり、WordPressの投稿記事を検索・表示するための重要なクラスである。このWP_Queryクラスを使用した投稿記事の表示処理は、それほど特別なものではない。例えば'ニュース'というカテゴリーの最新投稿を5件取得する場合は、次のように記述する。
$apart_args = array(
'order' => 'DESC',
'posts_per_page' => 5,
'category_name' => 'ニュース'
);
$apart_posts = new WP_Query( $apart_args );
if ( $apart_posts->have_posts() ) :
// ここに投稿記事を表示する前のの処理を記述
while ( $apart_posts->have_posts() ) : $apart_posts->the_post();
// ここに投稿記事の表示処理を記述
endwhile;
// ここに投稿記事を表示した後の処理を記述
wp_reset_postdata();
else :
// ここで投稿記事が見つからなかった場合の処理を記述
endif;
上記の例は比較的単純な条件なのでget_posts関数でも実現可能だが、より詳細の条件を指定したい場合はget_posts関数では力不足になる。そんな時はこのWP_Queryクラスを使用する方法が適している。サイドバーやフッターなど、ページ中のパーツ要素として投稿記事を取得して表示する場合は、必要に応じてget_posts関数かWP_Queryクラスを使い分ければいい。WP_Queryクラスを使用する方法はそれなりにメモリーを消費しそうなので、サーバー環境を考慮して使い過ぎないように注意したほうがいいだろう。
余談になるが、query_posts関数の実行によってWP_Queryオブジェクトが生成され、グローバル変数$wp_queryに格納される。またhave_posts関数やthe_post関数は、$wp_queryの同名のメソッドを呼び出しているだけである。
最終更新 : 2011年08月01日 18:04
関連
お勧め
add_magic_quotes(2020年8月13日 更新)
array add_magic_quotes( array $array )
配列の文字列をスラッシュでクォートする。
wp_parse_id_list(2019年2月23日 更新)
array wp_parse_id_list( array | string $list )
IDのリストをパースする。
wp_mkdir_p(2014年11月27日 更新)
bool wp_mkdir_p( string $target )
ディレクトリを再帰的に作成する。
get_object_taxonomies(2018年5月27日 更新)
array get_object_taxonomies( mixed $object [ , string $output = 'names' ] )
投稿タイプのタクソノミー情報を取得する。
add_media_page(2022年6月27日 更新)
mixed add_media_page( string $page_title, string $menu_title, mixed string $capability, string $menu_slug [ , mixed $function = '' [, int $position = null ] ] )
メディアメニューにサブメニューを登録する。