ACFの値が検索できない時の確認ポイント
｜WP_Queryのmeta_query

症状を標準検索・ACF絞り込み・型の比較に分ける

最初に分けたいのは、「サイト内検索でACFの文字が見つからない」のか、「ACFの条件を付けた一覧が0件になる」のかです。さらに、数値や日付の大小を比べたい場合は、文字列の完全一致とは確認方法が変わります。

ACFの画面に見えている値と、meta_queryが比較するpost metaの保存値は同じとは限りません。get_field()の返り値だけで判断せず、保存値を確認してから条件を書きます。

sパラメータとACFの値検索を混同しない

sは検索キーワードを受け取り、標準では投稿タイトル・抜粋・本文を探します。たとえばACFの「地域」に東京と入力しても、その文字がタイトル・抜粋・本文に書かれていなければ、s => ‘東京’だけでは見つかりません。

タイトル・抜粋・本文のどこを探すか選ぶsearch_columnsと、投稿メタを条件にするmeta_queryは別の仕組みです。検索対象列を絞る方法とmeta_queryの基本を分けて確認すると、どこに条件を書くべきか判断しやすくなります。

ACFの条件だけを試すときは、いったんsを外してください。

最初にメタキー名と保存値を確認する

ACFの値で絞り込む時に最初に確認したいのは、key に指定している名前です。ACFの管理画面には「フィールドラベル」「フィールド名」「field key」がありますが、WP_Queryの meta_query に指定するのは、実際のpost metaのキーです。通常のACFフィールドなら、ラベル「地域」やfield_…で始まるfield keyではなく、フィールド名areaを使います。

次に、対象投稿へ値が保存されているかを見ます。投稿タイプや投稿ステータスを取り違えたり、フィールドグループの表示条件が別の投稿タイプに向いていたりすることもあります。ACFの設定画面、投稿編集画面、get_post_meta()の順で確認すると、画面表示と保存値を分けて追えます。

条件を減らした最小例で確認する

原因を切り分ける時は、最初から複雑なmeta_queryを書かず、投稿タイプ、投稿ステータス、メタキー、値の4つだけに絞ります。まず1件でも返るかを確認すると、どの条件で結果が消えたか追いやすくなります。

ここでは、カスタム投稿タイプworksのうち、単一選択のareaにtokyoが保存されている投稿を完全一致で出します。クラシック子テーマのtemplate-parts/acf-area-list.phpへ保存し、表示したいテンプレートのメインループ内でthe_post()の後にget_template_part( ‘template-parts/acf-area-list’ );を呼んでください。投稿本文やfunctions.phpの直下へ貼るコードではありません。

works、area、tokyoは自分の登録キー・フィールド名・保存値へ置き換えます。通常投稿ならpost_typeをpostにします。ブロックテーマのHTMLテンプレートではPHPを直接実行できないため、この例はPHPテンプレートを使える検証環境向けです。

現在のWP Query Builder実画面で、詳細モードから「投稿タイプ: カスタム / works」「ステータス: publish」「件数: 5」「並び順: DESC / date」を指定し、Meta Queryへarea、tokyo、=を入力しました。自動最適化はオフです。そこで生成された次の$argsは編集せず使用し、その後のループ、0件時の文、投稿IDと保存値の表示、wp_reset_postdata()は用途に合わせて手動で追加しています。

<?php$args = array(    'post_type' => 'works',    'post_status' => 'publish',    'posts_per_page' => 5,    'order' => 'DESC',    'orderby' => 'date',    'meta_query' => array(        array(            'key' => 'area',            'compare' => '=',            'value' => 'tokyo'        )    )); $acf_query = new WP_Query( $args ); if ( $acf_query->have_posts() ) {   echo '<ul>';   while ( $acf_query->have_posts() ) {      $acf_query->the_post();      printf(         '<li><a href="%s">%s</a>（ID: %d / area: %s）</li>',         esc_url( get_permalink() ),         esc_html( get_the_title() ),         get_the_ID(),         esc_html( get_post_meta( get_the_ID(), 'area', true ) )      );   }   echo '</ul>';} else {   echo '<p>条件に合う地域の情報はありません。</p>';} wp_reset_postdata();

keyにはACFのフィールド名、valueには保存値を入れます。選択肢がtokyo : 東京なら、表示される「東京」ではなくtokyoが保存されている場合があります。この例は公開日時の降順ですが、同じ公開日時の投稿同士まで順番を固定するものではありません。

東京では0件、tokyoでは2件になる表示例

次の例では、公開済みのworksが3件あり、ID17・18のareaはtokyo、ID16はosakaです。本文コードの表示はID18・17の2件。valueだけを東京へ変えると0件メッセージになります。IDの数字はサイト固有なので、自分の投稿と保存値へ置き換えて見比べます。

フィールド設定や保存値を調べる間は、本番と分けた環境を使います。サーバー上にも試す場所が必要なら、XserverのPHP対応やバックアップ条件を確認できます。

保存値と検索条件を順に確認する

最小例でも結果が合わない場合は、保存値を確認してからcompare、type、フィールド形式を合わせます。チェックボックス、複数選択、関連投稿、日付、真偽値は、表示と保存値の形が違うことがあります。

保存値を確認する

確認用コードは本番に出しっぱなしにせず、検証環境や一時的なテンプレートで使ってください。個人情報や非公開データが入るフィールドでは、公開画面に値を出さないように注意します。

次のコードをtemplate-parts/debug-acf-meta.phpへ保存します。調べたい投稿の個別テンプレートのメインループで、the_post()の直後にget_template_part( ‘template-parts/debug-acf-meta’ );を一時的に呼んでください。別の固定ページに置いた場合は、その固定ページのIDを調べてしまいます。確認後は呼び出しとファイルを撤去します。

<?php$post_id = get_the_ID();$meta_key = 'area';$raw_value = get_post_meta( $post_id, $meta_key, true ); echo '<pre>';echo esc_html( var_export( [   'post_id' => $post_id,   'exists'  => metadata_exists( 'post', $post_id, $meta_key ),   'value'   => $raw_value,], true ) );echo '</pre>';

表示する値はesc_html()を通すため、文字列にHTMLが含まれていてもタグとして実行されません。ただし、値自体は画面に出るので、個人情報の匿名化と公開範囲の制限は必要です。

get_post_meta()の第2引数にはACFのフィールド名を入れ、第3引数をtrueにすると単一の値として取得します。

別の投稿IDを見ていないかも確認してください。

値が配列のように見えても、比較方法は保存形式で変わります。ACF Checkboxのようなシリアライズ配列の要素を探す公式例では、値をダブルクォートで囲んでLIKEを使います。INは複数の候補値とメタ値全体を比較する指定で、シリアライズ配列の要素検索を自動で行うものではありません。

compare・type・フィールドタイプを合わせる

メタキー名と保存値が合っているのに検索できない場合は、compare と type を確認します。WP_Meta_Queryでは、compare に =、LIKE、IN、BETWEEN などを指定でき、type には NUMERIC、DATE、CHAR などを指定できます。何も指定しない場合、文字列として扱われる場面があるため、数値や日付では意図と違う結果になることがあります。

ただし、LIKEは便利ですが万能ではありません。たとえばredをそのまま探すとdarkredまで一致する可能性があります。シリアライズ配列の要素ならACF公式例のように'”red”‘を探し、それでも保存構造に依存する方法であることを理解して使います。

ACFのCheckbox公式ドキュメントでは、チェックボックスフィールドは選択値の配列を返し、クエリ例では保存値がシリアライズ配列であるため LIKE 比較を使うことが示されています。Date Picker公式ドキュメントでは、表示形式や返り値の形式を変えられても、データベースには Ymd 形式で保存されると説明されています。

RelationshipやPost Object系フィールドも、画面に投稿タイトルが見えていても投稿IDが保存されていることがあります。検索条件は、フィールドタイプごとの保存値に合わせます。

保存値と比較方法が分かったら、WP Query Builderで同じmeta_queryを組み立てられます。生成した$argsを最初の表示ループへ渡し、条件を増やした後の投稿IDも比べます。

切り分けは条件を1つずつ戻す

原因が分からない時は、複数条件をまとめて直すのではなく、条件を1つずつ戻していきます。投稿タイプ、投稿ステータス、ACFのメタキー、値、compare、type、並び順の順に確認すると、どこで結果が消えるか分かりやすくなります。

たとえば、最初は post_type と posts_per_page だけで投稿が出るか確認します。次に meta_query を1つだけ追加します。そこまで出るなら、複数条件の relation や、別の tax_query、date_query、検索キーワードとの組み合わせが原因かもしれません。

これで、ACFの条件自体が違うのか、他の条件と組み合わせた時だけ消えるのかを切り分けられます。

ACFの保存値とmeta_queryの公式資料

meta_queryの構造や比較方法はWordPress側、フィールドごとの値はACF側の公式資料で確認できます。