めっちゃ参考になるページを見つけた。
絞り込みをするたびに色々ググっていたが、これがあればほとんどのことが解決できそうな気がする。
参考: これは便利!WordPressのWP_Queryでよく使うコードスニペット | それからデザイン スタッフブログ
下記、参考ページから、ほぼまるっと抜粋。
ちなみに、特定の投稿IDのみを指定するとき、その投稿がカスタム投稿の場合は、p だけではなく、post_type も指定する必要があるので注意。
<?php
$args = array(
// 特定の「著者」に関連付けられた投稿を表示する場合
'author' => '1,2,3', // 著者IDを指定
'author_name' => 'solecolor', // user_nicenameを指定(名前ではありません)
'author__in' => array(2, 6), // 著者IDを配列で指定(著者IDを含む記事を絞り込む)
'author__not_in' => array(2, 6), // 著者IDを配列で指定(著者IDを含まない記事を絞り込む)
// 特定の「カテゴリー」に関連付けられた投稿を表示する場合
'cat' => 5, // カテゴリーIDを指定
'category_name' => 'daily, news', // カテゴリースラッグを指定(複数の場合は「,」で区切る)
'category__and' => array(2, 6), // カテゴリーIDを配列で指定(カテゴリーIDを含む記事を絞り込む)
'category__in' => array(2, 6), // カテゴリーIDを配列で指定(カテゴリーIDを含む記事を絞り込む)
'category__not_in' => array(2, 6), // カテゴリーIDを配列で指定(カテゴリーIDを含まない記事を絞り込む)
// 特定の「タグ」に関連付けられた投稿を表示する場合
'tag' => 'cooking', // タグスラッグを指定
'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('red', 'blue'), // タグスラッグを配列で指定(タグスラッグを含む記事を絞り込む)
'tag_slug__in' => array('red', 'blue'), // タグスラッグを配列で指定(タグスラッグを含む記事を絞り込む)
// 特定の「タクソノミー」に関連付けられた投稿を表示する場合(以下は複数のタクソノミーにてAND検索)
'tax_query' => array( //タクソノミーパラメーターを指定
'relation' => 'AND', // タクソノミーの検索条件に 'AND' か 'OR' が使用可能
array(
'taxonomy' => 'color', // タクソノミーを指定
'field' => 'slug', // term_id(デフォルト),name,slug のいずれかのタームの種類を選択
'terms' => array('red', 'blue'), // ターム(文字列かIDを指定)
'include_children' => true, // 階層を持つタクソノミーの場合に、子孫タクソノミーを含めるかどうか
'operator' => 'IN' // 演算子'IN','NOT IN','AND','EXISTS'(4.1.0以降),'NOT EXISTS'(4.1.0以降)が利用可能
),
array(
'taxonomy' => 'actor',
'field' => 'id',
'terms' => array(103, 115, 206),
'include_children' => false,
'operator' => 'NOT IN'
)
),
// 特定の「投稿&固定ページ」に関連付けられた投稿を表示する場合
'p' => 1, // 投稿IDを指定。 post_typeはデフォルト'post'。
'name' => 'hello-world', // 投稿スラッグを指定
'page_id' => 1, // 固定ページのIDを指定
'pagename' => 'sample-page', // ページスラッグを指定
'pagename' => 'contact_us/canada', // 子ページを表示する場合、スラッシュ区切りで親と子のスラッグを指定
'post_parent' => 1, // ページIDを指定した子ページを表示
'post_parent__in' => array(1, 2, 3), // 配列の親ページIDを含む投稿を表示
'post_parent__not_in' => array(1, 2, 3), // 配列の親ページIDを含まない投稿を表示
'post__in' => array(1, 2, 3), // 配列の投稿IDを含む投稿を表示
'post__not_in' => array(1, 2, 3), // 配列の投稿IDを含まない投稿を表示
// 特定の「パスワード」に関連付けられた投稿を表示する場合
'has_password' => true, // パスワード付きの投稿を表示(true or false)
'post_password' => 'zxcvbn', // 特定のパスワードが付いた投稿を表示
// 特定の「タイプ」に関連付けられた投稿を表示する場合(一つの場合)
'post_type' => 'post', // 投稿
'post_type' => 'page', // 固定ページ
'post_type' => 'revision', // リビジョン
'post_type' => 'attachment', // 添付ファイル
'post_type' => 'custom-post-type', // カスタム投稿タイプ or カスタム投稿名
// 特定の「タイプ」に関連付けられた投稿を表示する場合(複数の場合)
'post_type' => array(
'post', // 投稿
'page', // 固定ページ
'revision', // リビジョン
'attachment', // 添付ファイル
'custom-post-type' // カスタム投稿タイプ or カスタム投稿名
),
'post_type' => 'any', // すべてのタイプを含めて表示(リビジョンと'exclude_from_search'がtrueにセットされたものを除く)
// 特定の「投稿ステータス」に関連付けられた投稿を表示する場合
'post_status' => array( //投稿ステータスを指定 (デフォルト'publish')
'publish', // 公開された投稿、または固定ページを表示
'pending', // レビュー待ちの投稿を表示
'draft', // 下書きの投稿を表示
'auto-draft' // コンテンツのない、新しく作成された投稿を表示
'future', // 予約公開設定された投稿を表示
'private', // ログインしていないユーザーには見えない投稿を表示
'inherit', // リビジョンを表示
'trash', // ゴミ箱に入った投稿を表示
),
'post_status' => 'any', // すべてのステータスを表示(投稿タイプで'exclude_from_search'がtrueにセットされたものを除く)
// ページ送りパラメーターを設定する場合
'posts_per_page' => 10, // 1ページあたりに表示する投稿数を指定(-1を指定するとすべての投稿を表示)
'posts_per_archive_page' => 10, // 1ページあたりに表示する投稿数(アーカイブページのみ)
'nopaging' => false, // ページ送りを使用するか、すべての投稿を表示するか、(デフォルトはfalseでページ送りを使用)
'paged' => 6, // ページ番号6の記事を表示
'paged' => get_query_var('paged'), // 現在のページから投稿を表示
'offset' => 3, // 設定した数だけ、ずらして表示(例では4番目の投稿から表示)
'ignore_sticky_posts' => false, // 先頭固定表示投稿を無視するかどうか(デフォルト値は0で先頭固定表示投稿を無視しない)
// 「投稿の並び順」を指定する場合
'order' => 'DESC', // 'ASC' 昇順 (1, 2, 3; a, b, c)
// 'DESC' 降順 (3, 2, 1; c, b, a)
'orderby' => 'date', // デフォルト値'date' 複数のオプションを渡すことが可能
// 例:'orderby' => 'menu_order title'
// その他のオプション
// 'none' 並び替えなし
// 'ID' 投稿IDで並び替え
// 'author' 著者で並び替え
// 'title' タイトルで並び替え
// 'name' Order by post name(post slug)
// 'modified' 更新日で並び替え
// 'parent' 親ページIDで並び替え
// 'rand' ランダム順
// 'comment_count' コメント数で並び替え
// 'menu_order' ページの表示順で並び替え
// 'meta_value' アルファベット順で並び替え(数値ではうまくいかない)
// 'meta_value_num' 数値で並び替え
// 'post__in' post__inで配列で指定された投稿IDの並び順を維持して表示
// 特定の「時間や日付の期間」に関連付けられた投稿を表示する場合
'year' => 2015, // 4桁の年を数字で指定(2015など)
'monthnum' => 4, // 月を数字で指定(1~12)
'w' => 25, // 年内の週を数字で指定(0~53)
'day' => 17, // 月内の日を数字で指定(1~31)
'hour' => 13, // 時間を数字で指定( 0~23 )
'minute' => 19, // 分を数字で指定(0~60)
'second' => 30, // 秒を数字で指定(0~60)
'm' => 201404, // 年と月を数字で指定 (201508など)
// 「○年○月○日から○年○月○日の範囲の投稿情報」を表示する場合(投稿日の検索が自由自在!)
'date_query' => array(
array(
'year' => 2015, // 4桁の年を数字で指定(2015など)
'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' => 'January 1st, 2013', // 指定した日付以降の投稿を取得。strtotime()と互換性のある文字列で'after'=>'2015/08/31'などでもOK
'before' => array( //指定した日付以前の投稿を取得。strtotime()と互換性のある文字列で'before'=>'2015/08/31'などでもOK
'year' => 2013, // 4桁の年を数字で指定(2015など) デフォルトは空
'month' => 2, // 年内の月を数字で指定(1~12) デフォルトは12
'day' => 28, // 月内の日を数字で指定(1~31) デフォルトは月内の末日
),
'inclusive' => true, //「after」または「before」パラメーターで指定された値を含むかどうか
'compare' => '=', // 使用可能な値は '=', '!=', '>', '>=', '<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN', 'EXISTS', and 'NOT EXISTS'
'column' => 'post_date', // 照会するカラムを指定。デフォルトは「post_date」
'relation' => 'AND', // OR または AND デフォルトは「AND」
),
),
// 特定の「カスタムフィールド」に関連付けられた投稿を表示する場合
'meta_key' => 'key', // カスタムフィールドのキーを指定
'meta_value' => 'value', // カスタムフィールドの値を指定
'meta_value_num' => 10, // カスタムフィールドの値を指定
'meta_compare' => '=', //「meta_value」をテストする演算子。使える値は'!='、'>'、'>='、'<'、'=' デフォルト値は'='
'meta_query' => array( //カスタムフィールドパラメーター
'relation' => 'AND', // 「AND」または「OR」を指定。meta_query内の配列が「2つ以上」の場合に限る。meta_query配列が1つの場合は使用しない。
array(
'key' => 'color', // カスタムフィールドのキー。
'value' => 'blue', // カスタムフィールドの値 (注意 compareの値が'IN'、'NOT IN'、'BETWEEN'、'NOT BETWEEN'のみ配列をサポート)
'type' => 'CHAR', // カスタムフィールドタイプ。タイプについては以下の「meta_queryで使えるデータ型」参照
'compare' => '=', // 演算子を指定 デフォルト値は'=' 演算子の種類については以下「meta_queryで指定できる演算子の種類」参照
),
array(
'key' => 'price',
'value' => array(1,200),
'compare' => 'NOT LIKE',
)
),
// 適切な権限を持っているユーザーのプライベートの記事を表示する場合
'perm' => 'readable' // 使える値は’readable’と’editable’
// キャッシュ系のパラメーター
'cache_results' => true, // 投稿情報をキャッシュするかどうか デフォルトはtrue
'update_post_term_cache' => true, // 投稿タームキャッシュを更新するかどうか デフォルトはtrue
'update_post_meta_cache' => true, // 投稿メタキャッシュを更新するかどうか デフォルトはtrue
'no_found_rows' => false, // カウントをスキップする? tureでパフォーマンスが向上する可能性があるかも デフォルトはfalse
// 検索系のパラメーター
's' => $s, // 検索からクエリーストリング値を渡します。
'exact' => true, //タイトル/投稿の全体から正確なキーワードで検索するか デフォルト値はfalse
'sentence' => true, //語句(フレーズ検索)で検索するか デフォルト値はfalse
// 投稿フィールドパラメーター
'fields' => 'ids' //1つのフィールドで返すか全てのフィールドで返すか デフォルトでは全てのフィールドが返される
// 使用できる値
// 'ids' 投稿のIDの配列を返します
// 'id=>parent' 連想配列を返します
);
$the_query = new WP_Query($args);
if ($the_query->have_posts()):
while ($the_query->have_posts()): $the_query->the_post();
// 何かしらの処理
endwhile;
endif;
wp_reset_query(); // 投稿データのリセット
?>
meta_queryで使えるデータ型
データ型 | 内容 |
---|---|
CHAR | 文字 |
NUMERIC | ‘SIGNED’の別名 |
DECIMAL | 浮動小数点数 |
SIGNED | 整数(符号あり) |
UNSIGNED | 整数(符号なし) |
DATE | 日付 |
DATETIME | 日時 |
TIME | 時刻 |
BINARY | バイナリー |
meta_queryで指定できる演算子の種類
比較演算子 | 内容 |
---|---|
= | 値と一致する |
!= | 値と一致しない |
> | 値より大きい |
>= | 値以上 |
< | 値より小さい |
<= | 値以下 |
LIKE | 値で指定した文字列に一致する場合 |
NOT LIKE | 値で指定した文字列に一致しない場合 |
IN | 値(配列)で指定した何れかに一致する場合 |
NOT IN | 値(配列)で指定した何れかにも一致しない場合 |
BETWEEN | 2つの値で指定した範囲内(境界を含む)場合 |
NOT BETWEEN | 2つの値で指定した範囲外の場合 |