HUSKY - WooCommerce Product Filter Professional

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 со ссылкой на страницу магазина и описанием того, что меняется после фильтрации.