WP_QueryはWordPressで定義されているクラスです。これにより、開発者はカスタムクエリを作成し、さまざまなパラメータを使用して投稿を表示できます。開発者はWordPressデータベースを直接クエリすることも可能です。しかし、WP_QueryはWordPressデータベースから投稿をクエリするための推奨される方法の1つです。
以下は、moviesカテゴリの投稿を表示する簡単なWP_Queryの例です。
<?php // The Query $the_query = new WP_Query( 'category_name=movies' ); ?>
上記のサンプルコードは、投稿を自動的に表示しません。クエリの結果を表示するには、ユーザーはWordPressループを使用する必要があります。このようになります:
<?php
// The Query
$the_query = new WP_Query( 'category_name=movies' );
// The Loop
if ( $the_query->have_posts() ) {
echo '<ul>';
while ( $the_query->have_posts() ) {
$the_query->the_post();
echo '<li>' . get_the_title() . '</li>';
}
echo '</ul>';
} else {
// no posts found
}
/* Restore original Post Data */
wp_reset_postdata();
?>
WP_Queryは強力なツールであり、より複雑で高度なクエリを作成するために使用できる多くのパラメータがあります。WP_Queryはネストされたループ(ループ内のWordPressループ)を作成するために使用できます。WordPress開発者は、プラグインやテーマで使用して、独自のカスタム投稿表示を作成できます。
WP_Queryパラメータの完全なリストは、WordPress Codexで入手できます。
