AJAX-фильтр WooCommerce ломает сетку товаров: причины и решения
Магазин выглядит правильно до первого клика по фильтру. Потом три столбца превращаются в четыре, в рядах появляются пустоты, карточки товаров теряют значки или кнопки темы, а боковая колонка съезжает под товары. Когда AJAX-фильтр WooCommerce ломает сетку товаров, сами товары остаются правильными; меняется HTML, который их выводит. Ниже описано, что именно заменяет режим AJAX в HUSKY, почему разметка, специфичная для темы, теряется по дороге, и приведено решение для каждого симптома.
Что заменяет режим AJAX и чего он не может скопировать
Когда Попытаться перевести магазин на AJAX (Try to ajaxify the shop) установлено в Да (Yes) (WooCommerce → Настройки → Products Filter → Опции), плагин размечает область товаров на страницах магазина и категорий. На хуке woocommerce_before_shop_loop (приоритет 2) он открывает контейнер <div class="woocommerce woocommerce-page woof_shortcode_output">, внутри которого находится <div id="woof_results_by_ajax">, а на woocommerce_after_shop_loop (приоритет 10) закрывает оба.
Когда посетитель меняет фильтр, скрипт отправляет запрос на /wp-admin/admin-ajax.php с действием woof_draw_products. Сервер выводит [woof_products is_ajax=1], и скрипт заменяет контейнер полученным результатом. Этот результат собирается только из стандартных частей WooCommerce:
- хук
woocommerce_before_shop_loop(уведомления, количество результатов, выпадающий список сортировки); woocommerce_product_loop_start(), который выводит<ul class="products columns-N">;- часть шаблона
content-product.phpдля каждого товара; woocommerce_product_loop_end()и хукwoocommerce_after_shop_loop(пагинация).
Отсюда следуют две вещи. Во-первых, всё, что шаблон архива вашей темы выводит между этими двумя хуками самостоятельно (дополнительные обёртки, класс сетки, оформление цикла конструктора страниц), в новый HTML не попадает. Во-вторых, новый HTML создаётся в запросе admin-ajax, а не на странице магазина. Код, который выполняется при загрузке страницы магазина, на действиях wp или template_redirect, внутри шаблона архива или только когда is_admin() возвращает false, для него не выполняется никогда. Скрипты темы, один раз оформившие сетку при загрузке страницы, тоже не запускаются заново.
Выясните, что изменилось: сравните разметку до и после
Откройте магазин в приватном окне, кликните правой кнопкой мыши по первому товару и выберите Просмотреть код (Inspect). Запишите классы у ul.products, у его родительских элементов и у первого li.product. Примените фильтр и осмотрите то же место ещё раз. Разница укажет на решение:
| Симптом после фильтрации | Причина | Раздел |
|---|---|---|
Другое число столбцов, columns-4 вместо columns-3 | Настройка столбцов темы не применяется в запросе AJAX | Столбцы и промежутки |
| Ряды по 3, затем 1, затем 3; пустоты в сетке | Классы first/last посчитаны для другого числа столбцов | Столбцы и промежутки |
| Боковая колонка или подвал смещаются, пропадают или повторяются; товары показаны дважды | Тема не вызывает оба хука цикла магазина вокруг цикла | Хуки цикла магазина |
Нет класса у ul.products, вернулись кнопки или значки, потерян вид «сетка/список», пустые изображения | Разметка темы, условия PHP или скрипты темы | Возможности карточек темы |
Число столбцов товаров меняется после фильтрации, появляются промежутки
[woof_products] берёт число столбцов из фильтра WooCommerce loop_shop_columns, который в крайнем случае возвращается к значению Товаров в строке (Products per row) в разделе Внешний вид → Настроить → WooCommerce → Каталог товаров. Темы с собственной опцией столбцов часто применяют её только во время загрузки страницы магазина. В запросе AJAX этот код не выполняется, поэтому результаты приходят со значением WooCommerce: часто это 4 там, где магазин показывает 3.
У промежутков тот же корень. WooCommerce присваивает первому товару каждого ряда класс first, а последнему — last, считая от этого числа столбцов, а классическая float-сетка начинает новый ряд на каждом first. Если CSS темы рассчитан на 3 товара в ряду, а HTML из AJAX считает 4, то каждый четвёртый товар переносится на новый ряд: 3 товара, потом 1 один, потом снова 3.
Задайте число столбцов один раз, для всех запросов, равным тому, которое ваш магазин показывает на десктопе:
/**
* Same number of columns on shop pages and in HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'loop_shop_columns', function () {
return 3; // products per row on desktop
}, 999 );
Не оборачивайте его в is_shop() или подобные проверки, иначе он будет пропущен в запросе AJAX. Приоритет 999 делает так, что он перекрывает собственный фильтр темы. Краткий FAQ принудительно задать число столбцов в отфильтрованных результатах использует тот же фильтр. На произвольной странице [woof_products columns=3] задаёт число напрямую. Телефоны и планшеты в обоих случаях оформляются медиазапросами CSS темы.
Если после фильтрации класс равен columns-3, а ширина по-прежнему неверная, значит, тема задаёт размеры товаров через класс на собственной обёртке вне заменяемой области. Добавьте CSS для контейнера AJAX в разделе Внешний вид → Настроить → Дополнительный CSS или в поле плагина Пользовательский CSS-код (Custom CSS code) (Дополнительно → Код):
/* HUSKY AJAX results: 3 products per row in a float-based grid */
#woof_results_by_ajax ul.products li.product {
width: 30.75%;
margin-right: 3.8%;
clear: none;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n) {
margin-right: 0;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n+1) {
clear: both;
}
Если ваша тема размещает ul.products через CSS grid, а не float, достаточно одного правила: #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Заключите любой из вариантов в медиазапрос для десктопа, если на телефонах тема использует меньше столбцов.
Боковая колонка под товарами, сломанный подвал, двойные результаты: хуки цикла магазина
Режиму AJAX нужно, чтобы тема вызывала woocommerce_before_shop_loop непосредственно перед списком товаров, а woocommerce_after_shop_loop — непосредственно после него, как это делает стандартный шаблон WooCommerce. Если это не так:
- Закрывающий хук отсутствует. Оба контейнера так и не закрываются, и браузер закрывает их только в конце родительского элемента. Боковая колонка, вторая колонка или подвал оказываются внутри области товаров: часто боковая колонка стоит под товарами уже при загрузке страницы, а после первого клика по фильтру всё внутри контейнера, включая боковую колонку с фильтром, заменяется результатами.
- Хуки вызываются в другом месте. Если тема вызывает их в панели инструментов, а цикл товаров выводит после
woocommerce_after_shop_loop, результаты AJAX попадают в контейнер, а исходная сетка остаётся под ним, поэтому товары отображаются дважды. - Обёртки темы пересекают контейнеры. Элемент, который тема открывает на
woocommerce_before_shop_loopи закрывает наwoocommerce_after_shop_loop, должен находиться целиком внутри контейнеров HUSKY (открыт после приоритета 2, закрыт до приоритета 10) или целиком снаружи. Всё, что находится между ними, перекрывает их и ломает вложенность.
Для проверки откройте исходный код страницы (Ctrl+U), найдите woof_results_by_ajax и проследите HTML вниз: после закрывающего </ul> товаров и пагинации должны идти два </div>, и только затем начинаться боковая колонка или подвал. В папке темы поищите в шаблонах архива woocommerce_after_shop_loop. Товарная часть шаблона, который работает с режимом AJAX, выглядит как собственный archive-product.php WooCommerce:
<?php
if ( woocommerce_product_loop() ) {
do_action( 'woocommerce_before_shop_loop' );
woocommerce_product_loop_start();
if ( wc_get_loop_prop( 'total' ) ) {
while ( have_posts() ) {
the_post();
do_action( 'woocommerce_shop_loop' );
wc_get_template_part( 'content', 'product' );
}
}
woocommerce_product_loop_end();
do_action( 'woocommerce_after_shop_loop' );
} else {
do_action( 'woocommerce_no_products_found' );
}
Внесите изменение в копию шаблона в дочерней теме или попросите автора темы добавить недостающий хук. Макеты конструкторов страниц редко вызывают оба хука; для них реалистичный выбор — режим перенаправления, описанный ниже. Товары, которые не меняются вообще, разобраны в статье URL фильтра меняется, а товары нет, а шаблоны Elementor — в статье Elementor Loop Grid и шаблоны архивов не фильтруются.
Потеряны возможности карточки темы: значки, кнопки, классы сетки, скрипты
Изменения, которые ваш PHP вносит только на страницах магазина
Код, который скрывает кнопки добавления в корзину, добавляет строку категории или значок и решает это на wp или template_redirect с помощью is_shop(), в запросе AJAX не выполняется, поэтому после фильтрации возвращается стандартная карточка. Запускайте его и для запроса HUSKY. admin_init срабатывает в каждом запросе admin-ajax:
/**
* Card changes for shop pages AND for HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
function my_shop_card_changes() {
// Example: no add-to-cart buttons in the product grid
remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 );
}
// Normal page loads of the shop and product archives
add_action( 'wp', function () {
if ( is_shop() || is_product_taxonomy() ) {
my_shop_card_changes();
}
} );
// HUSKY AJAX filtering, sent through admin-ajax.php
add_action( 'admin_init', function () {
if ( wp_doing_ajax() && isset( $_REQUEST['action'] ) && 'woof_draw_products' === $_REQUEST['action'] ) {
my_shop_card_changes();
}
} );
Опции темы, меняющие карточку (строка категории, изображение при наведении, кнопка быстрого просмотра), часто применяются внутри темы тем же способом. Если они пропадают после фильтрации, а у темы нет хука, который охватывал бы и запросы AJAX, используйте режим перенаправления.
Классы, которые тема добавляет к списку товаров
Если сравнение показывает, что у ul.products есть класс, присутствующий при загрузке страницы и пропадающий после фильтрации, добавьте его в ответ AJAX фильтром woof_draw_products_html. Он получает HTML, который вот-вот будет отправлен в браузер:
/**
* Add the theme's grid class to the product list in HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
return str_replace(
'<ul class="products columns-',
'<ul class="products my-theme-grid columns-', // use the class from your page
$html
);
}, 10, 2 );
Строка поиска соответствует собственному loop/loop-start.php WooCommerce; если ваша тема переопределяет этот файл, скопируйте открывающий тег из исходного кода страницы. Если тема выводит карточки частью шаблона, отличной от content-product.php, верните её название фильтром woof_template_part: значение product-grid загружает content-product-grid.php из папки woocommerce вашей темы.
Скрипты темы: отложенная загрузка изображений, одинаковая высота, masonry, быстрый просмотр
Скрипты, которые выполняются один раз при загрузке страницы (отложенная загрузка изображений, карточки одинаковой высоты, masonry, переключатели «сетка/список», кнопки быстрого просмотра), новых товаров не видят. HUSKY вызывает событие jQuery woof_ajax_done после каждой замены; поместите туда вызов инициализации темы — в JS-файл темы или в поле JavaScript-код после завершения AJAX (JavaScript code after AJAX is done) (Дополнительно → Код). Название функции подскажет автор темы; подробнее о событии в статье woof_ajax_done.
jQuery(document).on('woof_ajax_done', function () {
// Many layout scripts recalculate on resize
jQuery(window).trigger('resize');
// Call your theme's own init function here if it has one
});
Количество результатов или сортировка показаны дважды
Тема, которая выводит собственную панель количества и сортировки вне области товаров, всё равно может получить стандартные копии WooCommerce внутри результатов AJAX. Скройте внутренние копии, только если они действительно дублируются:
#woof_results_by_ajax .woocommerce-result-count,
#woof_results_by_ajax .woocommerce-ordering {
display: none;
}
Если собственный счётчик темы вне этой области не обновляется после фильтрации, укажите его CSS-селектор в поле CSS-селектор счётчика результатов (Result count css selector) (Дополнительно → Опции): тогда плагин отправляет свежий счётчик с каждым ответом AJAX и заменяет найденный элемент.
Когда отказаться от AJAX: режим перенаправления и Turbo Mode
Некоторые макеты нельзя восстановить из стандартных частей WooCommerce: оформления цикла конструктора страниц, карусели, шаблоны темы без хуков. Установите Попытаться перевести магазин на AJAX (Try to ajaxify the shop) в Нет (No). Тогда каждое изменение фильтра загружает отфильтрованный URL, а ваша тема отрисовывает всю страницу как обычно, поэтому сетка совпадает с неотфильтрованным магазином. Теряется обновление на месте. Чтобы страница перезагружалась один раз на поиск, а не после каждого клика, установите Автоотправка (Autosubmit) в Нет (No), чтобы фильтр ждал свою кнопку, а как вернуть посетителя к результатам, см. в статье автопрокрутка к товарам в режиме перенаправления.
Если Попытаться перевести магазин на AJAX (Try to ajaxify the shop) снова возвращается в Да (Yes), значит, включён Turbo Mode: он включает режим AJAX при каждой загрузке страницы. Сначала установите Включить Turbo Mode (Enable turbo mode) в Нет (No) на его вкладке, затем отключите AJAX и очистите кэш страниц, чтобы посетители получили новую настройку.
Контрольный список
- Разметка сравнена до и после фильтрации в инспекторе браузера.
loop_shop_columnsвозвращает число столбцов магазина без условий страницы.- В исходном коде страницы два контейнера HUSKY закрываются сразу после товаров и пагинации.
- Изменения карточки в PHP выполняются и для запроса
woof_draw_products; скрипты темы перезапускаются наwoof_ajax_done. - Если макет всё равно отличается: Попытаться перевести магазин на AJAX (Try to ajaxify the shop) = Нет (No), Turbo Mode отключён, кэши очищены.
Если макет ломается и со стандартной темой вроде Storefront при единственном активном HUSKY, создайте тему на форуме поддержки HUSKY со ссылкой на страницу магазина и описанием того, что меняется после фильтрации.