HUSKY - WooCommerce Product Filter Professional

Filtr AJAX WooCommerce psuje układ siatki produktów: przyczyny i rozwiązania

Sklep wygląda poprawnie do pierwszego kliknięcia w filtr. Potem trzy kolumny zmieniają się w cztery, w wierszach pojawiają się dziury, karty produktów tracą plakietki lub przyciski motywu, a pasek boczny wsuwa się pod produkty. Gdy filtr AJAX WooCommerce psuje układ siatki produktów, same produkty są poprawne; zmienił się kod HTML, który je rysuje. Poniżej opisujemy, co zastępuje tryb AJAX HUSKY, dlaczego po drodze ginie kod specyficzny dla motywu, oraz rozwiązanie dla każdego objawu.

Co zastępuje tryb AJAX i czego nie potrafi skopiować

Gdy Próbuj zajaxować sklep (Try to ajaxify the shop) ma wartość Tak (Yes) (WooCommerce → Ustawienia → Products Filter → Opcje (Options)), wtyczka wyznacza obszar produktów na stronach sklepu i kategorii. Na haku woocommerce_before_shop_loop (priorytet 2) otwiera kontener <div class="woocommerce woocommerce-page woof_shortcode_output"> z <div id="woof_results_by_ajax"> wewnątrz, a na woocommerce_after_shop_loop (priorytet 10) zamyka oba.

Gdy odwiedzający zmienia filtr, skrypt wysyła żądanie do /wp-admin/admin-ajax.php z akcją woof_draw_products. Serwer renderuje [woof_products is_ajax=1], a skrypt podmienia kontener na wynik. Ten wynik jest zbudowany wyłącznie ze standardowych części WooCommerce:

  • hak woocommerce_before_shop_loop (komunikaty, licznik wyników, lista rozwijana sortowania);
  • woocommerce_product_loop_start(), który wypisuje <ul class="products columns-N">;
  • część szablonu content-product.php dla każdego produktu;
  • woocommerce_product_loop_end() i hak woocommerce_after_shop_loop (paginacja).

Wynikają z tego dwie rzeczy. Po pierwsze, wszystko, co szablon archiwum twojego motywu sam wypisuje między tymi dwoma hakami (dodatkowe opakowania, klasa siatki, skórka pętli kreatora), nie trafia do nowego HTML-a. Po drugie, nowy HTML powstaje w żądaniu admin-ajax, a nie na stronie sklepu. Kod, który działa podczas ładowania strony sklepu, na akcji wp lub template_redirect, wewnątrz szablonu archiwum albo tylko wtedy, gdy is_admin() jest fałszem, nigdy się dla niego nie wykonuje. Skrypty motywu, które ostylowały siatkę raz przy ładowaniu strony, też nie uruchamiają się ponownie.

Sprawdź, co się zmieniło: porównaj kod przed i po

Otwórz sklep w oknie prywatnym, kliknij prawym przyciskiem pierwszy produkt i wybierz Zbadaj (Inspect). Zanotuj klasy na ul.products, na jego elementach nadrzędnych i na pierwszym li.product. Zastosuj filtr i sprawdź to samo miejsce ponownie. Różnica wskazuje rozwiązanie:

Objaw po filtrowaniuPrzyczynaSekcja
Inna liczba kolumn, columns-4 zamiast columns-3Ustawienie kolumn motywu nie jest stosowane w żądaniu AJAXKolumny i luki
Wiersze po 3, potem 1, potem 3; dziury w siatceKlasy wiersza first/last są liczone dla innej liczby kolumnKolumny i luki
Pasek boczny lub stopka przesuwa się, znika albo się powtarza; produkty widoczne dwa razyMotyw nie wywołuje obu haków pętli sklepu wokół pętliHaki pętli sklepu
Brak klasy na ul.products, wróciły przyciski lub plakietki, utracony widok siatki/listy, puste obrazyKod motywu, warunki PHP lub skrypty motywuFunkcje kart motywu

Kolumny produktów zmieniają się po filtrowaniu i pojawiają się luki

[woof_products] bierze liczbę kolumn z filtra WooCommerce loop_shop_columns, który w razie braku wartości sięga po Produktów w wierszu (Products per row) w Wygląd → Dostosuj → WooCommerce → Katalog produktów. Motywy z własną opcją kolumn często stosują ją tylko podczas ładowania strony sklepu. W żądaniu AJAX ten kod się nie wykonuje, więc wyniki wracają z wartością WooCommerce: często 4 tam, gdzie sklep pokazuje 3.

Luki mają tę samą przyczynę. WooCommerce nadaje pierwszemu produktowi każdego wiersza klasę first, a ostatniemu last, licząc od tej liczby kolumn, a klasyczna siatka oparta na float zaczyna nowy wiersz przy każdym first. Jeśli CSS motywu mieści 3 produkty w wierszu, a HTML z AJAX liczy 4, każdy czwarty produkt wymusza nowy wiersz: 3 produkty, potem 1 sam, potem znów 3.

Ustaw liczbę kolumn raz, dla każdego żądania, na liczbę, którą sklep pokazuje na komputerze:

/**
 * 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 );

Nie owijaj tego w is_shop() ani podobne warunki, bo zostanie pominięte w żądaniu AJAX. Priorytet 999 sprawia, że wygrywa z własnym filtrem motywu. Krótkie FAQ wymuszenie określonej liczby kolumn w przefiltrowanych wynikach używa tego samego filtra. Na stronie niestandardowej [woof_products columns=3] ustawia liczbę bezpośrednio. Telefony i tablety są w obu przypadkach stylowane przez zapytania medialne CSS motywu.

Jeśli po filtrowaniu klasa to columns-3, a szerokości nadal są złe, motyw ustala rozmiar produktów przez klasę na własnym opakowaniu poza podmienianym obszarem. Dodaj CSS dla kontenera AJAX w Wygląd → Dostosuj → Dodatkowy CSS albo w polu wtyczki Własny kod CSS (Custom CSS code) (Zaawansowane (Advanced) → Kod (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;
}

Jeśli twój motyw układa ul.products za pomocą siatki CSS zamiast float, wystarczy jedna reguła: #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Opakuj którąkolwiek wersję w zapytanie medialne dla komputerów, jeśli motyw na telefonach używa mniejszej liczby kolumn.

Pasek boczny pod produktami, zepsuta stopka, podwójne wyniki: haki pętli sklepu

Tryb AJAX wymaga, by motyw wywoływał woocommerce_before_shop_loop bezpośrednio przed listą produktów, a woocommerce_after_shop_loop bezpośrednio po niej, tak jak robi to standardowy szablon WooCommerce. Gdy tego nie robi:

  • Brakuje haka zamykającego. Oba kontenery nigdy nie są zamykane, a przeglądarka zamyka je dopiero na końcu ich elementu nadrzędnego. Pasek boczny, druga kolumna lub stopka lądują wewnątrz obszaru produktów: często pasek boczny jest pod produktami już przy ładowaniu strony, a po pierwszym kliknięciu w filtr wszystko wewnątrz kontenera, razem z paskiem bocznym z filtrem, jest zastępowane wynikami.
  • Haki są wywoływane gdzie indziej. Jeśli motyw wywołuje je na pasku narzędzi, a pętlę produktów wypisuje po woocommerce_after_shop_loop, wyniki AJAX trafiają do kontenera, podczas gdy oryginalna siatka pozostaje pod nim, więc produkty pojawiają się dwa razy.
  • Opakowania motywu przecinają kontenery. Element, który motyw otwiera na woocommerce_before_shop_loop i zamyka na woocommerce_after_shop_loop, musi leżeć w całości wewnątrz kontenerów HUSKY (otwieranych po priorytecie 2, zamykanych przed priorytetem 10) albo w całości poza nimi. Wszystko pomiędzy nakłada się na nie i psuje zagnieżdżenie.

Aby to sprawdzić, otwórz źródło strony (Ctrl+U), wyszukaj woof_results_by_ajax i śledź kod HTML w dół: po zamykającym </ul> produktów i paginacji muszą być dwa </div>, zanim zacznie się pasek boczny lub stopka. W folderze motywu wyszukaj woocommerce_after_shop_loop w szablonach archiwum. Część produktowa szablonu, który działa z trybem AJAX, wygląda jak własny 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' );
}

Wprowadź zmianę w kopii szablonu w motywie potomnym albo poproś autora motywu o dodanie brakującego haka. Układy kreatorów stron rzadko wywołują oba haki; dla nich realistycznym wyborem jest tryb przekierowania, opisany niżej. Produkty, które w ogóle się nie zmieniają, opisuje artykuł adres URL filtra się zmienia, ale produkty nie, a szablony Elementora artykuł Elementor Loop Grid i szablony archiwum nie filtrują.

Utracone funkcje kart motywu: plakietki, przyciski, klasy siatki, skrypty

Zmiany, które twój PHP wprowadza tylko na stronach sklepu

Kod, który ukrywa przyciski dodawania do koszyka, dodaje wiersz kategorii lub plakietkę i decyduje o tym na akcji wp albo template_redirect za pomocą is_shop(), nie wykonuje się w żądaniu AJAX, więc po filtrowaniu wraca domyślna karta. Uruchom go także dla żądania HUSKY. admin_init odpala się w każdym żądaniu 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();
    }
} );

Opcje motywu zmieniające kartę (wiersz kategorii, obraz po najechaniu, przycisk szybkiego podglądu) są często stosowane w ten sam sposób wewnątrz motywu. Jeśli po filtrowaniu znikają, a motyw nie ma haka obejmującego także żądania AJAX, użyj trybu przekierowania.

Klasy, które motyw dodaje do listy produktów

Jeśli porównanie pokazuje klasę na ul.products, która istnieje przy ładowaniu strony, a po filtrowaniu jej brakuje, dodaj ją do odpowiedzi AJAX za pomocą filtra woof_draw_products_html. Otrzymuje on kod HTML, który ma zostać wysłany do przeglądarki:

/**
 * 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 );

Szukany ciąg odpowiada własnemu loop/loop-start.php WooCommerce; jeśli twój motyw nadpisuje ten plik, skopiuj znacznik otwierający ze źródła strony. Gdy motyw renderuje karty częścią szablonu inną niż content-product.php, zwróć jej nazwę filtrem woof_template_part: wartość product-grid ładuje content-product-grid.php z folderu woocommerce twojego motywu.

Skrypty motywu: leniwe obrazy, równe wysokości, masonry, szybki podgląd

Skrypty uruchamiane raz przy ładowaniu strony (obrazy ładowane leniwie, karty o równej wysokości, masonry, przełączniki siatka/lista, przyciski szybkiego podglądu) nie widzą nowych produktów. HUSKY wyzwala zdarzenie jQuery woof_ajax_done po każdej podmianie; umieść tam wywołanie inicjalizacji motywu, w pliku JS motywu lub w Kod JavaScript po zakończeniu AJAX (JavaScript code after AJAX is done) (Zaawansowane (Advanced) → Kod (Code)). Nazwę funkcji może podać autor motywu; więcej o zdarzeniu w 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
});

Licznik wyników lub sortowanie pokazane dwa razy

Motyw, który wypisuje własny pasek licznika i sortowania poza obszarem produktów, może nadal dostać domyślne kopie WooCommerce wewnątrz wyników AJAX. Ukryj wewnętrzne kopie, tylko jeśli naprawdę są duplikatami:

#woof_results_by_ajax .woocommerce-result-count,
#woof_results_by_ajax .woocommerce-ordering {
    display: none;
}

Jeśli własny licznik motywu poza tym obszarem nie aktualizuje się po filtrowaniu, wpisz jego selektor CSS w Selektor CSS licznika wyników (Result count css selector) (Zaawansowane (Advanced) → Opcje (Options)): wtyczka będzie wtedy wysyłać świeży licznik z każdą odpowiedzią AJAX i zastępować znaleziony element.

Kiedy zrezygnować z AJAX: tryb przekierowania i tryb turbo

Niektórych układów nie da się odbudować ze standardowych części WooCommerce: skórek pętli kreatorów, karuzel, szablonów motywu bez haków. Ustaw Próbuj zajaxować sklep (Try to ajaxify the shop) na Nie (No). Każda zmiana filtra ładuje wtedy przefiltrowany adres URL, a twój motyw renderuje całą stronę jak zwykle, więc siatka jest identyczna jak w niefiltrowanym sklepie. Tracisz aktualizację w miejscu. Aby przeładować stronę raz na wyszukiwanie zamiast po każdym kliknięciu, ustaw Autowysyłanie (Autosubmit) na Nie (No), tak by filtr czekał na swój przycisk, a w artykule automatyczne przewijanie do produktów w trybie przekierowania dowiesz się, jak przenieść odwiedzającego do wyników.

Jeśli Próbuj zajaxować sklep (Try to ajaxify the shop) wraca na Tak (Yes), włączony jest tryb turbo: włącza tryb AJAX przy każdym ładowaniu strony. Najpierw ustaw Włącz tryb turbo (Enable turbo mode) na Nie (No) w jego karcie, potem wyłącz AJAX i wyczyść pamięć podręczną stron, aby odwiedzający dostali nowe ustawienie.

Lista kontrolna

  • Kod porównany przed i po filtrowaniu w inspektorze przeglądarki.
  • loop_shop_columns zwraca liczbę kolumn sklepu bez warunków strony.
  • Źródło strony pokazuje oba kontenery HUSKY zamykane zaraz po produktach i paginacji.
  • Zmiany kart w PHP wykonują się także dla żądania woof_draw_products; skrypty motywu uruchamiają się ponownie na woof_ajax_done.
  • Jeśli układ nadal się różni: Próbuj zajaxować sklep (Try to ajaxify the shop) = Nie (No), przy wyłączonym trybie turbo i wyczyszczonej pamięci podręcznej.

Jeśli układ nadal się psuje przy domyślnym motywie, takim jak Storefront, i aktywnym wyłącznie HUSKY, otwórz wątek na forum wsparcia HUSKY, podając link do strony sklepu i opis tego, co zmienia się po filtrowaniu.