HUSKY - WooCommerce Product Filter Professional

Пагинация фильтра 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/">&rarr;</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 означает «не управлять»), поэтому расхождение с ней проявляется только после фильтрации.

  1. Найдите все места, где задаётся это число: настройки каталога темы или WooCommerce, виджет товаров конструктора и Товаров на странице (Products per page) в HUSKY.
  2. Задайте везде одно и то же число или установите значение HUSKY в -1, чтобы он не мешал.
  3. Проверьте без фильтра: на минуту деактивируйте 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 со ссылкой на страницу и адресом страницы, на которой происходит сбой.