HUSKY - WooCommerce Product Filter Professional

WooCommerceフィルターのページネーションが動かない原因と対処

WooCommerceのフィルターでページネーションが機能しない場合の症状は、たいていいくつかの形で現れます。ページリンクが/wp-admin/admin-ajax.php?paged=2を指す、0だけが表示された白紙のページになる、フィルター結果の最後で空のページや404になる、2ページ目でフィルターが忘れられる、最初のフィルタリング後に無限スクロールが止まる、などです。症状ごとに原因は異なり、そのほとんどはフィルターではなく、テーマがページネーションを構築する方法に起因します。まず表を確認し、該当するセクションに進んでください。

見える症状考えられる原因
admin-ajax.php?paged=2へのリンク、0だけの白紙ページ標準的でないページネーションのマークアップでのAJAXモード
フィルタリング後にページネーションが2つ、または「全40件中1~12件を表示」の行が2つ表示されるテーマが、HUSKYが更新する領域の外に独自の要素を出力している
商品数に比べてページ数が多く、最後のページが404または空になるHUSKY、テーマ、ビルダーで「ページあたりの商品数」が異なる
3ページ目でフィルターを変更すると、グリッドが空になる古いページ番号が新しいフィルターのリンクに引き継がれている
2ページ目に移動した後、フィルターが動かない、またはスタイルが崩れるテーマ独自のAJAXページネーション、「もっと見る」、または無限スクロール
2ページ目でフィルターが消える、または2ページ目にフィルターされていない商品が表示されるフィルターがページコンテンツ内に置かれている、またはフィルターを落とすページネーションリンク
フィルタリング後にページネーションがまったく表示されないループフックの外にページネーションを出力するカスタムテンプレートまたはテーマ

admin-ajax.phpへのリンク:AJAXモードとテーマのマークアップ

ショップをAJAX化する (Try to ajaxify the shop)をはいに設定した場合(またはページで[woof_products is_ajax=1]を使用した場合)、HUSKYはページを再読み込みしません。admin-ajax.php経由でサーバーに新しい商品を要求し、ページネーションを含む商品ブロックを置き換えます。この新しいページネーションはAJAXリクエストの中で生成されるため、そのリンクはadmin-ajax.php?paged=2を指します。これらのリンクはたどられることを想定していません。HUSKYは.woocommerce-pagination a.page-numbersへのクリックを捕捉し、ページ番号を読み取って、そのページをAJAXで読み込みます。

テーマがページネーションのマークアップを変更している場合(ラッパーのクラスが異なる、リンクにpage-numbersクラスがない、独自のページネーション関数を使っているなど)、クリックは捕捉されず、ブラウザーは生のリンクを開いてしまいます。WordPressはアクションなしのadmin-ajax.phpへのリクエストに0を返します。これが白紙のページの正体です。HUSKYが期待するマークアップは、WooCommerce標準のものです。

<nav class="woocommerce-pagination">
  <ul class="page-numbers">
    <li><span aria-current="page" class="page-numbers current">1</span></li>
    <li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
    <li><a class="next page-numbers" href="https://example.com/shop/page/2/">&rarr;</a></li>
  </ul>
</nav>

ブラウザーでお使いのページネーションを検証し、比較してください。woocommerce/loop/pagination.phpを上書きしているテーマや、独自のページネーションを使っているテーマは、子テーマで修正できます(ラッパーのクラスのwoocmmerce-paginationのようなタイプミス1つでも壊れます)。ただし、確実な対処法にコードは不要です。リダイレクトモードに切り替えます。プラグインの設定のオプション (Options)タブで、ショップをAJAX化する (Try to ajaxify the shop)をいいえに設定して保存してください。ショートコードを使うページではis_ajax=0を使用します。これで、フィルタリングのたびにページが再読み込みされ、ページネーションはテーマの通常のページネーションになります。AJAXをページネーションだけオフにすることはできません。AJAXモードでのページネーションの問題も参照してください。

保存されたと表示されるのにオプションがはいに戻る場合は、ターボモードが有効になっています。ターボモードはAJAXでのみ動作し、ページを読み込むたびにこのオプションをオンに戻します。先にターボモードを無効にしてください。

ページネーションの重複、または更新されない結果件数

テーマによっては、結果件数、並べ替え、ページネーションを、HUSKYが置き換えるブロックの外側に出力します。その場合、AJAXフィルタリングの後に、更新された要素の隣にテーマの古い要素が残ったり、フィルターされていないショップの件数のままだったりします。件数については、そのセレクター(通常は.woocommerce-result-count)を詳細設定 → オプション → 結果カウントのCSSセレクター (Advanced → Options → Result count css selector)に入力します。すると、HUSKYがフィルタリングのたびにそれを再描画します(並べ替えには並べ替えドロップダウンのCSSセレクター (Order dropdown css selector)が同じ働きをします)。重複が残る場合は、リダイレクトモードで解消します。

余分なページと、結果の最後の404

WordPressは、/page/7/が存在するかどうかを、ページのメインクエリから判断します。メインクエリが6ページ分なら、そのページの商品グリッドが何を表示していても、7ページ目は404です。問題が始まるのは、見えているグリッドとメインクエリで1ページあたりの商品数の数え方が異なる場合です。たとえば、ビルダーのウィジェットが30件ずつ表示する一方、メインクエリはテーマの12件を使っているような場合、ページネーションと実在するページ番号が一致せず、ページが空になったり、途中で404になったりします。HUSKY独自の設定である詳細設定 → オプション → ページあたりの商品数 (Advanced → Options → Products per page)は、フィルターが有効な間だけ適用される(既定値の-1は「管理しない」を意味します)ため、これとの不一致はフィルタリング後にしか現れません。

  1. この数を設定しているすべての場所を探します。テーマまたはWooCommerceのカタログ設定、ビルダーの商品ウィジェット、そしてHUSKYのページあたりの商品数 (Products per page)です。
  2. すべてに同じ数を設定するか、HUSKYの設定を-1にして干渉しないようにします。
  3. フィルターなしでテストします。HUSKYを一時的に無効化し、/shop/page/17/のような大きなページ番号を直接開きます。これで404になる場合、不一致はフィルターではなく、テーマとビルダーの間にあります。

フィルタリング中だけページ数がまだ多すぎる場合、テーマが別のクエリからページネーションを計算している可能性があります。ページ数が多すぎるページネーションの修正には、フィルター後のクエリから合計を強制的に取得するスニペットがあります。Avadaには独自のケースがあり、Avada:ページネーションでフィルターが失われるで説明しています。

2ページ目以降でフィルターを変更すると空のページになる

訪問者が3ページ目でフィルターを変更したとします。新しい結果は1ページしかないので、新しいリンクがまだ3ページ目を要求していると、グリッドは空になるか、ページが404になります。HUSKYは標準のページネーションについてはこれを防ぎます。構築するリンクから/page/N/とWooCommerceのproduct-pageパラメーターを取り除き、AJAXモードでは変更のたびに1ページ目へリセットします。クエリ文字列にあるほかのページパラメーターは、アドレスの残りの部分と一緒に新しいリンクにコピーされます。たとえば、基本パーマリンクのサイトでの?paged=3や、ページビルダー独自のページネーションパラメーターです。美しいパーマリンクを使い(設定 → パーマリンク (Settings → Permalinks)で、基本 (Plain)以外の任意の構造)、WooCommerce標準のページネーションを使用し、フィルターを変更した後にアドレスを確認してください。ページ番号が含まれていないはずです。

テーマのAJAXページネーション、「もっと見る」、無限スクロール

多くのテーマには独自のAJAXショップ機能があります。ページネーション、「もっと見る」ボタン、無限スクロール、AJAXによる並べ替え、グリッドとリストの切り替えなどが、再読み込みなしで商品とサイドバーを置き換えます。HUSKYはページの読み込み時(および自身のAJAX更新の後)にフォームを初期化します。テーマが新しいサイドバーのHTMLに差し替えると、新しいフィルター要素は初期化されないため、フィルターが反応しなくなったり、スタイルが失われたり、誤った値が送信されたりします。また、テーマの「もっと見る」リクエストは「次のページ」用に独自のクエリを構築し、フィルターについては何も知らないため、フィルター済みのリストにフィルターされていない商品が追加されることがあります。

  • テーマのAJAXページネーション、AJAXショップ、無限スクロール、「もっと見る」のオプションをオフにして、標準のページネーションでテストしてください。これでほとんどのケースが解決します。
  • 無限スクロールについては、HUSKYは無料のYITH Infinite Scrollingプラグインに対応しています。AJAXフィルタリングのたびにスクロールを再初期化し、次ページのリンクを修正します。フィルター済み商品の無限スクロールに記載されているセレクターを使用してください。
  • AJAXフィルタリングの後に再起動が必要なほかのスクリプトは、woof_ajax_doneイベントを待ち受けることができます。これはwoof_ajax_doneイベントで説明しています。再起動にどの呼び出しが必要かはそのスクリプト次第なので、作者に確認してください。
/*
 * Runs after every HUSKY AJAX filtering.
 * Put it in a JavaScript file of your child theme.
 */
jQuery(document).on('woof_ajax_done', function () {
    // call the init function of your infinite scroll or load-more script here
});

テーマのファイルの代わりに、その関数の本体を詳細設定 → コード → AJAX完了後のJavaScriptコード (Advanced → Code → JavaScript code after AJAX is done)に入れることもできます。

2ページ目でフィルターが消える、または忘れられる

  • 2ページ目でフィルターが消える。フィルターがショップページのコンテンツ、またはカテゴリーの説明に置かれています。WooCommerceはどちらも、アーカイブの最初のページにだけ出力します。フィルターは、サイドバーウィジェット、すべてのページに表示されるテーマの領域、または説明の外側にあるビルダーのブロックに置いてください。
  • 2ページ目にフィルターされていない商品が表示される。リダイレクトモードでは、WooCommerce標準のページネーションがリンクにフィルターを保持します(/shop/page/2/?swoof=1&pa_color=red)。ページリンクにカーソルを合わせてください。swoof=1とフィルターの値がなければ、テーマがクエリ文字列なしで独自のリンクを構築しています。標準のページネーションに切り替えるか、テーマのリンク関数を修正してください。
  • 2ページ目がショップにリダイレクトされる、またはカテゴリーが失われる。商品URLやアーカイブのスラッグを書き換えるプラグインやカスタムコードは、フィルターのリンクと競合することがあります。それらを無効にしてテストしてください。既知の1つの事例については、HUSKYとPermalinks Manager Proを参照してください。

フィルタリング後にページネーションが表示されない

AJAXモードでは、更新されるブロックには、WooCommerceがwoocommerce_after_shop_loopフックに出力するものがすべて含まれており、WooCommerceのページネーションはそこにあります。テーマがこのフックからページネーションを取り除き、別の場所に独自のものを出力していると、最初のAJAXフィルタリングの後にそれが失われます。リダイレクトモードなら問題を回避できます。独自のアーカイブテンプレートを作成した場合は、商品ループの後に、自分でページネーションを出力してください。

<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>

カスタムテンプレートでも、AJAXモードがそもそも機能するためには、標準のショップループフックが必要です。どのフックかはフィルターのURLは変わるのに商品が変わらないで説明しています。

ページ変更後に訪問者を商品の先頭に戻すには、AJAXフィルタリング後の自動スクロールを、リダイレクトモードではリダイレクトモードでの商品への自動スクロールを参照してください。

WooCommerceフィルターのページネーションが機能しない場合のチェックリスト

  • すべてのキャッシュをクリアしたうえで、リダイレクトモード(ショップをAJAX化する (Try to ajaxify the shop)をいいえ、ターボモードをオフ、ショートコードでis_ajax=0)でテストした。
  • ページネーションのマークアップが、a.page-numbersリンクを持つnav.woocommerce-paginationである。
  • ページあたりの商品数が、テーマ、ビルダー、HUSKYで同じ、またはHUSKYの設定が-1である。
  • テーマのAJAXページネーション、「もっと見る」、無限スクロールがオフ、またはwoof_ajax_doneで再初期化されている。
  • フィルター済みページのページネーションリンクにswoof=1とフィルターの値が含まれ、フィルターを変更しても古いページ番号が残らない。
  • フィルターが、ショップやカテゴリーの説明ではなく、サイドバーまたはテンプレートの領域に置かれている。

テーマの標準のページネーションを使ったリダイレクトモードでもページネーションが失敗する場合は、ページへのリンクと、失敗するページのアドレスを添えて、HUSKYサポートフォーラムでトピックを作成してください。