検索結果が0件になってしまう

Question

実現したいこと

WordPress（REST API + WP_Query）で商品一覧APIを自作しています。
プラグインは使わず、ACFのカスタムフィールドを含めた検索を実現したいのですが、
どうしても検索結果が 0件 になってしまい詰まっています。

REST API（/custom/v1/products）で以下の検索を実現したいです。

• フリーワード検索（検索窓1つ）
• 製品型番検索（ACF：model_number）
• 製品名検索（ACF：product_name）
• 製品カテゴリ検索（ACF：product_category）
• メーカー固定（ACF：manufacturer が「アマダ / AMADA」）

発生している問題・分からないこと

検索パラメータ keyword を指定すると 常に0件
keyword を外すと通常の一覧は取得できる
ACFの値自体は管理画面では正しく登録されている

エラーメッセージ

エラーメッセージは特にありません

該当のソースコード

$args = [
    'post_type'      => 'product',
    'post_status'    => 'publish',
    'posts_per_page' => 12,
    'paged'          => $page,
    'meta_query'     => [
        'relation' => 'OR',
        [
            'key'     => 'manufacturer',
            'value'   => 'アマダ',
            'compare' => 'LIKE',
        ],
        [
            'key'     => 'manufacturer',
            'value'   => 'AMADA',
            'compare' => 'LIKE',
        ],
    ],
];

$keyword = $request->get_param('keyword');
if ($keyword) {
    $args['meta_query'][] = [
        'relation' => 'OR',
        [
            'key'     => 'model_number',
            'value'   => $keyword,
            'compare' => 'LIKE',
        ],
        [
            'key'     => 'product_category',
            'value'   => $keyword,
            'compare' => 'LIKE',
        ],
        [
            'key'     => 'product_name',
            'value'   => $keyword,
            'compare' => 'LIKE',
        ],
    ];
}

試したこと・調べたこと

• teratailやGoogle等で検索した
• ソースコードを自分なりに変更した
• 知人に聞いた
• その他

上記の詳細・結果

ACFの複数フィールドを OR 条件で検索する場合、

• meta_query の relation の正しい組み方は？
• manufacturer 条件と keyword 条件を
• 「メーカーAND（型番OR製品名ORカテゴリ）」にしたい場合のベストプラクティス
• この構成で 0 件になる場合に疑うべきポイント（meta_key名、保存形式など）

補足

特になし

Answer 1

WordPressでACFを含む検索を行う場合は、meta_queryのネスト構造が重要です。要件は「メーカー固定 AND （型番 OR 製品名 OR カテゴリ）」なので、最上位のrelationをANDにし、メーカー条件をOR、キーワード条件もORでまとめる必要があります。検索結果が常に0件になる場合は、ACFのフィールド名が正しいか、保存形式（テキストかIDか、EZ Pass WV ラベルではなく値が保存されているか）、比較演算子（文字列ならLIKE、数値やIDなら=やIN）を確認してください。特にタクソノミーフィールドはmeta_queryではなくtax_queryを使うのがベストプラクティスです。