HUSKY - WooCommerce Product Filter Professional

Elementor Loop GridのWooCommerceフィルターが効かない時の対処法

Elementorで作ったショップでフィルターにチェックを入れても、Loop Gridが全商品を表示したままだったり、複数選択した値のうち最初の1つしか適用されなかったり、フィルター後にカテゴリーテンプレートが標準のWooCommerce一覧に変わってしまったりすることがあります。Elementor Loop GridでWooCommerceフィルターが効かない場合、原因は2つの点で決まります。商品を出力しているのがどのElementor要素か、そしてHUSKYのAJAXモードが有効かどうかです。まず要素を特定してください。対処法は要素ごとに異なります。

商品を表示しているElementor要素はどれか

HUSKYは商品グリッドを描画しません。WooCommerceの商品クエリに条件を追加するだけです。対象は、ショップおよびカテゴリー・タグ・属性アーカイブのメインクエリ、WooCommerceの [products] ショートコードで作られるクエリ、そしてHUSKY独自の [woof_products] ショートコードです。独自のクエリを組み立てるElementor要素には、フィルターの内容が届きません。

要素フィルターに従うか対処
Theme Builderの商品アーカイブ内にある Archive Products ウィジェット、または Current Query を設定した Products ウィジェットはい。ショップのメインクエリを使用しますリダイレクトモードならデザインを維持できます。AJAXモードとカテゴリーテンプレートについてはアーカイブの項を参照してください
独自のクエリソース(新着、セール、おすすめ商品)を持つ Products ウィジェット通常は従います。このウィジェットはWooCommerceの商品ショートコードをベースにしています特別な対応は不要です。フィルター適用時にページが再読み込みされます
商品ループテンプレートを使う Loop Gridいいえ。独自のクエリを実行しますクエリがフィルターに従うようにするか、要素を置き換えます
アドオンパックの商品グリッド(WooLentor、Premium Addons、Unlimited Elements、JetWooBuilderなど)多くは従いませんLoop Gridと同じです
[woof_products] を入れた Shortcode ウィジェットはい。AJAXでも従いますどのページでも動作します。テーマのWooCommerce商品カードが使われます

次の3つの簡単な確認で、どのケースに該当するかがわかります。

  1. フィルター後のURLに swoof=1 と選択内容が含まれている。その場合、フィルターは役目を果たしており、要素がリクエストを無視しています。
  2. 比較用の要素。グリッドの隣に [woof_products per_page=4] を入れた Shortcode ウィジェットを置き、フィルターをかけて結果を比べます。ショートコードは絞り込まれるのにグリッドが絞り込まれない場合、そのグリッドは独自のクエリを実行しています。
  3. AJAXエリア。ページのソース(Ctrl+U)を開き、woof_results_by_ajax を検索します。見つからなければ、AJAXモードが差し替える対象がなく、AJAXを有効にしていてもフィルターを変更するたびにページが再読み込みされます。

Loop Gridとアドオンのウィジェット:クエリをフィルターに従わせる

Loop Gridはデータベースから商品を独自に取得するため、カタログ全体を表示し続けます。対処法は3つあり、「ループのデザインを維持する方法」から「コード量が最も少ない方法」の順に並べています。

Loop Gridを維持する:pre_get_postsでクエリを制限する

短いスニペットでHUSKYに現在のフィルターに一致する商品を問い合わせ、ページ上の他のすべての商品クエリをそれらの商品に限定します。「フィルターのURLは変わるが商品が変わらない」の対処2にある強化版を使い、子テーマの functions.php またはコードスニペット系プラグインにコピーしてください。Elementor互換性FAQにある古いコードと比べると、wp-adminの商品リストには影響せず、グリッドの2ページ目以降も絞り込みが維持され、一致する商品がない場合は全カタログではなく「見つかりません」と表示されます。2つのスニペットを同時に動かさず、古いほうを置き換えてください。

そのうえで、次のように設定を調整します。

  • フィルター適用時にページが再読み込みされる必要があります。スニペットは、フィルター済みのURLが読み込まれる際にグリッドを絞り込みます。Loop GridにはAJAXエリアがないため、これは自動的に行われます。ページにAJAXエリアもある場合(上記の確認3)は、ショップをAJAX化する (Try to ajaxify the shop) を いいえ (No) に設定してください(WooCommerce → 設定 → Products Filter → オプション)。そうしないと、そのエリアだけが更新されます。
  • 通常のページ(Theme Builderのアーカイブではないページ)では、WooCommerceの商品リストか [woof_products] が見つからない限り、フィルターは結果をショップページに送ります。Loop Gridはそのどちらでもありません。ページにとどまるよう指定します。
    /**
     * HUSKY: keep filter results on the page with the Loop Grid.
     * Child theme functions.php or a code snippets plugin.
     */
    add_action( 'wp_footer', function () {
        if ( is_page( 123 ) ) { // ID of the page with the Loop Grid
            echo '<script>var woof_not_redirect = 1;</script>';
        }
    } );
  • このスニペットは、フィルター済みのページ上のすべての商品クエリ(「関連商品」や「ベストセラー」のカルーセルを含む)に影響します。1つのページだけに限定するには、is_page() の行のコメントを外し、そのページのIDを入力してください。
  • スニペットを追加するのは、要素が実際に独自のクエリを実行している場所だけにしてください。Archive Products ウィジェットが商品を表示している場所では不要です。以前にそこへ追加した場合は削除してください。
  • フィルター後に、グリッドの2ページ目へのリンクを確認してください。swoof=1 と選択した値が引き続き含まれている必要があります。それらなしで次のページを取得する「もっと見る」や無限スクロールのモードでは、2ページ目以降に絞り込まれていない商品が表示されます。番号付きページネーションを試し、リンクを再度確認してください。

Productsウィジェットに切り替える

Elementor ProのProductsウィジェットは、通常コードなしでフィルターに従います。アーカイブでは Current Query を使い、それ以外では独自のクエリソースを使います。ウィジェット自身のコントロールで整えたカードデザインで十分であれば、Loop Gridの最も簡単な代替手段です。

[woof_products]ショートコードを使う

プラグインの [woof_products] ショートコードを入れた Shortcode ウィジェットは、どのページでも絞り込みができ、AJAXにも対応しています。

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

各商品は、Elementorのループテンプレートではなく、テーマのWooCommerceカード(content-product.php)で描画されます。1つのカテゴリーを表示するページでは、フィルターと商品リストに同じ条件を指定します。[woof taxonomies=product_cat:25] と [woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1] のように、25の部分は自分のカテゴリーIDに置き換えてください。

複数の値を選択しても最初の1つしか適用されない

1つの属性の値同士にOR条件を使う場合、赤・青・緑を選択すると、3色のいずれかを持つ商品が表示されるはずです。アーカイブテンプレート上で Current Query に設定した Loop Grid が赤だけを表示する場合、その Loop Grid はリクエストから独自の方法でクエリを組み立て、最初の値だけを残しています。フィルター自体に問題はありません。同じリクエストでも、Productsウィジェットや [woof_products] では正しい商品が表示されます。

Loop Gridを、Current Query に設定した Products ウィジェット、または [woof_products] に置き換えてください。あわせて、その属性が実際にORを使っているかも確認します。構造 (Structure) タブで属性の追加オプションを開き、フィルタリングのロジック (Logic of filtering) を見てください。ANDが機能するのは、チェックボックスのように複数の値を許可するフィルタータイプだけです。

Theme Builderのアーカイブ:デザインの崩れと誤ったテンプレート

AJAXの結果が標準のWooCommerce一覧のように見える

Archive Products ウィジェット内にAJAXエリアがある場合、フィルターを変更するたびに商品がその場で差し替えられます。ただし新しいHTMLは、Elementorのページレンダリングの外で、WooCommerceの標準パーツを使って [woof_products] によりサーバー側で生成されます。そこにはElementorのクラスやウィジェット設定が含まれないため、商品はウィジェットのグリッド、余白、ボタンのテキストを失います。AJAXモードがグリッドをどのように再構築するかは、AJAXフィルターで商品グリッドのレイアウトが崩れるで説明しています。

確実な対処法は ショップをAJAX化する (Try to ajaxify the shop) を いいえ (No) にすることです。フィルター済みのURLはElementorによって描画され、テンプレートとまったく同じ見た目になります。AJAXを維持したい場合は、woof_draw_products_html フィルターでレスポンスを修正し、ElementorのグリッドCSSが再び適用されるようにします。

/**
 * HUSKY AJAX results inside an Elementor Archive Products widget:
 * add the class Elementor's grid styles expect.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
    return str_replace(
        '<ul class="products columns-',
        '<ul class="products elementor-grid columns-',
        $html
    );
}, 10, 2 );

使用する前に、ページを新規に読み込んだ状態で商品リストを検査し、ul.products のクラス名を確認してください。異なる場合は、自分のページにあるクラス名を使います。余分な要素で包まれたボタンや変更されたラベルといった残りの差異は、PHPよりも数行のCSSで直すほうが簡単です。フィルター後に列数が変わる場合は、レイアウトの記事に示したとおり loop_shop_columns で設定してください。

フィルター済みのカテゴリーページでショップテンプレートが使われる

フィルターが有効な間、HUSKYはデフォルトでリクエストを商品投稿タイプのアーカイブとして扱い、WordPressの「タクソノミーアーカイブ」フラグをオフにします。するとElementorの表示条件はカテゴリーではなくショップと判断します。「商品カテゴリー」に割り当てたテンプレートは一般的なテンプレートに置き換わり、アーカイブのタイトルにはカテゴリー名ではなくショップ名が表示されます。詳細設定 → オプションで swoofの影響を無効にする (Disable swoof influence) を はい (Yes) に設定し、再度テストしてください。詳細と副作用はフィルター時にカテゴリーページを維持するを参照してください。

カテゴリーテンプレートでストア全体の数が表示される場合、原因は通常フィルターのショートコード自体にあります。dynamic_recount=0 を指定した [woof] は、現在のカテゴリーに対して再カウントを行いません。この属性を削除するか、1に設定してください。

Elementorのポップアップやオフキャンバス内のフィルターが動作しない

HUSKYは、ページの準備が整った時点で一度だけ、フィルターフォームにスクリプトを割り当てます。ポップアップやオフキャンバスがコンテンツを後から挿入すると、フィルターは表示されるもののクリックしても何も起こりません。新しいフォームが初期化されていないためです。ページのソースを開いて woof_redraw_zone を検索してください。ポップアップを開く前にフィルターのマークアップがなければ、このケースに該当します。

代わりに、プラグイン独自のスライドアウトパネルを使います。Shortcode ウィジェットに [woof_slideout location="left"] を入れるか、スライドアウト (Slideout) タブで グローバル表示 (Global visibility) を 表示 (Show) に設定して、ショップページに追加します。そのフォームは最初からページの一部なので、他のフィルターと同様に動作します。そのほかの方法として、コンテンツをページと一緒に描画するポップアップや、ボタンで表示・非表示を切り替えるセクションがあります。

HUSKYを有効にするとElementorエディターが読み込まれない

旧バージョンで発生していたエディターのエラー(Call to a member function get() on null)は、現行のリリースで対処済みです。ページをElementorエディターで開くと、[woof_products] はショップループのフックをスキップします。まずプラグインを更新してください。HUSKYが有効な間だけエディターが固まる場合は、ElementorのパネルからHUSKYの従来型WordPressウィジェットを削除してください。フィルターは引き続き Shortcode ウィジェットで配置できます。

/**
 * Hide HUSKY's WordPress widget from the Elementor panel.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'elementor/widgets/register', function ( $widgets_manager ) {
    $widgets_manager->unregister( 'wp-widget-woof_widget' );
} );

これは現行のElementorバージョンの登録フックを使用しています。Elementorエディターの競合FAQにある古いフックは、現行バージョンでは非推奨です。

チェックリスト

  • 商品を出力している要素がわかっており、同じページで比較用の [woof_products] が正しく絞り込みを行っている。
  • Loop Gridまたはアドオンのグリッド:古いスニペットの代わりに強化版の pre_get_posts スニペットを導入し、フィルター適用時にページが再読み込みされ、2ページ目のリンクに swoof=1 が維持されている。
  • 1つの属性の複数の値:Current Query の Loop Grid の代わりに、Productsウィジェットまたは [woof_products] を使う。
  • Theme Builderのカテゴリーテンプレート:swoofの影響を無効にする (Disable swoof influence) = はい (Yes)。AJAXをオフにするか、woof_draw_products_html でレスポンスを修正する。
  • ポップアップ内のフィルター:[woof_slideout] に置き換える。
  • キャッシュを消去し、プライベートウィンドウで結果をテストした。

比較用のショートコードが動作するのにElementor要素が動作しない場合は、ページへのリンクと、商品を表示している要素およびアドオンの名前を添えて、HUSKYサポートフォーラムでトピックを作成してください。