WP_Queryで複数条件を組み合わせる方法
｜AND・ORを指定できる場所とできない組み合わせ

最初に、すべて満たすか、どれかを満たすかを決める

たとえば「制作情報または更新情報カテゴリーに属し、初心者向けの記事を表示する」という要件を分解します。

terms => array( 10, 11 )とoperator => ‘IN’は、2つのタームIDのどちらかに属する投稿を表します。その結果とaudience = beginnerを両方満たす投稿だけが残ります。

表の1行目は1つのTax Queryに入れる候補値、2行目はTax QueryとMeta Queryの組み合わせ、3行目はMeta Query内に複数の条件を置く例です。先に条件の範囲を分けると、relationを書く場所を取り違えにくくなります。

WP Query BuilderでTax QueryとMeta Queryを入力する

公開中のWP Query Builderで「詳細設定（全項目）」を選びます。この記事では、入力した条件だけを追えるように自動高速化をOFFにし、独自一覧の並びを保つため「固定表示を無視」をtrueにしました。

続いてMeta Queryへaudience、beginner、=を入力します。これはTax Query内の条件を増やす操作ではなく、WP_Query直下に異なる種類の条件を追加する操作です。

次は、WP Query Builderがこの画面で生成したコードです。入力値、配列の順序、書式を変更せずに掲載しています。

$args = array(    'post_type' => 'post',    'post_status' => 'publish',    'posts_per_page' => 6,    'order' => 'DESC',    'orderby' => 'date',    'tax_query' => array(        array(            'taxonomy' => 'category',            'field' => 'term_id',            'operator' => 'IN',            'terms' => array(                10,                11            )        )    ),    'meta_query' => array(        array(            'key' => 'audience',            'compare' => '=',            'value' => 'beginner'        )    ),    'ignore_sticky_posts' => true);

生成された$argsを子テーマの表示ループへつなぐ

WP Query Builderが生成するのは取得条件の$argsです。クラシックテーマの子テーマなら、表示処理をtemplate-parts/beginner-news.phpへまとめます。下の完成例は、先ほどWP Query Builderが生成した$argsを変更せずに使っています。

<?php$args = array(    'post_type' => 'post',    'post_status' => 'publish',    'posts_per_page' => 6,    'order' => 'DESC',    'orderby' => 'date',    'tax_query' => array(        array(            'taxonomy' => 'category',            'field' => 'term_id',            'operator' => 'IN',            'terms' => array(                10,                11            )        )    ),    'meta_query' => array(        array(            'key' => 'audience',            'compare' => '=',            'value' => 'beginner'        )    ),    'ignore_sticky_posts' => true); $beginner_news_query = new WP_Query( $args ); if ( $beginner_news_query->have_posts() ) :    ?>    <section aria-labelledby="beginner-news-title">        <h2 id="beginner-news-title">初心者向けの制作・更新情報</h2>        <ul>            <?php while ( $beginner_news_query->have_posts() ) : ?>                <?php $beginner_news_query->the_post(); ?>                <li>                    <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>                    <span><?php the_category( ' / ' ); ?></span>                    <span><?php echo esc_html( (string) get_post_meta( get_the_ID(), 'audience', true ) ); ?></span>                </li>            <?php endwhile; ?>        </ul>    </section>    <?phpelse :    echo '<p>条件に合う記事はありません。</p>';endif; wp_reset_postdata();

このファイルを子テーマへ保存し、表示したい固定ページテンプレートのメインループ内で本文の後から1回呼びます。

<?php get_template_part( 'template-parts/beginner-news' ); ?>

ブロックテーマでは、子テーマの独自テンプレートや、表示用ショートコードを持つ小さなプラグインへ処理を置き換えます。どこへ置く場合も、独自ループ後のwp_reset_postdata()を省かないでください。

テーマファイルへ加える前に、ローカルまたはステージングで対象投稿のタームとメタ値を確認します。検証環境をこれから用意する場合は、バックアップと利用できるPHPバージョンも公式情報で確かめてください。

実際の投稿で、両方を満たす2件だけになるか確認する

分離したWordPress検証環境へ、次の4投稿を用意しました。ID79はカテゴリー10、ID80はカテゴリー11、ID81は両方、ID82は別カテゴリーです。audienceはID79と81がbeginner、ID80がadvanced、ID82は未保存です。

生成された$argsをそのままWP_Queryへ渡すと、Tax QueryとMeta Queryの両方を満たすID81と79だけが投稿日降順で返りました。

同じ投稿データで、条件を1つずつ外した結果も比較しました。Tax Queryだけなら3件、Meta Queryだけなら2件、両方なら2件です。条件を足すほど、両方を満たす投稿へ候補が狭まることが分かります。

AND・ORを指定できる場所とできない組み合わせを整理する

relationが必要なのは、同じtax_queryまたはmeta_queryの中へ条件を2つ以上置く場合です。省略時はANDです。

$tax_query = array(    'relation' => 'OR',    array(        'taxonomy' => 'category',        'field'    => 'term_id',        'terms'    => array( 10 ),    ),    array(        'taxonomy' => 'post_tag',        'field'    => 'slug',        'terms'    => array( 'featured' ),    ),);

一方、同じタクソノミーの候補値を「どれか1つ」で選ぶだけなら、今回のように1つの条件へ複数のtermsを入れてINを使えます。条件を分ける前に、複数の候補値を1つの条件へまとめられないか確認してください。

同じtax_queryまたはmeta_queryの中では、条件を入れ子にしてANDとORを組み合わせることもできます。ただし、条件の階層が増えるほど入力ミスや0件の原因を追いにくくなります。まずこの記事の範囲で単純なAND・ORを確認し、複雑な入れ子は別の実装例として扱うのが安全です。

Tax Query内で2つの条件をAND・ORにつなぐ具体例が必要なら、次の記事でrelationとoperatorの違いを実データと一緒に確認できます。

異なる種類の条件を$args直下へ並べるとANDになる

次のように異なる種類の条件を$args直下へ並べた場合、relationを書かなくても、原則としてすべてを満たす投稿が対象です。

$args = array(    'post_type'  => 'post',    's'          => 'WordPress',    'tax_query'  => array( /* 分類の条件 */ ),    'meta_query' => array( /* カスタムフィールドの条件 */ ),    'date_query' => array( /* 投稿日の条件 */ ),);

これは「検索語を含み、分類条件を満たし、メタ条件を満たし、期間内でもある」というANDです。最初から全部入れて0件になった場合は、どの条件が合っていないか分かりません。検索語だけ、Tax Queryだけ、Meta Queryだけの順に確認し、最後に組み合わせます。

日付条件を追加したい場合は、先に期間だけで境界日と取得IDを確認してください。after・before・inclusiveの使い分けは、次の期間指定の記事で実際の投稿日を使って確認できます。

異なる種類の条件をまたぐORは通常の引数だけでは指定できない

「カテゴリー10に属する、またはaudienceがbeginner」のような、tax_queryとmeta_queryをまたぐORを、$args[‘relation’] = ‘OR’のようには指定できません。WP_Query直下には、異なる種類の条件を横断するrelationがないためです。

無理にSQLフィルターへ進む前に、同じ意味を1つのタクソノミーやメタキーへ寄せられないか、対象投稿へ共通のタームを付けられないかを検討します。別々のクエリ結果をPHPで統合する方法は、ページネーション、重複排除、並び順、総件数の扱いが変わるため、単純な置き換えではありません。

指定できない、または意図が崩れやすい組み合わせを避ける

WordPress公式リファレンスでは、post__inとpost__not_inを同じクエリで組み合わせられないことが明記されています。含めるIDと除外するIDが必要なら、PHP側で除外後に残ったIDの一覧を作り、post__inへ渡します。

Meta Queryそのもののcompareやtypeで迷う場合は、複数条件のまま推測せず、1つの条件へ戻してください。次の記事では、保存値の確認から=、IN、数値比較までを順番に試せます。

実装後は各条件と組み合わせ後の取得結果を確認する

最後は、各条件を単独で通した記録と、すべてを組み合わせた記録を残します。次の順番なら、0件になった箇所を追いやすくなります。

件数だけでは、偶然同じ数の別投稿が返っていても気づけません。開発中は投稿ID、ターム、メタ値を一緒に出し、期待する投稿と比較します。本番表示では必要な情報だけへ戻してください。

まとめ：relationの前に、条件の範囲を決める

複数条件のWP_Queryでは、まず要件を日本語で整理します。同じtax_query内、同じmeta_query内など、同じ種類の条件をつなぐときにrelationを使います。異なる種類の条件を$args直下へ並べた場合はANDです。

異なる種類の条件をまたぐORや、post__inとpost__not_inの同時指定は、そのまま書き足しても解決しません。データ設計やID集合を先に整理し、各条件を単独で確認してから組み合わせましょう。

複数条件の構造を公式資料で確認する

relationの位置や使える比較方法は、条件の種類ごとの公式資料で確認できます。条件が増えたときは、WP_Query全体と各query classの両方へ戻ると構造を見失いません。

複数条件のよくある質問

relationの位置と、通常の引数で表せる範囲について、実装時に迷いやすい点を短く整理します。