Пагинация фильтра WooCommerce не работает: причины и решения
Ситуация, когда пагинация фильтра WooCommerce не работает, обычно проявляется одним из нескольких способов: ссылки страниц ведут на /wp-admin/admin-ajax.php?paged=2, открывается пустая страница с единственным символом 0, пустые страницы или 404 в конце отфильтрованных результатов, фильтр забывается на странице 2, либо бесконечная прокрутка останавливается после первой фильтрации. У каждого симптома своя причина, и большинство из них связаны с тем, как тема строит пагинацию, а не с фильтром. Начните с таблицы, затем переходите к подходящему разделу.
| Что вы видите | Вероятная причина |
|---|---|
Ссылки на admin-ajax.php?paged=2, пустая страница с 0 | Режим AJAX и нестандартная разметка пагинации |
| Две пагинации или две строки «Показано 1–12 из 40» после фильтрации | Тема выводит собственные элементы вне области, которую обновляет HUSKY |
| Страниц больше, чем товаров, последние страницы выдают 404 или пусты | Разное число «товаров на странице» в HUSKY, теме и конструкторе |
| Пустая сетка после смены фильтра на странице 3 | Старый номер страницы переносится в новую ссылку фильтра |
| Фильтр не работает или без оформления после перехода на страницу 2 | Собственная AJAX-пагинация темы, кнопка «загрузить ещё» или бесконечная прокрутка |
| Фильтра нет на странице 2, или страница 2 показывает нефильтрованные товары | Фильтр размещён в содержимом страницы либо ссылки пагинации теряют фильтр |
| Пагинации нет совсем после фильтрации | Нестандартный шаблон или тема, которая выводит пагинацию вне хуков цикла |
Ссылки на admin-ajax.php: режим AJAX и разметка темы
Если Использовать AJAX в магазине (Try to ajaxify the shop) установлено в Да (Yes) (или на странице стоит [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 без action символом 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 в классе обёртки, чтобы всё сломалось), но надёжное решение не требует кода: перейдите в режим перенаправления. Откройте настройки плагина, вкладку Опции (Options), установите Использовать AJAX в магазине (Try to ajaxify the shop) в Нет (No) и сохраните; на страницах с шорткодом используйте is_ajax=0. Тогда каждая фильтрация перезагружает страницу, а пагинация — обычная пагинация темы. Отключить AJAX только для пагинации нельзя. См. также проблемы с пагинацией в режиме AJAX.
Если опция сохраняется, но возвращается в значение Да (Yes), включён режим Turbo. Режим Turbo работает только с AJAX и при каждой загрузке страницы включает опцию обратно; сначала отключите режим Turbo.
Дублирующаяся пагинация или счётчик результатов, который не обновляется
Некоторые темы выводят счётчик результатов, сортировку или пагинацию вне блока, который заменяет HUSKY. После AJAX-фильтрации рядом со свежим элементом вы видите устаревший элемент темы или счётчик, который по-прежнему описывает нефильтрованный магазин. Для счётчика укажите его селектор, обычно .woocommerce-result-count, в Дополнительно → Опции → CSS-селектор количества результатов (Advanced → Options → Result count css selector); после этого HUSKY перерисовывает его после каждой фильтрации (CSS-селектор выпадающего списка сортировки (Order dropdown css selector) делает то же для сортировки). Если дубликаты остаются, их убирает режим перенаправления.
Лишние страницы и 404 в конце результатов
Существует ли /page/7/, WordPress решает по главному запросу страницы: если у главного запроса шесть страниц, страница 7 — это 404, что бы ни показывала сетка товаров на этой странице. Проблемы начинаются, когда видимая сетка и главный запрос считают товары на странице по-разному, например виджет конструктора показывает по 30 товаров, а главный запрос использует 12 из темы: пагинация и существующие номера страниц перестают совпадать, и страницы оказываются пустыми или на полпути заканчиваются ошибкой 404. Собственная настройка HUSKY, Дополнительно → Опции → Товаров на странице (Advanced → Options → Products per page), действует только пока активен фильтр (её значение по умолчанию -1 означает «не управлять»), поэтому расхождение с ней проявляется только после фильтрации.
- Найдите все места, где задаётся это число: настройки каталога темы или WooCommerce, виджет товаров конструктора и Товаров на странице (Products per page) в HUSKY.
- Задайте везде одно и то же число или установите значение HUSKY в
-1, чтобы он не мешал. - Проверьте без фильтра: на минуту деактивируйте HUSKY и откройте напрямую страницу с большим номером, например
/shop/page/17/. Если сейчас это 404, расхождение между темой и конструктором, а не в фильтре.
Если число страниц остаётся завышенным только при фильтрации, тема, вероятно, считает пагинацию по другому запросу; в статье об исправлении пагинации, показывающей слишком много страниц есть сниппет, который принудительно берёт общее число из отфильтрованного запроса. У Avada свой случай, описанный в статье Avada: фильтр теряется при пагинации.
Пустая страница после смены фильтра на странице 2 и дальше
Посетитель на странице 3 меняет фильтр. У нового результата одна страница, поэтому, если новая ссылка по-прежнему запрашивает страницу 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
});
Вместо файла темы тело этой функции можно поместить в Дополнительно → Код → JavaScript-код после завершения AJAX (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 товаров или слаги архивов, могут конфликтовать со ссылками фильтра. Проверьте с отключёнными; об одном известном случае см. 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) = Нет (No), режим Turbo выключен,
is_ajax=0в шорткодах) после очистки всех кэшей. - Разметка пагинации —
nav.woocommerce-paginationсо ссылкамиa.page-numbers. - Число товаров на странице одинаково в теме, конструкторе и HUSKY, либо у HUSKY оно равно
-1. - AJAX-пагинация темы, «загрузить ещё» и бесконечная прокрутка выключены или повторно инициализируются по
woof_ajax_done. - Ссылки пагинации на отфильтрованной странице содержат
swoof=1и значения фильтра, и ни один старый номер страницы не переживает смену фильтра. - Фильтр находится в боковой панели или области шаблона, а не в описании магазина или категории.
Если пагинация по-прежнему не работает в режиме перенаправления со стандартной пагинацией темы, создайте тему на форуме поддержки HUSKY со ссылкой на страницу и адресом страницы, на которой происходит сбой.