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/">→</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は「管理しない」を意味します)ため、これとの不一致はフィルタリング後にしか現れません。
- この数を設定しているすべての場所を探します。テーマまたはWooCommerceのカタログ設定、ビルダーの商品ウィジェット、そしてHUSKYのページあたりの商品数 (Products per page)です。
- すべてに同じ数を設定するか、HUSKYの設定を
-1にして干渉しないようにします。 - フィルターなしでテストします。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サポートフォーラムでトピックを作成してください。