HUSKY - WooCommerce Product Filter Professional

URL фільтра WooCommerce змінюється, а товари ні: як виправити

Ви відмічаєте колір або категорію, з’являється індикатор завантаження, адресний рядок змінюється на щось на кшталт /shop/?swoof=1&pa_color=red, а сітка товарів показує ті самі товари. Коли URL фільтра WooCommerce змінюється, а товари ні, фільтр свою роботу виконав: він сформував пошуковий запит. Шаблон, який виводить товари, його просто не прочитав. Цей посібник показує, як підтвердити це за дві хвилини і як зробити так, щоб тема, конструктор сторінок або власний шаблон реагували на фільтр.

Чому URL фільтра змінюється, а товари ні

HUSKY не малює сітку товарів вашого магазину. Він додає свої умови (таксономії, ціну, мета-поля, текст) до запитів товарів, які WooCommerce уже виконує, і лише до них:

  • головного запиту сторінки магазину та архівів категорій, тегів і атрибутів товарів (крок WooCommerce woocommerce_product_query);
  • власного шорткоду плагіна [woof_products];
  • шорткодів товарів WooCommerce, таких як [products], через woocommerce_shortcode_products_query.

Список товарів, який будує власний WP_Query, перебуває поза цим шляхом. Сітки товарів конструкторів сторінок, картки записів і повторювачі, елементи «query loop», макети архівів теми з власним запитом і написані вручну цикли в PHP-шаблоні запитують у бази даних товари по-своєму, тому показують увесь каталог, що б не вказував фільтр. У фільтрі нічого не зламано; просто список його не слухає.

Два пов’язані симптоми мають те саме коріння. На звичайній сторінці, де скрипт фільтра не знаходить списку товарів WooCommerce, він відправляє відвідувача на сторінку магазину, щоб показати результати. А на «сторінці категорії», яка насправді є сторінкою WordPress, створеною в конструкторі, фільтр не знає поточної категорії, тому пропонує всі терміни й шукає по всьому каталогу.

Підтвердьте причину за дві хвилини

  1. Прочитайте URL після фільтрації. Якщо він містить swoof=1 і ваш вибір (/swoof/ з подальшим вибором, коли SEO URL увімкнено, або лише min_price і max_price, коли єдиний вибір — ціна), фільтр спрацював. Якщо URL не змінюється взагалі, фільтр так і не надіслав запит: спершу пошукайте помилку JavaScript у консолі браузера.
  2. Спробуйте той самий запит на стандартній сторінці магазину. Скопіюйте все, починаючи з ?swoof=1, і додайте до URL сторінки магазину WooCommerce. Якщо там товари відфільтровано, а на вашій сторінці ні, це прямо вказує на список товарів вашої сторінки.
  3. Перевірте на простому шорткоді. На чернетці сторінки розмістіть [woof], а під ним [woof_products per_page=12] або [products limit="12"] від WooCommerce. Якщо вони фільтрують правильно, застосуйте одне з виправлень нижче до вашої справжньої сторінки.
  4. З’ясуйте, що це за сторінка. Подивіться на екран редагування: Сторінка (Page) WordPress із сіткою товарів не є архівом товарів, навіть якщо її URL виглядає як /category/shoes/.

Виправлення 1: виводьте товари через [woof_products]

Найнадійніше виправлення — дозволити плагіну самому виводити товари. Замініть елемент товарів конструктора віджетом або блоком Shortcode, що містить [woof_products]:

[woof_products per_page=12 columns=4 is_ajax=1]

Шорткод реагує на фільтр на будь-якій сторінці, підтримує режим AJAX з is_ajax=1 і відображає кожен товар звичайною карткою товару WooCommerce вашої теми (частина шаблону content-product.php), тому виглядає як магазин. Щоб використати іншу частину шаблону, змініть її фільтром woof_template_part.

Для сторінки, що має показувати лише одну категорію, задайте ту саму умову обом шорткодам, інакше фільтр пропонуватиме терміни з усього каталогу:

[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]

Замініть 25 на ID категорії (його видно в URL під час редагування категорії). Власний шорткод WooCommerce [products] також фільтрується, але лише з перезавантаженням сторінки. Якщо він потрібен в режимі AJAX, запишіть його як [products_woof limit="12" columns="4"]: плагін обгортає його так, щоб результати можна було підміняти без перезавантаження.

Виправлення 2: змусьте сітку конструктора або власний WP_Query слухати фільтр

Якщо потрібно зберегти власний дизайн карток конструктора, зробіть так, щоб його запит використовував результат фільтра. Сніпет нижче підключається до pre_get_posts, запитує в HUSKY, які товари відповідають поточному фільтру, і обмежує запит сітки ними. Це доопрацьована версія коду зі статті Як зробити конструктори сторінок і власні шаблони придатними до фільтрації: він не чіпає списки товарів у wp-admin, зберігає роботу пагінації сітки, враховує фіксований вибір товарів самого елемента і показує «немає товарів» замість усього каталогу, коли нічого не знайдено.

/**
 * HUSKY: apply the active filter to product lists that run their own query
 * (page builder grids, post cards, query loops, custom templates).
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'pre_get_posts', function ( $query ) {
    static $busy = false;

    if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
        return;
    }
    // Keep the product lists in wp-admin untouched.
    if ( is_admin() && ! wp_doing_ajax() ) {
        return;
    }
    // Product queries only.
    if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
        return;
    }
    // WooCommerce archives and [woof_products] are filtered already.
    if ( 'product_query' === $query->get( 'wc_query' ) ) {
        return;
    }
    // Only while a filter is active: ?swoof=1, an SEO URL,
    // or ?min_price=...&max_price=... when only the price is set.
    $request = woof()->get_request_data();
    if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
        return;
    }
    // Optional: limit to one page.
    // if ( ! is_page( 123 ) ) { return; }

    $was_doing = isset( $_REQUEST['woof_products_doing'] );
    $args      = woof()->woof_products( array( 'get_args_only' => 1 ) );

    // All matching IDs, whatever page of the grid is open.
    $args['fields']         = 'ids';
    $args['posts_per_page'] = -1;
    $args['paged']          = 1;
    $args['no_found_rows']  = true;
    $args['orderby']        = 'ID';
    unset( $args['meta_key'] );

    $busy = true;
    $ids  = ( new WP_Query( $args ) )->posts;
    $busy = false;

    if ( ! $was_doing ) {
        unset( $_REQUEST['woof_products_doing'] );
    }

    // Respect a fixed product selection of the element itself.
    $own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
    if ( $own ) {
        $ids = array_values( array_intersect( $ids, $own ) );
    }

    // No match: show "no products" instead of the whole catalog.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );

Як це працює: woof()->woof_products( array( 'get_args_only' => 1 ) ) повертає аргументи запиту, які [woof_products] використав би для поточного запиту, не виконуючи його. Сніпет перетворює їх на список ID відповідних товарів і передає цей список сітці як post__in. Сітка зберігає власний макет, сортування та розмір сторінки. Той самий гак охоплює і WP_Query, який ви пишете самі в шаблоні, якщо він запитує тип запису product.

Тепер кожен запит товарів на відфільтрованій сторінці підпорядковується фільтру, зокрема слайдери на кшталт «бестселери» або «схожі товари» у футері. Якщо це не те, що вам потрібно, розкоментуйте рядок з is_page() і вкажіть ID сторінки із сіткою; це також заощадить один зайвий запит до бази даних для кожного іншого списку товарів на сторінці.

Режиму AJAX потрібні два гаки циклу магазину

Коли Спробувати зробити магазин AJAX-сумісним (Try to ajaxify the shop) має значення Так (Yes) (WooCommerce → Settings → Products Filter → Options), плагін обгортає список товарів власним контейнером. Він відкриває контейнер на гаку woocommerce_before_shop_loop і закриває його на woocommerce_after_shop_loop. Після кожної зміни фільтра він запитує в сервера новий HTML і замінює вміст цього контейнера. Стандартний шаблон архіву WooCommerce викликає обидва гаки; багато макетів конструкторів і власних шаблонів — ні. Результат — один із трьох симптомів:

  • Жоден гак не викликається: немає контейнера, який можна замінити, тому кожна зміна фільтра перезавантажує всю сторінку.
  • Викликається лише перший гак: відкритий контейнер ніколи не закривається й поглинає решту макета, наприклад другу колонку або бічну панель, яка раптом з’являється всередині колонки з товарами.
  • Картки змінюють вигляд після фільтрації: AJAX-результати рендеряться на сервері шорткодом [woof_products] зі стандартною карткою товару WooCommerce, а не дизайном карток конструктора. Типові поля кількості або кнопки додавання до кошика з’являються там, де конструктор їх приховав.

Якщо ви керуєте кодом шаблону, викличте обидва гаки навколо циклу:

<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );

woocommerce_product_loop_start();
while ( have_posts() ) {
    the_post();
    wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();

do_action( 'woocommerce_after_shop_loop' );

Усе між двома гаками замінюється при кожному AJAX-запиті, тому обгортальна розмітка навколо кожного товару має бути в content-product.php, а не в шаблоні архіву. Власні умови вашого циклу (наприклад, «товари за останні 60 днів») не входять до AJAX-результату, бо сервер рендерить його через [woof_products]; додайте такі умови гаком woof_products_query або використайте режим переадресації.

Якщо ви не можете змінити шаблон, а з конструкторами це звична ситуація, встановіть Спробувати зробити магазин AJAX-сумісним (Try to ajaxify the shop) у значення Ні (No). У режимі переадресації кожна зміна фільтра завантажує відфільтрований URL, а сніпет із Виправлення 2 змушує сітку конструктора показувати правильні товари. З увімкненим автоматичним надсиланням кожен вибір застосовується одразу, лише із завантаженням сторінки замість AJAX-підміни.

Фільтр перекидає на сторінку магазину або ігнорує категорію

Результати відкриваються на сторінці магазину. На сторінці, що не є архівом товарів, скрипт фільтра шукає список товарів WooCommerce: елемент із класом products усередині контейнера .woocommerce або власний вивід плагіна. Якщо він нічого не знаходить, то відправляє пошук на сторінку магазину, і фільтр на вашій сторінці ніби зникає. Виправлення 1 вирішує це; налаштування шорткодів для посадкових сторінок і головної є в фільтрі товарів на власній сторінці. Якщо сітка вашого конструктора вже реагує на фільтр завдяки Виправленню 2, але використовує іншу розмітку, скажіть скрипту залишатися на сторінці:

/**
 * HUSKY: keep filter results on this page instead of the shop page.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'wp_footer', function () {
    if ( is_page( 123 ) ) { // ID of the page with the product grid
        echo '<script>var woof_not_redirect = 1;</script>';
    }
} );

Фільтр пропонує терміни з інших категорій. Плагін бере поточну категорію з WordPress (запитаний об’єкт архіву таксономії товарів). Сторінка WordPress, зроблена схожою на категорію, його не має, тому фільтр працює з усім каталогом. Використовуйте справжній архів категорії та оформіть його за допомогою шаблону архіву конструктора або theme-builder, або передайте taxonomies=product_cat:ID обом шорткодам, як показано у Виправленні 1. Власна тема, створена без підтримки WooCommerce, може давати такий самий ефект і на справжніх архівах; оголошення add_theme_support( 'woocommerce' ) у callback-функції after_setup_theme виправляє визначення, хоча шаблони товарів теми після цього, можливо, доведеться підлаштувати. Якщо сторінка є справжнім архівом, а категорія все одно не визначається, встановіть Додаткова перевірка сторінки категорії (Additional check of the category page) у значення Так (Yes) у розділі Advanced → Options. Блокові теми отримують цю перевірку автоматично. Щоб приховати терміни без товарів у поточній категорії, див. як показувати лише параметри фільтра поточної категорії.

Конфлікти маршрутизації: SEO URL і постійні посилання

Коли розширення SEO URL request увімкнено, фільтр стає частиною шляху, наприклад /shop/swoof/color-red/, замість рядка запиту. Деякі конструктори самі розпізнають URL і шаблони (відомий випадок — Bricks) і не розпізнають такий шлях, тому інтерфейс фільтра працює, а товари ніколи не змінюються, або сторінка повертається до нефільтрованого шаблону. Щоб перевірити, відкрийте Advanced → SEO URL request і встановіть Увімкнути/вимкнути (Enable/Disable) у значення Ні (No), очистьте всі кеші й відфільтруйте знову. Якщо прості посилання ?swoof=1&... працюють, причина в маршрутизації; тримайте SEO URL вимкненими на цьому сайті.

SEO URL також потребують гарних постійних посилань. Якщо в Settings → Permalinks вибрано Звичайні (Plain), виберіть будь-яку іншу структуру, збережіть і перевірте знову.

Типові ситуації з конструкторами

Що показує товариЩо робити
Сітка товарів конструктора, картки записів, повторювач або елемент query loop (Avada Post Cards, Oxygen Repeater, Bricks query loop, блок Query Loop з власним запитом)Виправлення 2, режим переадресації. Або замініть елемент на [woof_products].
Макет theme-builder, який замінює шаблон магазину чи категорії (макети Avada, YOOtheme, Flatsome, Beaver Themer, Breakdance)Працює в режимі переадресації, якщо макет використовує цикл WooCommerce. Режим AJAX — лише якщо макет викликає обидва гаки циклу магазину; інакше встановіть Спробувати зробити магазин AJAX-сумісним (Try to ajaxify the shop) у значення Ні (No).
Віджети товарів Elementor і сітки loop gridДив. як зробити сітки товарів Elementor придатними до фільтрації.
Написаний вручну WP_Query у PHP-шаблоніВиправлення 2 це покриває; для режиму AJAX додайте два гаки.
Інший плагін, що замінює запит товарів або шаблонДеактивуйте його для перевірки. Якщо фільтр після цього працює, цьому плагіну потрібно використовувати стандартний запит WooCommerce.

Якщо все одно не працює

  • Перевіряйте без авторизації у приватному вікні. Кеш сторінок, що ігнорує рядок запиту, віддає той самий нефільтрований HTML для кожного URL фільтра; виключіть із кешу сторінок URL, що містять swoof.
  • Після додавання сніпета відкрийте URL фільтра напряму. Якщо сітка все ще не відфільтрована, елемент, імовірно, не запитує тип запису product або завантажує товари пізніше власним AJAX-запитом без параметрів фільтра (так роблять деякі кнопки «завантажити ще»).
  • Якщо перша сторінка фільтрується правильно, а сторінка 2 показує 404 або нефільтровані товари, посилання пагінації сітки втрачають параметри фільтра. Перевірте, що посилання на сторінку 2 і далі містить swoof=1 та ваш вибір; більше причин описано в пагінація фільтра не працює.

Якщо тест із шорткодом із першого розділу працює, а ваш шаблон усе ще ні, створіть тему на форумі підтримки HUSKY з посиланням на сторінку, темою чи конструктором та елементом, який показує товари.