HUSKY - WooCommerce Product Filter Professional

WooCommerce商品をACFフィールドで絞り込む:種類・設定・対処法

HUSKYを使えばACFフィールドの値でWooCommerce商品を絞り込めますが、それは、フィールドがデータベースクエリで比較できる形式で値を保存している場合に限られます。単一値のフィールド(セレクト、ラジオボタン、真/偽、数値、テキスト、日付ピッカー)は問題なく絞り込めます。チェックボックスフィールドや複数選択を許可(Select Multiple)をオンにしたセレクトフィールドは、フィルターにまったく表示されないか、常に0件になる選択肢が表示されます。以下では、HUSKYがACFデータを読み取る仕組み、使えるフィールドタイプ、それぞれの設定方法、そして複数値フィールドの扱いを説明します。

HUSKYがACFフィールドを読み取る2つの方法

ACFはすべてのフィールドを通常の商品メタデータとして保存します。wp_postmeta テーブルの1行で、フィールドのフィールド名(Field Name)をキーとして、保存された値を保持します。HUSKYには、こうした行で絞り込む組み込み拡張機能が2つあります。どちらもシステム拡張機能で常に有効なため、オンにする操作は不要です。

  • ACF拡張機能(ACFフィールド(ACF fields))は、ACFのフィールドグループを自動的に検出し、そのセレクト、ラジオボタン、真/偽フィールドを構造(Structure)タブにフィールドラベル(グループタイトル)(Field label (Group title))の形式で一覧表示します。フィールドの横のドロップダウンをはい(Yes)に設定して保存すると、そのフィールドがフィルターに加わります。ほかのフィールドタイプはまったく一覧に表示されません。詳細はACF拡張機能のページをご覧ください。
  • メタデータ(Meta Data)タブ(メタフィルター(Meta filter)拡張機能)は、ACFかどうかを問わず任意のメタキーで動作します。キーは自分で追加し、表示方法としてスライダー(Slider)、テキスト検索(Search by text)、チェックボックス(Checkbox)、ドロップダウン(Drop-down)、マルチドロップダウン(Multi Drop-down)、日付ピッカー(Datepicker)から、保持するデータのタイプとして数値(number)、文字列(string)、日付(date)から選びます。メタフィールドによる絞り込みをご覧ください。

ACF拡張機能は設定が早い反面、「フィールドが表示されない」「0件になる」という報告の大半を説明する3つのルールがあります。

  1. フィールドグループは投稿タイプで割り当てる必要があります。HUSKYが認識するのは、ロケーション(Location)ルールに投稿タイプが商品と等しい(Post Type is equal to Product)を含むグループのみです。商品カテゴリーなどのルールだけで表示されるグループはスキップされ、そのフィールドは構造(Structure)タブに届きません。
  2. 各選択肢の値がラベルと一致している必要があります。ACFで xl : Extra large と書かれた選択肢は商品に xl を保存しますが、ACF拡張機能はラベルの Extra large を検索するため、何も見つかりません。1行に1語だけ書いた選択肢(値とラベルが同じ)や、red : Red のように大文字小文字だけが異なる選択肢は動作します。引用符を含むラベルは一致しません。
  3. 複数選択を許可はオフにする必要があります。複数選択を許可(Select Multiple)を有効にしたセレクトフィールドは一覧には表示されますが、後述の理由で商品が見つかりません。

フィールドがこれらのルールのいずれかに反する場合は、キーと正確な値を自分で管理できるメタデータ(Meta Data)タブで絞り込んでください。

絞り込みできるACFフィールドタイプ

ACFフィールドタイプ商品に保存されるものHUSKYでの絞り込み方法
セレクト(単一)、ラジオボタン選択肢の値1つACF拡張機能、またはメタデータのドロップダウン(Drop-down) / マルチドロップダウン(Multi Drop-down)
ボタングループ選択肢の値1つメタデータのドロップダウン(Drop-down) / マルチドロップダウン(Multi Drop-down)
真/偽1 または 0ACF拡張機能、またはメタデータのチェックボックス(Checkbox)
数値、範囲数値メタデータのスライダー(Slider)、タイプは数値(number)
テキスト、メール、URL文字列メタデータのテキスト検索(Search by text)、または値を列挙したドロップダウン(Drop-down)
日付ピッカー20250131(Ymd)形式の日付メタデータの日付ピッカー(Datepicker)と、フック1つ(後述)
チェックボックス、複数選択を許可(Select Multiple)付きのセレクト、複数値のリレーションシップ / 投稿オブジェクト / タクソノミーシリアライズされた配列通常の比較では不可。下の2つの対処法を参照
リピーター、フレキシブルコンテンツspecs_0_width のような番号付きの行1つのフィールドとしては絞り込み不可

グループフィールド内のフィールドは groupname_fieldname として保存され、それぞれのタイプと同様に絞り込めます。日時ピッカーは 2025-01-31 14:00:00 のようなテキストを保存するため、日付ピッカーフィルターでは比較できません。

チェックボックスと複数選択フィールドで何も見つからない理由

フィールドが複数の値を保持できる場合、ACFはそれらをPHPのシリアライズ形式の1つの文字列にまとめます。エアコンとシートヒーターを備えた車には、次のようなメタ行が1つ作られます。

a:2:{i:0;s:2:"ac";i:1;s:12:"heated_seats";}

ACF拡張機能と、ドロップダウン、マルチドロップダウン、チェックボックスの各ビューは、データベースに対して、値が選択されたオプションと等しい(equals)行を問い合わせます。ac はその文字列全体と等しくないため、結果は0件になります。ACFで複数選択を許可(Select Multiple)をオフにしても、既存の商品は修復されません。各商品が単一の値で保存し直されるまで、値はシリアライズされたままです。

メタデータ(Meta Data)タブでACFフィールドを設定する

  1. 実際のメタキーを調べます。これはACFのフィールドのフィールド名(Field Name)(たとえば body_type)であり、ラベルではありません。メタデータ(Meta Data)タブでは、商品IDから任意の商品のキーを取得(Get keys from any product by its ID)を使うと、商品のすべてのキーが一覧表示されます。各ACFフィールドは2回表示されます。body_type が値を保持し、_body_type がACF内部のフィールド参照を保持します。アンダースコアなしのキーを使ってください。キーは大文字小文字を区別し、スペースや括弧を含みません。
  2. キーを追加します。キーを手動で追加(Add Custom key by hands)またはリストから追加し、タイトルを入力して、ビューとタイプを選びます。テキスト値には文字列(string)を選びます。数値(number)では、MySQLが Coupe のようなテキストを比較前に0に変換し、フィルターがそのキーを持つすべての商品を返すため、「フィルターが何も効いていない」ように見えます。
  3. オプションを列挙します。対象はドロップダウン(Drop-down)とマルチドロップダウン(Multi Drop-down)です。メタフィールドは自由なテキストなので、HUSKYは値のリストを自動で作れません。カンマ区切りで自分で書きます。表示タイトルと保存された値が異なる場合は title^value を使います。ACFの選択肢 coupe : Coupe と suv : SUV / Crossover の場合は次のようになります。
    Coupe^coupe,SUV / Crossover^suv
    ^ の後ろの部分は、ACFが保存した内容、つまりラベルではなく選択肢の値と完全に一致している必要があります。
  4. 保存して構造(Structure)タブを開き、新しい項目をはい(Yes)に設定し、適切な位置にドラッグして、もう一度保存します。その横の歯車アイコンには、ビュー独自のオプションがあります。たとえばチェックボックスの検索オプション(Search option)と検索値(Search value)、テキスト検索(Search by text)のテキスト検索の条件(Text search conditional)(LIKEまたはEXACT)などです。

チェックボックス(Checkbox)は、1つのキーに対する単一のチェックボックスです。値が 1 の商品(真/偽フィールド)、yes などの別の検索値(Search value)を持つ商品、あるいは検索オプション(Search option)を値が存在する(Value exists)に設定した場合は、フィールドが入力されているすべての商品を見つけます。

保存された値自体にカンマが含まれる場合は、すべてのドロップダウンとマルチドロップダウンのリストで区切り文字を変更し、リストを | で書き直します。

/*
 * HUSKY: separate meta filter options with | instead of a comma.
 * Child theme functions.php or a code snippets plugin.
 * Example list afterwards: Wood, oak|Wood, pine|Metal
 */
add_filter( 'woof_meta_options_separator', function ( $separator ) {
    return '|';
} );

数値フィールドと範囲フィールドはスライダー(Slider)に向いています。範囲、ステップ、小数については属性とメタフィールドのレンジスライダーフィルターで説明しています。

ACFの日付フィールドで絞り込む

日付ピッカーフィルターはデフォルトでUnixタイムスタンプを比較しますが、ACFの日付ピッカーは日付を 20250131 の形式で保存します。フックwoof_meta_use_acf_dateformatを使うと、フィルターは検索の前に、選択された日付を同じ形式に変換します。

/*
 * HUSKY: Datepicker meta filters search ACF Date Picker values (Ymd).
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woof_meta_use_acf_dateformat', '__return_true' );

メタデータ(Meta Data)タブでACFキーを日付ピッカー(Datepicker)ビューで追加し、タイプは数値(number)のままにしてください。変換された日付は数値として比較され、日付(date)タイプではここでは使える日付が生成されません。このフックはサイト上のすべての日付ピッカーフィルターに適用されるため、すべてがACFの日付ピッカーフィールドを指している必要があります。有効期間(from / to)には、開始フィールドと終了フィールドを2つの別々のフィルターとして追加します。

チェックボックスと複数選択フィールド:2つの対処法

推奨:値をタクソノミーに移す

商品ごとに複数の値を持つデータは、まさにタクソノミーのためのものです。タクソノミーなら、値ごとのチェックボックス、件数、選択した値の間のANDまたはORロジック、そしてメタフィールドにはないターボモードのサポートが得られます。編集にACFを手放す必要はありません。

  1. 商品タクソノミー(たとえば設備(Equipment))を、カスタムタクソノミーとして、または商品 → 属性(Products → Attributes)のグローバル属性として作成します。
  2. ACFで、チェックボックスフィールドを、それを指すタクソノミー(Taxonomy)フィールドに置き換え、用語を保存(Save Terms)と用語を読み込み(Load Terms)をオンにします。すると、ACFは配列を保存する代わりに、選択された用語を商品に割り当てます。
  3. 商品は、再保存されたときに用語を取得します。大規模なカタログでは一括で行ってください。その後、このタクソノミーはほかのものと同様にHUSKYの構造(Structure)タブに表示されます。

フィールドを維持する:保存された配列の内部を検索する

フィールドをそのままにする必要がある場合は、比較方法を変更できます。以下のスニペットは、一覧にあるキーについてHUSKYの「等しい」条件を、引用符で囲んだ値の LIKE 検索に変えるため、ac は LIKE '%"ac"%' となり、シリアライズされた文字列内の要素に一致しますが、ac_rear には一致しません。オプションの件数も修正されます。

/*
 * HUSKY: Drop-down / Multi Drop-down meta filters for ACF Checkbox
 * and Select Multiple fields (values stored as serialized arrays).
 * Child theme functions.php or a code snippets plugin.
 */
function my_husky_serialized_keys() {
    return array( 'equipment' ); // ACF field names
}

function my_husky_match_serialized( $meta_query ) {
    if ( ! is_array( $meta_query ) ) {
        return $meta_query;
    }
    foreach ( $meta_query as $i => $clause ) {
        if ( ! is_array( $clause ) ) {
            continue;
        }
        if ( isset( $clause['key'], $clause['value'], $clause['compare'] )
            && '=' === $clause['compare']
            && is_scalar( $clause['value'] )
            && in_array( $clause['key'], my_husky_serialized_keys(), true ) ) {
            $meta_query[ $i ]['compare'] = 'LIKE';
            $meta_query[ $i ]['value']   = '"' . $clause['value'] . '"';
            $meta_query[ $i ]['type']    = 'CHAR';
        } else {
            $meta_query[ $i ] = my_husky_match_serialized( $clause );
        }
    }
    return $meta_query;
}

// Products found by the filter
add_filter( 'woof_get_meta_query', 'my_husky_match_serialized', 100 );

// Counts next to the options (Show count + Dynamic recount)
add_filter( 'woof_dynamic_count_attr', function ( $args ) {
    if ( isset( $args['meta_query'] ) ) {
        $args['meta_query'] = my_husky_match_serialized( $args['meta_query'] );
    }
    return $args;
}, 100 );

そのうえで、メタデータ(Meta Data)タブに equipment をドロップダウン(Drop-down)またはマルチドロップダウン(Multi Drop-down)として、タイプは文字列(string)で追加し、^ の後ろにACFの選択肢の値を指定します。たとえば Air conditioning^ac,Heated seats^heated_seats のようになります。制限事項も把握しておいてください。マルチドロップダウンは、選択された値のうちいずれかを持つ商品を見つけ、すべてを持つ商品ではありません。LIKE '%…%' 検索はデータベースのインデックスを使用できず、大規模なカタログでは遅くなります。そして、このスニペットはターボモードでは適用されません。このフックの詳細はwoof_get_meta_queryのページをご覧ください。

バリエーション、ターボモード、カスタム商品グリッド

  • バリエーションの値は検索されません。ショップのクエリは親商品を返し、親自身のメタをチェックします。属性は、親がすべてのバリエーションの用語を持つためバリエーションにも有効ですが、メタ値はそうではありません。値は親商品に設定してください。
  • ターボモードは、メタデータ(Meta Data)タブで追加したキーのみを含む独自のデータファイルを使って、ブラウザー上で絞り込みます。ACF拡張機能で表示されるフィールドや、上記のスニペットのようなPHPフックは、そこでは使われません。ターボモードのトラブルシューティングをご覧ください。
  • URLは変わるのに、すべての商品が表示されたままになる。その場合、問題はフィールドではありません。ページビルダーのグリッドやカスタムテンプレートが独自のクエリを実行し、すべてのフィルターを無視しています。対処法はフィルターのURLは変わるが商品が絞り込まれないにあります。

それでもACFフィルターで商品が見つからない場合

  • 実際に保存されている内容を確認します。phpMyAdminなどのツールで、商品IDとテーブルプレフィックスを指定して SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123 を実行してください。a: で始まる値はシリアライズされた配列です。想定と異なるキーがある場合、ACFは別の名前で保存しています。
  • メタデータ(Meta Data)タブ:先頭にアンダースコアのないキーで、大文字小文字も同じであること。テキストにはタイプ文字列(string)、^ の後ろには保存された選択肢の値。
  • ACF拡張機能の場合:グループのロケーションが投稿タイプが商品と等しい(Post Type is equal to Product)であること、選択肢の値がラベルと一致していること、複数選択を許可(Select Multiple)がオフであること、変更後に商品が再保存されていること。
  • 値がバリエーションではなく親商品にあること。
  • 同じページでタクソノミーフィルターが動作すること。動作しない場合は、先に商品グリッドを修正してください。

すべての項目を確認してもフィルターで何も見つからない場合は、フィールドのタイプと設定、メタキー、保存された値のサンプルを添えて、HUSKYサポートフォーラムでトピックを作成してください。確認いたします。