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, власна функція пагінації), клік не перехоплюється, і браузер відкриває сире посилання. На запит до admin-ajax.php без action WordPress відповідає 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 товарів або slug архівів, можуть конфліктувати з посиланнями фільтра. Перевірте з вимкненими ними; про один відомий випадок див. 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 з посиланням на сторінку та адресою сторінки, яка дає збій.