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 з посиланням на сторінку магазину та описом того, що змінюється після фільтрації.