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

Деякі макети неможливо відтворити зі стандартних частин WooCommerce: скіни циклу конструкторів, каруселі, шаблони теми без хуків. Установіть для Спробувати перевести магазин на AJAX (Try to ajaxify the shop) значення Ні (No). Тоді кожна зміна фільтра завантажує відфільтрований URL, а ваша тема рендерить усю сторінку як зазвичай, тож сітка ідентична сітці нефільтрованого магазину. Ви втрачаєте оновлення на місці. Щоб перезавантажувати сторінку один раз на пошук, а не після кожного кліку, установіть для Автовідправлення (Autosubmit) значення Ні (No), щоб фільтр чекав на свою кнопку, а як спрямувати відвідувача до результатів, див. автопрокручування до товарів у режимі перенаправлення.

Якщо Спробувати перевести магазин на AJAX (Try to ajaxify the shop) знову стрибає на Так (Yes), увімкнено режим Turbo: він вмикає AJAX-режим при кожному завантаженні сторінки. Спершу в його вкладці установіть для Увімкнути режим Turbo (Enable turbo mode) значення Ні (No), потім вимкніть AJAX і очистьте кеш сторінок, щоб відвідувачі отримали нове налаштування.

Контрольний список

  • Розмітку порівняно до і після фільтрації в інспекторі браузера.
  • loop_shop_columns повертає кількість колонок магазину без умов щодо сторінки.
  • Код сторінки показує, що два контейнери HUSKY закриваються одразу після товарів і пагінації.
  • Зміни картки в PHP виконуються також для запиту woof_draw_products; скрипти теми перезапускаються на woof_ajax_done.
  • Якщо макет усе ще відрізняється: Спробувати перевести магазин на AJAX (Try to ajaxify the shop) = Ні (No), із вимкненим режимом Turbo та очищеними кешами.

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