URL фильтра WooCommerce меняется, а товары нет: как исправить
Вы отмечаете цвет или категорию, появляется индикатор загрузки, адресная строка меняется на что-то вроде /shop/?swoof=1&pa_color=red, а сетка товаров показывает всё те же товары. Когда URL фильтра WooCommerce меняется, а товары не меняются, фильтр свою работу сделал: он составил поисковый запрос. Просто шаблон, который выводит товары, его не прочитал. В этом руководстве показано, как подтвердить это за две минуты и как заставить тему, конструктор страниц или собственный шаблон реагировать на фильтр.
Почему URL фильтра WooCommerce меняется, а товары не меняются
HUSKY не рисует сетку товаров вашего магазина. Он добавляет свои условия (таксономии, цену, мета-поля, текст) к запросам товаров, которые WooCommerce уже выполняет, и только к ним:
- основной запрос страницы магазина и архивов категорий, меток и атрибутов товаров (шаг WooCommerce
woocommerce_product_query); - собственный шорткод плагина
[woof_products]; - товарные шорткоды WooCommerce, такие как
[products], черезwoocommerce_shortcode_products_query.
Список товаров, который строит собственный WP_Query, в этот путь не попадает. Товарные сетки конструкторов страниц, карточки записей и повторители, элементы «query loop», шаблоны архивов темы с собственным запросом и самодельные циклы в PHP-шаблоне запрашивают товары из базы данных по-своему, поэтому показывают весь каталог, что бы ни говорил фильтр. В фильтре ничего не сломано: список просто его не слушает.
Два связанных симптома имеют ту же причину. На обычной странице, где скрипт фильтра не находит список товаров WooCommerce, посетитель перенаправляется на страницу магазина, чтобы увидеть результаты. А на «странице категории», которая на самом деле является страницей WordPress, собранной в конструкторе, фильтр не знает текущую категорию, поэтому предлагает все термины и ищет по всему каталогу.
Подтвердите причину за две минуты
- Прочитайте URL после фильтрации. Если в нём есть
swoof=1и ваш выбор (/swoof/и далее выбранные значения при включённых SEO-URL или толькоmin_priceиmax_price, если выбрана одна лишь цена), фильтр сработал. Если URL не меняется совсем, фильтр так и не отправил запрос: сначала поищите ошибку JavaScript в консоли браузера. - Попробуйте тот же запрос на стандартной странице магазина. Скопируйте всё начиная с
?swoof=1и добавьте к URL вашей страницы магазина WooCommerce. Если там товары отфильтрованы, а на вашей странице нет, причина прямо в списке товаров вашей страницы. - Проверьте с обычным шорткодом. На черновике страницы поместите
[woof], а под ним[woof_products per_page=12]или шорткод WooCommerce[products limit="12"]. Если они фильтруют правильно, используйте для своей настоящей страницы одно из решений ниже. - Выясните, что это за страница. Посмотрите на экран редактирования: Страница (Page) WordPress с товарной сеткой не является архивом товаров, даже если её URL выглядит как
/category/shoes/.
Решение 1: выводите товары через [woof_products]
Самое надёжное решение — поручить вывод товаров плагину. Замените товарный элемент конструктора виджетом или блоком «Шорткод» с [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 → Настройки → 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, оформленной под категорию, такого объекта нет, поэтому фильтр работает со всем каталогом. Используйте настоящий архив категории и оформите его шаблоном архива вашего конструктора или темы, либо передайте taxonomies=product_cat:ID обоим шорткодам, как показано в решении 1. Пользовательская тема, созданная без поддержки WooCommerce, может давать тот же эффект и на настоящих архивах; объявление add_theme_support( 'woocommerce' ) в функции обратного вызова after_setup_theme исправляет определение, хотя затем шаблоны товаров темы, возможно, придётся доработать. Если страница является настоящим архивом, а категория всё равно не определяется, выберите Да (Yes) для Дополнительная проверка страницы категории (Additional check of the category page) в Продвинутые → Опции (Advanced → Options). В блочных темах эта проверка включается автоматически. Чтобы скрыть термины, в которых нет товаров текущей категории, читайте как показывать только варианты фильтра текущей категории.
Конфликты маршрутизации: SEO-URL и постоянные ссылки
При включённом расширении SEO URL request фильтр становится частью пути, например /shop/swoof/color-red/, вместо строки запроса. Некоторые конструкторы сами разбирают URL и шаблоны (известный случай — Bricks) и не распознают такой путь, поэтому интерфейс фильтра работает, а товары не меняются, либо страница переключается на нефильтруемый шаблон. Для проверки откройте Продвинутые → SEO URL request (Advanced → SEO URL request), выберите Нет (No) для Включить/выключить (Enable/Disable), очистите все кэши и отфильтруйте снова. Если обычные ссылки ?swoof=1&... работают, причина в маршрутизации; держите SEO-URL на этом сайте выключенными.
Для SEO-URL нужны ещё и «красивые» постоянные ссылки. Если в Настройки → Постоянные ссылки (Settings → Permalinks) выбрано Простые (Plain), выберите любую другую структуру, сохраните и проверьте снова.
Типичные ситуации с конструкторами
| Что показывает товары | Что делать |
|---|---|
| Товарная сетка конструктора, карточки записей, повторитель или элемент query loop (Avada Post Cards, Oxygen Repeater, Bricks query loop, блок Query Loop с собственным запросом) | Решение 2, режим перенаправления. Или замените элемент на [woof_products]. |
| Макет из конструктора тем, заменяющий шаблон магазина или категории (макеты Avada, YOOtheme, Flatsome, Beaver Themer, Breakdance) | Работает в режиме перенаправления, если макет использует цикл WooCommerce. Режим AJAX — только если макет вызывает оба хука цикла магазина; иначе выберите Нет (No) для Пытаться использовать AJAX в магазине (Try to ajaxify the shop). |
| Товарные виджеты и сетки Loop Grid в Elementor | См. как сделать товарные сетки Elementor фильтруемыми. |
Самодельный WP_Query в PHP-шаблоне | Решение 2 это охватывает; для режима AJAX добавьте два хука. |
| Другой плагин, заменяющий запрос или шаблон товаров | Отключите его на время теста. Если после этого фильтр заработал, этому плагину нужно использовать стандартный запрос WooCommerce. |
Если всё равно не работает
- Проверьте без авторизации в приватном окне. Кэш страниц, который игнорирует строку запроса, отдаёт один и тот же нефильтрованный HTML для всех URL фильтра; исключите из кэша страниц URL, содержащие
swoof. - После добавления сниппета откройте URL фильтра напрямую. Если сетка по-прежнему не отфильтрована, вероятно, элемент не запрашивает тип записи
productили подгружает свои товары позже собственным AJAX-запросом без параметров фильтра (так делают некоторые кнопки «загрузить ещё»). - Если первая страница фильтруется правильно, а вторая выдаёт 404 или нефильтрованные товары, ссылки пагинации сетки теряют параметры фильтра. Убедитесь, что ссылка на страницу 2 по-прежнему содержит
swoof=1и ваш выбор; другие причины описаны в статье пагинация фильтра не работает.
Если проверка шорткодом из первого раздела работает, а ваш шаблон по-прежнему нет, создайте тему на форуме поддержки HUSKY со ссылкой на страницу, названием темы или конструктора и элементом, который показывает товары.