【WordPress】WP_Query（サブループ）の使い方とパラメータ一覧を紹介

if ( have_posts() ):
    while ( have_posts() ) : the_post();

    // コンテンツの表示処理（the_title()など） 

    endwhile;
endif;

// １．サブループの条件指定
$args = array(
    // ここに呼び出したい記事の条件パラメータを記述
);

// ２．サブループ用のクエリを生成＝記事情報を取得
$query = new WP_Query( $args );    // 変数名は任意
 
// ３．クエリを回して取得した記事を１件ずつ出力する
if ( $query->have_posts() ):
    while ( $query->have_posts() ) : $query->the_post();

    // コンテンツの表示処理（the_title()など） 

    endwhile;
endif;
 
// ４．投稿データのリセット
wp_reset_postdata();
?>

$args = array(
    'category_name'  => 'sample',  // カテゴリースラッグ「sample」を指定
    'post_type'      => 'post',    // 「投稿」を指定
    'posts_per_page' => 10,        // 表示件数を「10件」に指定
);

$query = new WP_Query( $args );
 
if ( $query->have_posts() ):
    while ( $query->have_posts() ) : $query->the_post();

        the_title();    //「投稿タイトル」を出力 
        the_content();  //「投稿本文」を出力 

    endwhile;
endif;
 
wp_reset_postdata();
?>

$args = array(
    'post_type'      => 'post',    // 「投稿」を指定
    'posts_per_page' => 10,        // 表示件数を「10件」に指定
    'order'          => DESC       // 「降順」に並び替え
    'orderby'        => date       // 「日付」順に並び替え
);

$query = new WP_Query( $args );
 
if ( $query->have_posts() ):
    while ( $query->have_posts() ) : $query->the_post();

        the_title();    //「投稿タイトル」を出力 
        the_content();  //「投稿本文」を出力 

    endwhile;
endif;
 
wp_reset_postdata();
?>

$args = array(
    'p' => 10,                                      // 投稿IDを指定
    'name' => 'post_sample',                        // 投稿スラッグを指定
    'page_id' => 10,                                // 固定ページのIDを指定
    'pagename' => 'page_sample',                    // 固定ページスラッグを指定
    'pagename' => 'parent/child_sample',            // 子ページを表示する場合「親のスラッグ/子のスラッグ」の形式で指定
    'post_parent' => 10,                            // 指定したページIDの子ページを検索
    'post_parent__in' => array( 10, 11, 12 ),       // 親ページIDを含む投稿を検索(配列)
    'post_parent__not_in' => array( 10, 11, 12 ),   // 親ページIDを含まない投稿を検索(配列)
    'post__in' => array( 10, 11, 12 ),              // 該当の投稿IDで検索(配列)
    'post__not_in' => array( 10, 11, 12 ),          // 該当の投稿IDを含まない投稿を検索(配列) 
);

$args = array(
    'cat' => 3,                              // カテゴリIDを指定
    'category_name' => 'sample01, sample02', // カテゴリのスラッグで指定(複数は","(カンマ)区切り）
    'category__and' => array( 1, 3 ),        // カテゴリIDを指定(配列)(該当のカテゴリIDで検索)
    'category__in' => array( 1, 3 ),         // カテゴリIDを指定(配列)(該当のカテゴリIDで検索)
    'category__not_in' => array( 2, 8 ),     // カテゴリIDを指定(配列)(該当のカテゴリIDを含まない記事ｗｐ検索)
);

$args = array(
    'tag' => 'sample',                                  // タグのスラッグを指定
    'tag_id' => 5,                                      // タグIDを指定
    'tag__and' => array( 2 , 6 ),                       // タグIDを指定(配列)(該当のタグIDで検索)
    'tag__in' => array( 2 , 6 ),                        // タグIDを指定(配列)(該当のタグIDで検索)
    'tag__not_in' => array( 2 , 6 ),                    // タグIDを指定(配列)(該当のタグIDを含まない記事を検索)
    'tag_slug__and' => array( 'sample01', 'sample02' ), // タグスラッグを指定(配列)(タグスラッグを含む記事を検索)
    'tag_slug__in' => array( 'sample01', 'sample02' ),  // タグスラッグを指定(配列)(タグスラッグを含む記事を検索)  
);

$args = array(
    // ひとつだけ指定する場合
    'post_type' => 'post';          // 投稿

    // 複数指定する場合は配列を使用
    'post_type' => array( 
            'post',                 // 投稿
            'page',                 // 固定ページ
            'revision',             // リビジョン
            'attachment',           // 添付ファイル
            'custom-post-type'      // カスタム投稿タイプのスラッグ
    ),

    // 全てのpost_typeを表示(revisionと'exclude_from_search'がtrueにセットされたものは除く)
    'post_type' => 'any',
);

$args = array(
    'order' => 'DESC',          // 'ASC'  昇順  1, 2, 3　　a, b, c
                                // 'DESC' 降順  3, 2, 1　　c, b, a
 
    'orderby' => 'date',        // デフォルト値'date' 

    // 複数指定も可能
    'orderby' => 'date title'
);

$args = array(
    // ひとつのタクソノミーを指定
    'tax_query' => array(
            array(
                'taxonomy' => 'sample',                 // タクソノミーのスラッグを指定
                'field' => 'slug',                      // term_id, name, slug のいずれかの検索対象のタームのフィールド
                'terms' => array( 'saitama', 'tokyo' ), // fieldに指定した検索対象フィールドの検索値(配列)
                'include_children' => true,             // 子孫タクソノミーを含めるかどうか
                'operator' => 'IN'                      // 'IN','NOT IN','AND','EXISTS','NOT EXISTS'が利用可能
            ),
    )

    //複数のタクソノミー条件は'AND'や'OR'で結ぶ
    'tax_query' => array(
        'relation' => 'AND',                            // タクソノミーの検索条件に 'AND' か 'OR'指定
            array(
                'taxonomy' => 'prefecture',
                'field' => 'slug',
                'terms' => array( 'saitama', 'tokyo' ),
                'include_children' => true,
                'operator' => 'IN'
            ),
            array(
                'taxonomy' => 'contry',
                'field' => 'id',
                'terms' => array( 122, 132, 141 ),
                'include_children' => false,
                'operator' => 'NOT IN'
            )
    )
);

$args = array(
    // ひとつのカスタムフィールドを指定する場合
    'meta_key' => 'key',                    // カスタムフィールドのキーを指定
    'meta_value' => 'value',                // カスタムフィールドの値を指定(文字列)
    'meta_value_num' => 10,                 // カスタムフィールドの値を指定(数字)
    'meta_compare' => '=',                  //「meta_value」に対する演算子（'!='、'>'、'>='、'<'、'='の５つが使用可能）
    'meta_query' => array(                  // カスタムフィールドのパラメーター
              array(
                   'key' => 'sample_k',     // カスタムフィールドのキー
                   'value' => 'sample_v',   // カスタムフィールドの値 (※compareの値が'IN'、'NOT IN'、'BETWEEN'、'NOT BETWEEN'のみ配列をサポート)
                   'type' => 'CHAR',        // カスタムフィールドの型
                   'compare' => '=',        // 演算子の指定
              ),
    ),

    // 複数のカスタムフィールド条件は'AND'や'OR'で結ぶ
    'meta_query' => array(
         'relation' => 'AND',               // カスタムフィールドの検索条件に 'AND' か 'OR'指定
              array(
                   'key' => 'sample_k',      
                   'value' => 'sample_v',      
                   'type' => 'CHAR',        
                   'compare' => '=',        
              ),
              array(
                   'key' => 'sample_k02',
                   'value' => array( sample_v01, sample_v02 ),
                   'compare' => 'NOT LIKE',
               )
    ),
);

$args = array(
    // ひとつだけ指定する場合
    'post_status' => 'publish',     // 公開状態

    // 複数指定する場合は配列を使用
    'post_status' => array(         // 投稿の状態を指定
            'publish',              // 公開状態
            'pending',              // レビュー待ち状態
            'draft',                // 下書き状態
            'auto-draft'            // コンテンツのない、新しく作成された投稿/ページを表示
            'future',               // 予約公開が設定された状態
            'private',              // ログインしたユーザーしか見れない状態
            'inherit',              // リビジョン
            'trash',                // ゴミ箱に入っている状態
     ),

    // すべての状態(post_statusで'exclude_from_search'がtrueにセットされたものは除く)
    'post_status' => 'any',
);

$args = array(
    'author' => '1,2,3',                            // 著者のユーザIDを指定
    'author_name' => 'kekenta',                     // user_nicenameを指定(ログイン名(user_login)ではないです)
    'author__in' => array( 2 , 6 ),                 // 該当のユーザーIDが含む記事で指定
    'author__not_in' => array( 2 , 6 ),             // 該当のユーザーIDを含まない記事で指定
);

$args = array(

    'date_query' => array(
         array(
            'year' => 2021,                 // 年を指定(2021など)
            'month' => 8,                   // 月を指定(1～12)
            'week' => 31,                   // 年内の週を指定(0～53)
            'day' => 5,                     // 月内の日を指定(1～31)
            'hour' => 2,                    // 時間を指定(0～23)
            'minute' => 3,                  // 分を指定(0～60)
            'second' => 36,                 // 秒を指定(0～60)
            'after' => array(               // 指定した日付以降の投稿を取得  →  「'after'=>'2020/02/28'」という指定も可能
                  'year'  => 2013,          // 年を指定(2013など) デフォルトは空
                  'month' => 2,             // 年内の月を指定(1～12) デフォルトは12
                  'day'   => 28,            // 月内の日を指定(1～31) デフォルトは月内の末日
             )
            'before' => array(              // 指定した日付以前の投稿を取得  →  「'before'=>'2020/02/28'」という指定も可能
                  'year'  => 2013,          
                  'month' => 2,             
                  'day'   => 28,            
             ),
            'inclusive' => true,            // ｢after｣or｢before｣で指定された値を含むかどうか
            'compare' => '=',               // '=', '!=', '>', '>=', '<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN', 'EXISTS' , and 'NOT EXISTS'が使用可能
            'column' => 'post_date',        // 照会するカラムを指定
        ),
    ),

    // 「期間」を指定する場合は'AND'や'OR'で結ぶ
　　'date_query' => array(
         'relation' => 'AND',
         array(
              'year'    => 2013,
              'month'   => 2,
              'compare' => '>='
         ),
         array(
              'year'    => 2013,
              'month'   => 8,
              'compare' => '<='
         ),
    ),
);
 

$args = array(
    'posts_per_page' => 10,             // 1ページに表示できる最大投稿数(「-1」は全て表示)
    'posts_per_archive_page' => 10,     // 1ページに表示できる最大投稿数(アーカイブページのみ)
    'nopaging' => false,                // ページ送りの有効/無効
    'paged' => 3,                       // ページ番号3の記事一覧を表示
    'paged' => get_query_var('paged'),  // 現在のページから投稿を表示
    'offset' => 10,                     // 設定した数だけ、ずらして表示(例では11番目の投稿から表示)
    'ignore_sticky_posts' => false,     // 先頭の固定表示投稿を無視するかどうか(false=先頭の固定表示投稿は無視しない)
);

$args = array(
    'has_password' => true,                         // パスワード付きの投稿を検索( true or false )
    'post_password' => 'birthday1111',              // 該当のパスワードが付いた投稿を検索
);