HUSKY - WooCommerce Product Filter Professional

WooCommerceのフィルターURLが変わるのに商品が変わらない時の対処

色やカテゴリーにチェックを入れるとローダーが表示され、アドレスバーが /shop/?swoof=1&pa_color=red のように変わるのに、商品グリッドには同じ商品が表示されたまま。WooCommerceのフィルターでURLは変わるのに商品が変わらないとき、フィルターは自分の役目を果たしています。検索リクエストは作成されているのです。商品を出力するテンプレートが、それを読み取っていないだけです。このガイドでは、それを2分で確認する方法と、テーマ、ページビルダー、カスタムテンプレートをフィルターに反応させる方法を説明します。

フィルターのURLは変わるのに商品が変わらない理由

HUSKYはショップの商品グリッドを自分で描画しません。WooCommerceがすでに実行している商品クエリに、タクソノミー、価格、メタフィールド、テキストといった条件を追加します。追加先は次のクエリだけです。

  • ショップページと、商品カテゴリー、タグ、属性のアーカイブのメインクエリ(WooCommerceの woocommerce_product_query の段階)
  • プラグイン独自の [woof_products] ショートコード
  • woocommerce_shortcode_products_query を通した、[products] などのWooCommerceの商品ショートコード

独自に WP_Query を組み立てる商品リストは、この経路の外にあります。ページビルダーの商品グリッド、投稿カードやリピーター、「クエリループ」要素、独自クエリを持つテーマのアーカイブレイアウト、PHPテンプレート内の手書きのループは、いずれも独自の方法でデータベースに商品を問い合わせるため、フィルターの指定に関係なくカタログ全体を表示し続けます。フィルターが壊れているわけではなく、そのリストが単に耳を貸していないのです。

同じ原因から生じる関連症状が2つあります。通常のページでフィルターのスクリプトがWooCommerceの商品リストを見つけられない場合、結果を表示するために訪問者をショップページへ移動させます。また、ビルダーで作られた、実際にはWordPressの固定ページである「カテゴリーページ」では、フィルターが現在のカテゴリーを認識できないため、すべての用語を表示し、カタログ全体を検索します。

2分で原因を確認する

  1. フィルタリング後のURLを確認する。URLに swoof=1 と選択内容が含まれていれば(SEO URLが有効なら /swoof/ に続けて選択内容、価格だけを選んだ場合は min_price と max_price のみ)、フィルターは動作しています。URLがまったく変わらない場合は、フィルターが送信されていません。まずブラウザのコンソールでJavaScriptエラーを探してください。
  2. 標準のショップページで同じリクエストを試す。?swoof=1 以降をすべてコピーし、WooCommerceのショップページのURLに付け足します。そこでは商品が絞り込まれ、お使いのページでは絞り込まれないなら、原因はお使いのページの商品リストにあります。
  3. プレーンなショートコードでテストする。下書きページに [woof] を置き、その下に [woof_products per_page=12] またはWooCommerceの [products limit="12"] を置きます。これらが正しく絞り込めるなら、実際のページには以下のいずれかの対処法を使います。
  4. ページの種類を確認する。編集画面を見てください。商品グリッドを置いたWordPressの固定ページ (Page) は、URLが /category/shoes/ のように見えても商品アーカイブではありません。

対処法1:[woof_products] で商品を表示する

最も確実な対処法は、商品の出力をプラグインに任せることです。ビルダーの商品要素を、[woof_products] を含むショートコードウィジェットまたはブロックに置き換えます。

[woof_products per_page=12 columns=4 is_ajax=1]

このショートコードはどのページでもフィルターに反応し、is_ajax=1 でAJAXモードに対応し、各商品をテーマ標準のWooCommerce商品カード(content-product.php テンプレートパーツ)で描画するため、ショップと同じ見た目になります。別のテンプレートパーツを使いたい場合は、woof_template_part フィルターで変更します。

1つのカテゴリーだけを一覧表示するページでは、2つのショートコードに同じ条件を指定してください。そうしないと、フィルターがカタログ全体の用語を表示してしまいます。

[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]

25 は、カテゴリーのIDに置き換えてください(カテゴリーの編集時にURLに表示されます)。WooCommerce標準の [products] ショートコードも絞り込まれますが、ページの再読み込みを伴います。AJAXモードで使いたい場合は、[products_woof limit="12" columns="4"] と書いてください。プラグインがこれをラップし、再読み込みなしで結果を差し替えられるようにします。

対処法2:ビルダーのグリッドやカスタムWP_Queryをフィルターに反応させる

ビルダー独自のカードデザインを残したい場合は、そのクエリがフィルターの結果を使うようにします。以下のスニペットは pre_get_posts にフックし、現在のフィルターに一致する商品をHUSKYに問い合わせて、グリッドのクエリをそれらに限定します。これはページビルダーとカスタムテンプレートをフィルター対応にするのコードを強化した版で、wp-adminの商品リストには手を加えず、グリッドのページネーションを維持し、要素に固定された商品選択を尊重し、一致する商品がないときはカタログ全体ではなく「商品なし」を表示します。

/**
 * HUSKY: apply the active filter to product lists that run their own query
 * (page builder grids, post cards, query loops, custom templates).
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'pre_get_posts', function ( $query ) {
    static $busy = false;

    if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
        return;
    }
    // Keep the product lists in wp-admin untouched.
    if ( is_admin() && ! wp_doing_ajax() ) {
        return;
    }
    // Product queries only.
    if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
        return;
    }
    // WooCommerce archives and [woof_products] are filtered already.
    if ( 'product_query' === $query->get( 'wc_query' ) ) {
        return;
    }
    // Only while a filter is active: ?swoof=1, an SEO URL,
    // or ?min_price=...&max_price=... when only the price is set.
    $request = woof()->get_request_data();
    if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
        return;
    }
    // Optional: limit to one page.
    // if ( ! is_page( 123 ) ) { return; }

    $was_doing = isset( $_REQUEST['woof_products_doing'] );
    $args      = woof()->woof_products( array( 'get_args_only' => 1 ) );

    // All matching IDs, whatever page of the grid is open.
    $args['fields']         = 'ids';
    $args['posts_per_page'] = -1;
    $args['paged']          = 1;
    $args['no_found_rows']  = true;
    $args['orderby']        = 'ID';
    unset( $args['meta_key'] );

    $busy = true;
    $ids  = ( new WP_Query( $args ) )->posts;
    $busy = false;

    if ( ! $was_doing ) {
        unset( $_REQUEST['woof_products_doing'] );
    }

    // Respect a fixed product selection of the element itself.
    $own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
    if ( $own ) {
        $ids = array_values( array_intersect( $ids, $own ) );
    }

    // No match: show "no products" instead of the whole catalog.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );

仕組みは次のとおりです。woof()->woof_products( array( 'get_args_only' => 1 ) ) は、現在のリクエストで [woof_products] が使うクエリ引数を、実行せずに返します。スニペットはそれを一致する商品IDのリストに変換し、そのリストを post__in としてグリッドに渡します。グリッドは独自のレイアウト、並び順、表示件数をそのまま保ちます。同じフックは、テンプレート内で自分で書いた WP_Query にも、product 投稿タイプを問い合わせている限り有効です。

これでフィルタリング中のページでは、すべての商品クエリがフィルターに従います。フッターにある「ベストセラー」や「関連商品」のようなスライダーも含まれます。それが望ましくない場合は、is_page() の行のコメントを外し、グリッドのあるページのIDを指定してください。これにより、ページ上の他の商品リストごとに発生する余分なデータベースクエリも省けます。

AJAXモードにはショップループの2つのフックが必要

ショップをAJAX化する (Try to ajaxify the shop) を はい (Yes) に設定すると(WooCommerce → 設定 → Products Filter → オプション)、プラグインは商品リストを独自のコンテナで包みます。コンテナは woocommerce_before_shop_loop フックで開き、woocommerce_after_shop_loop で閉じます。フィルターを変更するたびに、サーバーに新しいHTMLを要求し、そのコンテナの内容を置き換えます。WooCommerce標準のアーカイブテンプレートは両方のフックを呼び出しますが、多くのビルダーのレイアウトやカスタムテンプレートは呼び出しません。その結果、次の3つの症状のいずれかが現れます。

  • どちらのフックも呼び出されない:置き換えるコンテナがないため、フィルターを変更するたびにページ全体が再読み込みされます。
  • 最初のフックだけが呼び出される:開いたコンテナが閉じられず、残りのレイアウトを飲み込みます。たとえば2列目やサイドバーが、突然商品列の内側に表示されます。
  • フィルタリング後にカードの見た目が変わる:AJAXの結果は、ビルダーのカードデザインではなく、[woof_products] によりサーバー側で標準のWooCommerce商品カードで描画されます。ビルダーで非表示にしていた数量フィールドやカートに追加ボタンが、デフォルトの状態で現れます。

テンプレートのコードを自分で管理できる場合は、ループの前後で両方のフックを呼び出してください。

<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );

woocommerce_product_loop_start();
while ( have_posts() ) {
    the_post();
    wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();

do_action( 'woocommerce_after_shop_loop' );

2つのフックの間にあるものはすべて、AJAXリクエストのたびに置き換えられます。したがって、各商品の周りに置きたいラッパーのマークアップは、アーカイブテンプレートではなく content-product.php に記述してください。独自ループのカスタム条件(たとえば「過去60日間の商品」)は、サーバーが [woof_products] で結果を描画するため、AJAXの結果には含まれません。そのような条件は woof_products_query フックで追加するか、リダイレクトモードを使用してください。

テンプレートを変更できない場合(ビルダーでは普通のことです)は、ショップをAJAX化する (Try to ajaxify the shop) を いいえ (No) に設定してください。リダイレクトモードでは、フィルターを変更するたびにフィルタリング後のURLが読み込まれ、対処法2のスニペットによってビルダーのグリッドが正しい商品を表示します。自動送信をオンにしておけば、各選択はすぐに適用されます。ただしAJAXでの差し替えではなく、ページの読み込みを伴います。

フィルターがショップページに飛ぶ、またはカテゴリーを無視する

結果がショップページで開く。商品アーカイブではないページでは、フィルターのスクリプトがWooCommerceの商品リストを探します。.woocommerce コンテナ内にあるクラス products の要素、またはプラグイン独自の出力です。見つからない場合、検索をショップページへ送るため、ページ上のフィルターが消えたように見えます。対処法1で解決できます。ランディングページやホームページ向けのショートコードの設定は、カスタムページの商品フィルターにあります。対処法2のおかげでビルダーのグリッドがすでにフィルターに反応していても、独自のマークアップを使っている場合は、スクリプトにそのページに留まるよう指示します。

/**
 * HUSKY: keep filter results on this page instead of the shop page.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'wp_footer', function () {
    if ( is_page( 123 ) ) { // ID of the page with the product grid
        echo '<script>var woof_not_redirect = 1;</script>';
    }
} );

フィルターが他のカテゴリーの用語を表示する。プラグインは現在のカテゴリーをWordPress(商品タクソノミーアーカイブのクエリ対象オブジェクト)から取得します。カテゴリーのように見せて作ったWordPressの固定ページにはそれがないため、フィルターはカタログ全体を対象に動作します。本物のカテゴリーアーカイブを使い、ビルダーのアーカイブテンプレートまたはテーマビルダーのテンプレートでスタイルを整えるか、対処法1で示したように両方のショートコードに taxonomies=product_cat:ID を渡してください。WooCommerceのサポートなしで作られたカスタムテーマでは、本物のアーカイブでも同じ現象が起こることがあります。after_setup_theme のコールバックで add_theme_support( 'woocommerce' ) を宣言すると検出は修正されますが、テーマの商品テンプレートの調整が必要になる場合があります。ページが本物のアーカイブなのにカテゴリーがまだ検出されない場合は、詳細設定 → オプションのカテゴリーページの追加チェック (Additional check of the category page) をはい (Yes) に設定してください。ブロックテーマでは、このチェックが自動的に行われます。現在のカテゴリーに商品がない用語を非表示にするには、現在のカテゴリーのフィルターオプションだけを表示する方法を参照してください。

ルーティングの競合:SEO URLとパーマリンク

SEO URLリクエスト拡張機能をオンにすると、フィルターはクエリ文字列ではなく、/shop/swoof/color-red/ のようにパスの一部になります。一部のビルダー(Bricksがよく知られた例です)はURLとテンプレートを独自に解決し、このパスを認識しないため、フィルターのUIは動くのに商品が変わらない、あるいはページがフィルタリングされていないテンプレートに戻ってしまいます。テストするには、詳細設定 → SEO URLリクエストを開き、有効/無効 (Enable/Disable) を いいえ (No) に設定し、すべてのキャッシュを消去してからもう一度フィルタリングします。通常の ?swoof=1&... のリンクが動くなら、原因はルーティングです。そのサイトではSEO URLをオフのままにしてください。

SEO URLにはパーマリンクの設定も必要です。設定 → パーマリンクが基本 (Plain) の場合は、他の構造を選んで保存し、もう一度テストしてください。

ビルダー別のよくあるケース

商品を表示しているもの対処
ビルダーの商品グリッド、投稿カード、リピーター、クエリループ要素(Avada Post Cards、Oxygen Repeater、Bricksのクエリループ、カスタムクエリのQuery Loopブロック)対処法2とリダイレクトモード。または要素を [woof_products] に置き換えます。
ショップやカテゴリーのテンプレートを置き換えるテーマビルダーのレイアウト(Avada layouts、YOOtheme、Flatsome、Beaver Themer、Breakdance)レイアウトがWooCommerceのループを使っていれば、リダイレクトモードで動作します。AJAXモードは、レイアウトがショップループの両方のフックを呼び出す場合のみです。そうでなければ ショップをAJAX化する (Try to ajaxify the shop) を いいえ (No) に設定してください。
Elementorの商品ウィジェットとループグリッドElementorの商品グリッドをフィルター対応にするを参照してください。
PHPテンプレート内の手書きの WP_Query対処法2で対応できます。AJAXモードでは2つのフックを追加してください。
商品クエリやテンプレートを置き換える他のプラグインテストのため無効化してください。それでフィルターが動くなら、そのプラグインが標準のWooCommerceクエリを使う必要があります。

それでも動かない場合

  • ログアウトした状態のプライベートウィンドウでテストしてください。クエリ文字列を無視するページキャッシュは、すべてのフィルターURLに対して同じ未フィルタリングのHTMLを配信します。swoof を含むURLをページキャッシュから除外してください。
  • スニペットを追加した後、フィルターのURLを直接開いてください。それでもグリッドが絞り込まれない場合は、その要素が product 投稿タイプを問い合わせていないか、フィルターのパラメータなしで独自のAJAXリクエストにより後から商品を読み込んでいる可能性があります(一部の「もっと見る」ボタンはこの方式です)。
  • 1ページ目は正しく絞り込まれるのに、2ページ目で404が表示される、または絞り込まれていない商品が表示される場合は、グリッドのページネーションのリンクがフィルターのパラメータを落としています。2ページ目のリンクに swoof=1 と選択内容が含まれているか確認してください。その他の原因はフィルターのページネーションが動作しないに記載しています。

最初のセクションのショートコードのテストは動くのにテンプレートがまだ動かない場合は、ページへのリンク、テーマまたはビルダー、商品を表示している要素を添えて、HUSKYサポートフォーラムでトピックを作成してください。