HUSKY - WooCommerce Product Filter Professional

Adres URL filtra WooCommerce się zmienia, ale produkty nie: naprawa

Zaznaczasz kolor lub kategorię, pojawia się loader, pasek adresu zmienia się na coś w rodzaju /shop/?swoof=1&pa_color=red, a siatka produktów nadal pokazuje te same produkty. Gdy adres URL filtra WooCommerce się zmienia, ale produkty się nie zmieniają, filtr wykonał swoje zadanie: zbudował żądanie wyszukiwania. Szablon, który wypisuje produkty, nigdy go nie odczytał. Ten poradnik pokazuje, jak potwierdzić to w dwie minuty i jak sprawić, by motyw, kreator stron lub własny szablon reagował na filtr.

Dlaczego adres URL filtra się zmienia, a produkty nie

HUSKY nie rysuje siatki produktów Twojego sklepu. Dodaje swoje warunki (taksonomie, cenę, pola meta, tekst) do zapytań o produkty, które WooCommerce już wykonuje, i tylko do nich:

  • głównego zapytania strony sklepu oraz archiwów kategorii, tagów i atrybutów produktów (krok woocommerce_product_query w WooCommerce);
  • własnego shortcode'u wtyczki [woof_products];
  • shortcode'ów produktów WooCommerce, takich jak [products], przez woocommerce_shortcode_products_query.

Lista produktów, która buduje własne WP_Query, leży poza tą ścieżką. Siatki produktów kreatorów stron, karty wpisów i repeatery, elementy „query loop”, układy archiwów motywu z własnym zapytaniem oraz ręcznie napisane pętle w szablonie PHP pytają bazę danych o produkty po swojemu, więc wciąż pokazują cały katalog, cokolwiek powie filtr. W filtrze nic się nie zepsuło; lista po prostu go nie słucha.

Dwa pokrewne objawy mają tę samą przyczynę. Na zwykłej stronie, na której skrypt filtra nie znajduje żadnej listy produktów WooCommerce, odsyła on odwiedzającego na stronę sklepu, aby pokazać wyniki. A na „stronie kategorii”, która jest w rzeczywistości stroną WordPressa zrobioną kreatorem, filtr nie zna bieżącej kategorii, więc oferuje wszystkie określenia i przeszukuje cały katalog.

Potwierdź przyczynę w dwie minuty

  1. Odczytaj adres URL po filtrowaniu. Jeśli zawiera swoof=1 i Twoje wybory (/swoof/, a po nim wybory, gdy adresy SEO są włączone, albo tylko min_price i max_price, gdy jedynym wyborem jest cena), filtr zadziałał. Jeśli adres w ogóle się nie zmienia, filtr nigdy nie wysłał żądania: najpierw poszukaj błędu JavaScript w konsoli przeglądarki.
  2. Wypróbuj to samo żądanie na standardowej stronie sklepu. Skopiuj wszystko od ?swoof=1 w prawo i dołącz do adresu URL strony sklepu WooCommerce. Przefiltrowane produkty tam i nieprzefiltrowane na Twojej stronie wskazują wprost na listę produktów Twojej strony.
  3. Przetestuj ze zwykłym shortcode'em. Na szkicu strony umieść [woof], a pod nim [woof_products per_page=12] lub shortcode WooCommerce [products limit="12"]. Jeśli te działają poprawnie, zastosuj jedną z poniższych poprawek na swojej właściwej stronie.
  4. Sprawdź, jakiego rodzaju jest ta strona. Spójrz na ekran edycji: Strona (Page) WordPressa z siatką produktów nie jest archiwum produktów, nawet jeśli jej adres wygląda jak /category/shoes/.

Poprawka 1: pokaż produkty przez [woof_products]

Najpewniejsza poprawka to pozwolić wtyczce wypisać produkty. Zastąp element produktów kreatora widżetem lub blokiem Shortcode zawierającym [woof_products]:

[woof_products per_page=12 columns=4 is_ajax=1]

Shortcode reaguje na filtr na każdej stronie, obsługuje tryb AJAX przez is_ajax=1 i renderuje każdy produkt standardową kartą produktu WooCommerce z Twojego motywu (część szablonu content-product.php), więc wygląda jak sklep. Aby użyć innej części szablonu, zmień ją filtrem woof_template_part.

Dla strony, która ma wyświetlać tylko jedną kategorię, przekaż ten sam warunek obu shortcode'om, w przeciwnym razie filtr zaoferuje określenia z całego katalogu:

[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]

Zastąp 25 identyfikatorem kategorii (widocznym w adresie URL podczas edycji kategorii). Własny shortcode WooCommerce [products] też jest filtrowany, ale tylko z przeładowaniem strony. Jeśli potrzebujesz go w trybie AJAX, zapisz go jako [products_woof limit="12" columns="4"]: wtyczka opakowuje go tak, aby wyniki można było podmienić bez przeładowania.

Poprawka 2: spraw, by siatka kreatora lub własne WP_Query słuchały filtra

Gdy chcesz zachować własny wygląd kart kreatora, spraw, by jego zapytanie używało wyniku filtra. Poniższy snippet podpina się pod pre_get_posts, pyta HUSKY, które produkty pasują do bieżącego filtra, i ogranicza zapytanie siatki do nich. To wzmocniona wersja kodu z artykułu Jak sprawić, by kreatory stron i własne szablony były filtrowalne: nie rusza list produktów w wp-admin, zachowuje działanie paginacji siatki, respektuje stały wybór produktów w elemencie i pokazuje „brak produktów” zamiast całego katalogu, gdy nic nie pasuje.

/**
 * HUSKY: apply the active filter to product lists that run their own query
 * (page builder grids, post cards, query loops, custom templates).
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'pre_get_posts', function ( $query ) {
    static $busy = false;

    if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
        return;
    }
    // Keep the product lists in wp-admin untouched.
    if ( is_admin() && ! wp_doing_ajax() ) {
        return;
    }
    // Product queries only.
    if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
        return;
    }
    // WooCommerce archives and [woof_products] are filtered already.
    if ( 'product_query' === $query->get( 'wc_query' ) ) {
        return;
    }
    // Only while a filter is active: ?swoof=1, an SEO URL,
    // or ?min_price=...&max_price=... when only the price is set.
    $request = woof()->get_request_data();
    if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
        return;
    }
    // Optional: limit to one page.
    // if ( ! is_page( 123 ) ) { return; }

    $was_doing = isset( $_REQUEST['woof_products_doing'] );
    $args      = woof()->woof_products( array( 'get_args_only' => 1 ) );

    // All matching IDs, whatever page of the grid is open.
    $args['fields']         = 'ids';
    $args['posts_per_page'] = -1;
    $args['paged']          = 1;
    $args['no_found_rows']  = true;
    $args['orderby']        = 'ID';
    unset( $args['meta_key'] );

    $busy = true;
    $ids  = ( new WP_Query( $args ) )->posts;
    $busy = false;

    if ( ! $was_doing ) {
        unset( $_REQUEST['woof_products_doing'] );
    }

    // Respect a fixed product selection of the element itself.
    $own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
    if ( $own ) {
        $ids = array_values( array_intersect( $ids, $own ) );
    }

    // No match: show "no products" instead of the whole catalog.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );

Jak to działa: woof()->woof_products( array( 'get_args_only' => 1 ) ) zwraca argumenty zapytania, których użyłby [woof_products] dla bieżącego żądania, bez jego wykonywania. Snippet zamienia je na listę identyfikatorów pasujących produktów i przekazuje tę listę siatce jako post__in. Siatka zachowuje własny układ, sortowanie i rozmiar strony. Ten sam hook obejmuje WP_Query napisane przez Ciebie w szablonie, o ile odpytuje typ wpisu product.

Każde zapytanie o produkty na przefiltrowanej stronie podąża teraz za filtrem, także slidery takie jak „bestsellery” czy „produkty powiązane” w stopce. Jeśli nie tego chcesz, odkomentuj linię z is_page() i wpisz identyfikator strony z siatką; oszczędza to również jedno dodatkowe zapytanie do bazy dla każdej innej listy produktów na stronie.

Tryb AJAX wymaga dwóch haków pętli sklepu

Gdy Próbuj zajaxować sklep (Try to ajaxify the shop) jest ustawione na Tak (Yes) (WooCommerce → Ustawienia → Products Filter → Opcje), wtyczka opakowuje listę produktów we własny kontener. Otwiera go na haku woocommerce_before_shop_loop, a zamyka na woocommerce_after_shop_loop. Po każdej zmianie filtra pobiera z serwera nowy kod HTML i podmienia zawartość tego kontenera. Standardowy szablon archiwum WooCommerce wywołuje oba haki; wiele układów kreatorów i własnych szablonów nie. Wynikiem jest jeden z trzech objawów:

  • Żaden hak nie jest wywoływany: nie ma kontenera do podmiany, więc każda zmiana filtra przeładowuje całą stronę.
  • Wywoływany jest tylko pierwszy hak: otwarty kontener nigdy nie zostaje zamknięty i pochłania resztę układu, na przykład drugą kolumnę lub pasek boczny, który nagle pojawia się wewnątrz kolumny produktów.
  • Karty zmieniają wygląd po filtrowaniu: wyniki AJAX są renderowane na serwerze przez [woof_products] ze standardową kartą produktu WooCommerce, a nie z projektem karty kreatora. Domyślne pola ilości lub przyciski dodawania do koszyka pojawiają się tam, gdzie kreator je ukrył.

Jeśli masz kontrolę nad kodem szablonu, wywołaj oba haki wokół pętli:

<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );

woocommerce_product_loop_start();
while ( have_posts() ) {
    the_post();
    wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();

do_action( 'woocommerce_after_shop_loop' );

Wszystko między dwoma hakami jest podmieniane przy każdym żądaniu AJAX, więc znaczniki opakowujące, które chcesz mieć wokół każdego produktu, należą do content-product.php, a nie do szablonu archiwum. Własne warunki Twojej pętli (na przykład „produkty z ostatnich 60 dni”) nie wchodzą do wyniku AJAX, ponieważ serwer renderuje go przez [woof_products]; dodaj takie warunki hakiem woof_products_query albo użyj trybu przekierowania.

Jeśli nie możesz zmienić szablonu, co w przypadku kreatorów jest typowe, ustaw Próbuj zajaxować sklep (Try to ajaxify the shop) na Nie (No). W trybie przekierowania każda zmiana filtra ładuje przefiltrowany adres URL, a snippet z Poprawki 2 sprawia, że siatka kreatora pokazuje właściwe produkty. Przy włączonym autosubmit każdy wybór jest stosowany od razu, tylko z załadowaniem strony zamiast podmiany AJAX.

Filtr przeskakuje na stronę sklepu lub ignoruje kategorię

Wyniki otwierają się na stronie sklepu. Na stronie, która nie jest archiwum produktów, skrypt filtra szuka listy produktów WooCommerce: elementu z klasą products wewnątrz kontenera .woocommerce albo własnego wyniku wtyczki. Jeśli żadnej nie znajdzie, wysyła wyszukiwanie na stronę sklepu, a filtr na Twojej stronie wydaje się znikać. Rozwiązuje to Poprawka 1; konfiguracje shortcode'ów dla stron docelowych i strony głównej opisuje artykuł filtr produktów na własnej stronie. Jeśli siatka Twojego kreatora już reaguje na filtr dzięki Poprawce 2, ale używa innego znacznika, powiedz skryptowi, aby został na stronie:

/**
 * HUSKY: keep filter results on this page instead of the shop page.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'wp_footer', function () {
    if ( is_page( 123 ) ) { // ID of the page with the product grid
        echo '<script>var woof_not_redirect = 1;</script>';
    }
} );

Filtr oferuje określenia z innych kategorii. Wtyczka pobiera bieżącą kategorię z WordPressa (zapytany obiekt archiwum taksonomii produktów). Strona WordPressa zbudowana tak, by wyglądała jak kategoria, jej nie ma, więc filtr pracuje z całym katalogiem. Użyj prawdziwego archiwum kategorii i ostyluj je szablonem archiwum kreatora lub theme buildera albo przekaż taxonomies=product_cat:ID obu shortcode'om, jak w Poprawce 1. Motyw własny, zbudowany bez wsparcia dla WooCommerce, może dawać ten sam efekt na prawdziwych archiwach; deklaracja add_theme_support( 'woocommerce' ) w funkcji zwrotnej after_setup_theme naprawia wykrywanie, choć szablony produktów motywu mogą wtedy wymagać dopasowania. Jeśli strona jest prawdziwym archiwum, a kategoria nadal nie jest wykrywana, ustaw Dodatkowe sprawdzenie strony kategorii (Additional check of the category page) na Tak (Yes) w sekcji Zaawansowane → Opcje. Motywy blokowe dostają to sprawdzenie automatycznie. Aby ukryć określenia, które nie mają produktów w bieżącej kategorii, zobacz jak pokazać tylko opcje filtra bieżącej kategorii.

Konflikty routingu: adresy SEO i bezpośrednie odnośniki

Gdy rozszerzenie SEO URL request jest włączone, filtr staje się częścią ścieżki, na przykład /shop/swoof/color-red/, zamiast ciągu zapytania. Niektóre kreatory same rozwiązują adresy URL i szablony (znanym przypadkiem jest Bricks) i nie rozpoznają tej ścieżki, więc interfejs filtra działa, a produkty nigdy się nie zmieniają, albo strona wraca do nieprzefiltrowanego szablonu. Aby to sprawdzić, otwórz Zaawansowane → SEO URL request i ustaw Włącz/Wyłącz (Enable/Disable) na Nie (No), wyczyść każdy cache i przefiltruj ponownie. Jeśli zwykłe linki ?swoof=1&... działają, przyczyną jest routing; na tej witrynie zostaw adresy SEO wyłączone.

Adresy SEO wymagają też ładnych bezpośrednich odnośników. Przy ustawieniu Zwykłe (Plain) w Ustawienia → Bezpośrednie odnośniki wybierz dowolną inną strukturę, zapisz i przetestuj ponownie.

Typowe sytuacje z kreatorami

Co pokazuje produktyCo zrobić
Siatka produktów kreatora, karty wpisów, repeater lub element query loop (Avada Post Cards, Oxygen Repeater, Bricks query loop, blok Query Loop z własnym zapytaniem)Poprawka 2, tryb przekierowania. Albo zastąp element shortcode'em [woof_products].
Układ theme buildera zastępujący szablon sklepu lub kategorii (układy Avada, YOOtheme, Flatsome, Beaver Themer, Breakdance)Działa w trybie przekierowania, gdy układ używa pętli WooCommerce. Tryb AJAX tylko wtedy, gdy układ wywołuje oba haki pętli sklepu; w przeciwnym razie ustaw Próbuj zajaxować sklep (Try to ajaxify the shop) na Nie (No).
Widżety produktów Elementora i siatki pętliZobacz jak sprawić, by siatki produktów Elementora były filtrowalne.
Ręcznie napisane WP_Query w szablonie PHPObejmuje je Poprawka 2; w trybie AJAX dodaj dwa haki.
Inna wtyczka, która zastępuje zapytanie o produkty lub szablonDezaktywuj ją na próbę. Jeśli filtr wtedy działa, ta wtyczka musi używać standardowego zapytania WooCommerce.

Jeśli nadal nie działa

  • Przetestuj bez logowania w oknie prywatnym. Cache strony, który ignoruje ciąg zapytania, serwuje ten sam nieprzefiltrowany HTML dla każdego adresu filtra; wyklucz z cache strony adresy zawierające swoof.
  • Po dodaniu snippetu otwórz adres filtra bezpośrednio. Jeśli siatka nadal jest nieprzefiltrowana, element prawdopodobnie nie odpytuje typu wpisu product albo ładuje swoje produkty później własnym żądaniem AJAX bez parametrów filtra (robią tak niektóre przyciski „załaduj więcej”).
  • Jeśli pierwsza strona filtruje poprawnie, ale strona 2 pokazuje błąd 404 lub nieprzefiltrowane produkty, linki paginacji siatki gubią parametry filtra. Sprawdź, czy link do strony 2 nadal zawiera swoof=1 i Twoje wybory; więcej przyczyn opisuje artykuł paginacja filtra nie działa.

Jeśli test z shortcode'em z pierwszej sekcji działa, a Twój szablon nadal nie, załóż wątek na forum wsparcia HUSKY, podając link do strony, motyw lub kreator oraz element, który pokazuje produkty.