WP Query Builderでカスタムフィールド条件を作る方法
｜meta_query入門

絞り込みたいイベントと、保存されている値を確認する

この記事では、イベント紹介を登録したカスタム投稿タイプworksを使います。最初は「東京で開催するもの」、最後は「東京・料金6万円以上・2026年9月1日以降の開催」という一覧を作ります。条件を増やしても、同じ3件のデータを使います。

worksや各フィールド名は検証サイトの例です。自分のサイトでは登録済みの名前に置き換えてください。通常の投稿を使う場合、投稿タイプはpostです。WP Query Builderで名前を入力しても、投稿タイプやフィールドが新しく登録されるわけではありません。

ACFの表示ラベルとフィールド名は別です。「地域」と表示されていても、keyへ入れるのはareaというフィールド名です。 保存値も、画面の見た目どおりとは限りません。

この例で確認する名前と値は、次の組み合わせです。料金は単位やカンマを含めずに保存し、ACF Date Pickerの開催日は8桁のYmd形式で保存します。

ACFのフィールドグループで「地域」を開くと、ラベル・フィールド名・選択肢を確認できます。tokyo : 東京の左側が保存値、右側が表示ラベルです。設定を確認するだけなら、値の変更や保存は不要です。

フィールド名は分かっても、対象投稿に何が保存されているか分からない場合は、次の記事で実際の保存値を確かめる手順を確認できます。

meta_queryの4項目で「地域が東京」という条件を作る

WP Query Builderで「詳細設定（全項目）」を選び、「Meta Query（カスタムフィールド）」を開きます。基本設定では投稿タイプをcustom、カスタム投稿タイプをworks、公開状態をpublish、表示件数を10にします。この記事では並び順もdate / DESCにそろえます。

最初の条件には、次の4項目を入力します。keyを入力すると、残りの欄が編集できるようになります。

WordPressではcompareの初期値は=、typeはCHARです。ここでは画面でも明示して、どの条件になったか確認します。「キー自体の比較（任意）」は使いません。

areaがtokyoのイベントだけを取得する

入力後、keyがarea、valueがtokyoになっているか見直しましょう。「東京」という表示ラベルをvalueへ入れる例ではありません。

公開中のWP Query Builderで、この入力から生成された未編集のコードです。この配列だけでは画面に一覧は表示されず、後半の完成例でWP_Queryへ渡します。

$args = array(    'post_type' => 'works',    'post_status' => 'publish',    'posts_per_page' => 10,    'order' => 'DESC',    'orderby' => 'date',    'meta_query' => array(        array(            'key' => 'area',            'compare' => '=',            'type' => 'CHAR',            'value' => 'tokyo'        )    ),    'no_found_rows' => true,    'ignore_sticky_posts' => true,    'update_post_meta_cache' => false,    'update_post_term_cache' => false,    'lazy_load_term_meta' => false);

確認するのは、meta_query内の4項目と、対象のpost_typeです。生成された件数・並び順・キャッシュ設定も省略せず載せています。この例は最大10件の一覧で、ページ送りは作りません。

CHARの=は、部分一致を探すLIKEとは違います。ただし、大文字・小文字を必ず区別する指定ではありません。データベースの照合順序によって一致の扱いが変わるため、厳密な区別が必要なら保存値と比較仕様を別に確認してください。

作成した条件は、本番と分けたWordPress環境で、想定したイベントだけが取得できるか確かめます。検証や公開に使うサーバーをこれから用意する場合は、XserverのPHP対応やバックアップ条件も確認できます。

条件を追加し、relationでAND・ORを選ぶ

開催地だけで対象が見つかることを確かめたら、料金の条件を加えます。Meta Query欄の下にある「＋ カスタムフィールド条件を追加」を押してください。最初のkeyが空のままでは、次の条件を追加できません。

2条件になると、欄の上側に「条件のつなぎ方 / relation」が現れます。追加した「条件2」は下側です。今回は東京であり、かつ料金の条件も満たす一覧なのでANDを選びます。

ANDで0件になったからといって、ORへ変えて解決したことにはなりません。「両方を満たす」から「どちらかを満たす」へ、欲しい一覧の意味が変わるためです。必要な条件を先に決めましょう。

条件2へpriceを追加し、料金をNUMERICで比較する

条件1はそのまま残し、条件2へprice / 60000 / >= / NUMERICを入力します。6万円ちょうどを含め、それ以上の数値を対象にする指定です。保存値が60,000円のような文字列ではなく、数値として比較できる60000になっていることが前提です。

次の画面では、上側のrelationがAND、下側の条件2がpriceになっています。追加ボタンとrelationの場所を混同しないよう、1つ前の画面と見比べてください。

2条件から実際に生成されたコードは次のとおりです。1条件目を消すのではなく、meta_queryの中へ2条件目とrelationが加わっています。

$args = array(    'post_type' => 'works',    'post_status' => 'publish',    'posts_per_page' => 10,    'order' => 'DESC',    'orderby' => 'date',    'meta_query' => array(        'relation' => 'AND',        array(            'key' => 'area',            'compare' => '=',            'type' => 'CHAR',            'value' => 'tokyo'        ),        array(            'key' => 'price',            'compare' => '>=',            'type' => 'NUMERIC',            'value' => 60000        )    ),    'no_found_rows' => true,    'ignore_sticky_posts' => true,    'update_post_meta_cache' => false,    'update_post_term_cache' => false,    'lazy_load_term_meta' => false);

料金だけを比べると、検証用データの60000・80000・120000はすべて6万円以上です。一方、同じ比較をCHARにすると、文字列の並びとして判断され、120000が外れます。料金の大小を比べるときは、数字に見える値を入れるだけでなく、typeもNUMERICにします。

なお、料金で絞っても、料金順に並び替わるわけではありません。 ここでは投稿の日付降順のまま取得しています。料金順にしたい場合は、次の記事でorderby=meta_value_numの設定も確認できます。

開催地と料金の2条件を確認できたら、自分のフィールドでもWP Query Builderで入力と出力を見比べてみましょう。日付を加える前に、ここまでの条件を確かめておくと切り分けやすくなります。

条件3へACFの開催日を追加し、9月1日以降に絞る

最後に追加ボタンをもう一度押し、条件3へevent_date / 20260901 / >= / NUMERICを入力します。relationはANDのままです。これで地域・料金・開催日のすべてを満たす一覧になります。

ACF Date Pickerは、表示形式や返り値の形式とは別に、データベースへYmd形式で保存します。2026年9月1日は20260901です。この例は「2026年9月1日以降」という固定条件です。日付が変わっても「今日以降」へ自動で更新される条件ではありません。

3条件から生成された配列を、そのまま載せています。先ほどの2条件にevent_dateが加わったことを確認してください。

$args = array(    'post_type' => 'works',    'post_status' => 'publish',    'posts_per_page' => 10,    'order' => 'DESC',    'orderby' => 'date',    'meta_query' => array(        'relation' => 'AND',        array(            'key' => 'area',            'compare' => '=',            'type' => 'CHAR',            'value' => 'tokyo'        ),        array(            'key' => 'price',            'compare' => '>=',            'type' => 'NUMERIC',            'value' => 60000        ),        array(            'key' => 'event_date',            'compare' => '>=',            'type' => 'NUMERIC',            'value' => 20260901        )    ),    'no_found_rows' => true,    'ignore_sticky_posts' => true,    'update_post_meta_cache' => false,    'update_post_term_cache' => false,    'lazy_load_term_meta' => false);

日付という理由だけでtypeをDATEにするのではなく、保存形式を確認します。今回のACFの8桁値はNUMERICで比較しています。YYYY-MM-DD形式で保存する別の設計とは分けて考えましょう。

日付の取得や表示形式で迷ったときは、次の記事が役立ちます。

同じ3件のデータで、1条件から3条件までの結果を比べる

ここまでの条件を、分離したWordPressの検証環境で実行します。使うのはID16「終了した相談会」、ID17「夏の制作相談会」、ID18「秋のWP_Query勉強会」の3件です。料金や日付は説明用データで、実際のイベントの募集情報ではありません。

生成コードは新しい順で取得するため、東京の2件は18→17の順になります。条件を増やしたときの結果は次のとおりです。

同じ条件の実際の一覧を見てみましょう。最初は東京、かつ6万円以上の2件です。料金を加えても2件のままなのは、東京の2件がどちらも6万円以上だからです。

ORに変えると、料金条件を満たす大阪の「終了した相談会」も加わります。開催地が東京ではなくても、片方の条件を満たせば対象です。

ANDに戻し、さらに9月1日以降の開催日を加えると、「秋のWP_Query勉強会」の1件に絞られます。

3条件の配列をテンプレートへ置き、イベント一覧を表示する

生成された配列に、WP_Queryで取得する処理と表示ループを追加します。次はクラシックテーマ向けの完成例です。ブロックエディターの本文へPHPを貼り付ける方法ではありません。

子テーマのtemplate-parts/event-meta-list.phpへ次のコードを置き、page.phpのメインループが終わった位置からget_template_part( ‘template-parts/event-meta-list’ );を1回呼び出します。既存の本文や一覧を二重に出さない位置を選び、本番とは分けた検証環境で試してください。

新規のPHPファイルなら、次の開始タグ付きコードをそのまま保存します。既存のPHP内へ追加するときは先頭の<?phpを除き、呼び出す側の1行もPHPの内側へ記述してください。

<?php$args = array(    'post_type' => 'works',    'post_status' => 'publish',    'posts_per_page' => 10,    'order' => 'DESC',    'orderby' => 'date',    'meta_query' => array(        'relation' => 'AND',        array(            'key' => 'area',            'compare' => '=',            'type' => 'CHAR',            'value' => 'tokyo'        ),        array(            'key' => 'price',            'compare' => '>=',            'type' => 'NUMERIC',            'value' => 60000        ),        array(            'key' => 'event_date',            'compare' => '>=',            'type' => 'NUMERIC',            'value' => 20260901        )    ),    'no_found_rows' => true,    'ignore_sticky_posts' => true,    'update_post_meta_cache' => false,    'update_post_term_cache' => false,    'lazy_load_term_meta' => false); $event_query = new WP_Query( $args ); if ( $event_query->have_posts() ) :    while ( $event_query->have_posts() ) :        $event_query->the_post();        ?>        <article>            <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>        </article>        <?php    endwhile;else :    echo '<p>条件に合うイベントはありません。</p>';endif; wp_reset_postdata();

$argsは直前の未編集生成結果と同じです。その後ろの取得処理・表示ループ・0件時の文言・リセットは、この記事で追加した実装です。検証データでは「秋のWP_Query勉強会」のリンクが1件表示されます。

自分のサイトで使うときは、登録済みの投稿タイプ・フィールド名・保存値へ置き換えます。設置位置やループの役割から確認したい場合は、次の記事をご覧ください。

0件になったら、保存値と条件を1つずつ照合する

コードが生成できても、データと条件が合わなければ0件です。まず対象の投稿が公開されているかを確認し、次の順で絞り込みを見直します。

複数選択フィールドの配列や、単位・カンマ付きの料金は、今回の単純な保存形式とは違います。表示値だけを見て同じ条件を当てはめず、保存のされ方を調べてください。

入力・生成コード・取得結果をそろえてから実装へ進む

1条件ずつ確かめると、どの条件で結果が変わったか分かります。最後に、次の項目を見直しましょう。

画面全体の操作やコピー方法は、WP Query Builderの使い方チュートリアルをご覧ください。この記事の値を使う場合も、個人情報や秘密の値は入力せず、公開してよい検証用データで試しましょう。