HUSKY - WooCommerce Product Filter Professional

Filtro WooCommerce: l'URL cambia ma i prodotti non si filtrano

Selezioni un colore o una categoria, compare il loader, la barra degli indirizzi cambia in qualcosa come /shop/?swoof=1&pa_color=red e la griglia dei prodotti mostra sempre gli stessi prodotti. Quando l'URL del filtro WooCommerce cambia ma i prodotti no, il filtro ha fatto la sua parte: ha costruito la richiesta di ricerca. È il template che stampa i prodotti a non averla mai letta. Questa guida mostra come verificarlo in due minuti e come fare in modo che un tema, un page builder o un template personalizzato risponda al filtro.

Perché l'URL del filtro cambia ma i prodotti non cambiano

HUSKY non disegna la griglia dei prodotti del tuo negozio. Aggiunge le proprie condizioni (tassonomie, prezzo, campi meta, testo) alle query dei prodotti che WooCommerce esegue già, e solo a quelle:

  • la query principale della pagina del negozio e degli archivi di categorie, tag e attributi dei prodotti (il passaggio woocommerce_product_query di WooCommerce);
  • lo shortcode [woof_products] del plugin;
  • gli shortcode dei prodotti di WooCommerce, come [products], tramite woocommerce_shortcode_products_query.

Un elenco di prodotti che costruisce la propria WP_Query è fuori da questo percorso. Le griglie di prodotti dei page builder, le card degli articoli e i repeater, gli elementi "query loop", i layout di archivio del tema con una query propria e i loop scritti a mano in un template PHP chiedono tutti i prodotti al database a modo loro, quindi continuano a mostrare l'intero catalogo qualunque cosa dica il filtro. Nel filtro non c'è nulla di rotto: l'elenco semplicemente non ascolta.

Due sintomi correlati hanno la stessa origine. In una pagina normale in cui lo script del filtro non trova alcun elenco di prodotti WooCommerce, il visitatore viene mandato alla pagina del negozio per vedere i risultati. E in una "pagina di categoria" che in realtà è una pagina WordPress creata con un builder, il filtro non conosce la categoria corrente, quindi offre tutti i termini e cerca in tutto il catalogo.

Verifica la causa in due minuti

  1. Leggi l'URL dopo il filtraggio. Se contiene swoof=1 e le tue scelte (/swoof/ seguito da esse quando gli URL SEO sono attivi, oppure solo min_price e max_price quando il prezzo è l'unica scelta), il filtro ha funzionato. Se l'URL non cambia affatto, il filtro non ha mai inviato nulla: cerca prima un errore JavaScript nella console del browser.
  2. Prova la stessa richiesta sulla pagina standard del negozio. Copia tutto da ?swoof=1 in poi e aggiungilo all'URL della pagina del negozio WooCommerce. Se lì i prodotti sono filtrati e nella tua pagina no, il problema è proprio nell'elenco prodotti della tua pagina.
  3. Prova con uno shortcode semplice. In una pagina in bozza inserisci [woof] e sotto [woof_products per_page=12], oppure [products limit="12"] di WooCommerce. Se questi filtrano correttamente, usa una delle soluzioni qui sotto per la tua pagina reale.
  4. Controlla di che tipo di pagina si tratta. Guarda la schermata di modifica: una Pagina (Page) di WordPress con sopra una griglia di prodotti non è un archivio di prodotti, anche se il suo URL assomiglia a /category/shoes/.

Soluzione 1: mostra i prodotti con [woof_products]

La soluzione più affidabile è lasciare che sia il plugin a stampare i prodotti. Sostituisci l'elemento prodotti del builder con un widget o un blocco Shortcode che contenga [woof_products]:

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

Lo shortcode reagisce al filtro in qualsiasi pagina, supporta la modalità AJAX con is_ajax=1 e mostra ogni prodotto con la normale card prodotto WooCommerce del tuo tema (la parte di template content-product.php), quindi ha lo stesso aspetto del negozio. Per usare un'altra parte di template, cambiala con il filtro woof_template_part.

Per una pagina che deve elencare una sola categoria, dai la stessa condizione a entrambi gli shortcode, altrimenti il filtro offre i termini dell'intero catalogo:

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

Sostituisci 25 con l'ID della categoria (visibile nell'URL quando modifichi la categoria). Anche lo shortcode [products] di WooCommerce viene filtrato, ma solo con un ricaricamento della pagina. Se ti serve in modalità AJAX, scrivilo come [products_woof limit="12" columns="4"]: il plugin lo racchiude in modo che i risultati possano essere sostituiti senza ricaricare la pagina.

Soluzione 2: fai in modo che una griglia del builder o una WP_Query personalizzata ascolti il filtro

Se vuoi mantenere il design delle card del builder, fai in modo che la sua query usi il risultato del filtro. Lo snippet qui sotto si aggancia a pre_get_posts, chiede a HUSKY quali prodotti corrispondono al filtro corrente e limita a essi la query della griglia. È una versione rafforzata del codice presente in Rendere filtrabili page builder e template personalizzati: lascia stare gli elenchi di prodotti di wp-admin, mantiene funzionante la paginazione della griglia, rispetta una selezione fissa di prodotti dell'elemento e mostra "nessun prodotto" invece dell'intero catalogo quando nulla corrisponde.

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

Come funziona: woof()->woof_products( array( 'get_args_only' => 1 ) ) restituisce gli argomenti della query che [woof_products] userebbe per la richiesta corrente, senza eseguirla. Lo snippet li trasforma in un elenco di ID dei prodotti corrispondenti e passa quell'elenco alla griglia come post__in. La griglia mantiene il proprio layout, l'ordinamento e il numero di elementi per pagina. Lo stesso hook copre anche una WP_Query scritta da te in un template, purché interroghi il post type product.

Ora ogni query di prodotti in una pagina filtrata segue il filtro, compresi gli slider come "più venduti" o "prodotti correlati" nel footer. Se non è ciò che vuoi, rimuovi il commento dalla riga is_page() e inserisci l'ID della pagina con la griglia; questo evita anche una query al database in più per ogni altro elenco di prodotti della pagina.

La modalità AJAX richiede i due hook del loop del negozio

Con Prova a rendere il negozio AJAX (Try to ajaxify the shop) impostato su Sì (Yes) (WooCommerce → Impostazioni → Products Filter → Opzioni), il plugin racchiude l'elenco dei prodotti in un proprio contenitore. Apre il contenitore con l'hook woocommerce_before_shop_loop e lo chiude con woocommerce_after_shop_loop. Dopo ogni modifica del filtro chiede al server il nuovo HTML e sostituisce il contenuto di quel contenitore. Il template di archivio standard di WooCommerce richiama entrambi gli hook; molti layout dei builder e template personalizzati no. Il risultato è uno di questi tre sintomi:

  • Nessuno dei due hook viene richiamato: non c'è alcun contenitore da sostituire, quindi a ogni modifica del filtro l'intera pagina si ricarica.
  • Viene richiamato solo il primo hook: il contenitore aperto non viene mai chiuso e ingloba il resto del layout, per esempio la seconda colonna o la sidebar, che compare all'improvviso dentro la colonna dei prodotti.
  • Le card cambiano aspetto dopo il filtraggio: i risultati AJAX vengono renderizzati dal server tramite [woof_products] con la card prodotto standard di WooCommerce, non con il design delle card del builder. I campi quantità predefiniti o i pulsanti di aggiunta al carrello compaiono dove il builder li aveva nascosti.

Se controlli il codice del template, richiama entrambi gli hook attorno al loop:

<?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' );

Tutto ciò che si trova tra i due hook viene sostituito a ogni richiesta AJAX, quindi il markup di contorno che vuoi attorno a ogni prodotto va in content-product.php, non nel template di archivio. Le condizioni personalizzate del tuo loop (per esempio "prodotti degli ultimi 60 giorni") non fanno parte del risultato AJAX, perché il server lo renderizza con [woof_products]; aggiungi queste condizioni con l'hook woof_products_query oppure usa la modalità redirect.

Se non puoi modificare il template, come accade di solito con i builder, imposta Prova a rendere il negozio AJAX (Try to ajaxify the shop) su No. In modalità redirect ogni modifica del filtro carica l'URL filtrato e lo snippet della Soluzione 2 fa mostrare alla griglia del builder i prodotti giusti. Con l'invio automatico attivo, ogni scelta viene applicata subito, solo con un caricamento di pagina invece di una sostituzione AJAX.

Il filtro salta alla pagina del negozio o ignora la categoria

I risultati si aprono nella pagina del negozio. In una pagina che non è un archivio di prodotti, lo script del filtro cerca un elenco di prodotti WooCommerce: un elemento con la classe products all'interno di un contenitore .woocommerce, oppure l'output del plugin. Se non ne trova, manda la ricerca alla pagina del negozio e il filtro nella tua pagina sembra sparire. La Soluzione 1 risolve il problema; le configurazioni con shortcode per le landing page e la homepage sono descritte in filtro prodotti in una pagina personalizzata. Se la griglia del tuo builder reagisce già al filtro grazie alla Soluzione 2 ma usa un markup diverso, di' allo script di restare nella pagina:

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

Il filtro offre termini di altre categorie. Il plugin ricava la categoria corrente da WordPress (l'oggetto interrogato di un archivio di tassonomia dei prodotti). Una pagina WordPress costruita per sembrare una categoria non ce l'ha, quindi il filtro lavora con l'intero catalogo. Usa il vero archivio della categoria e imposta lo stile con il template di archivio del builder o del theme builder, oppure passa taxonomies=product_cat:ID a entrambi gli shortcode come mostrato nella Soluzione 1. Un tema personalizzato creato senza il supporto di WooCommerce può avere lo stesso effetto sui veri archivi; dichiarare add_theme_support( 'woocommerce' ) in una callback di after_setup_theme corregge il rilevamento, anche se poi i template dei prodotti del tema potrebbero richiedere qualche adattamento. Se la pagina è un vero archivio e la categoria continua a non essere rilevata, imposta Controllo aggiuntivo della pagina di categoria (Additional check of the category page) su Sì (Yes) in Avanzate → Opzioni. I temi a blocchi ottengono questo controllo automaticamente. Per nascondere i termini senza prodotti nella categoria corrente, vedi come mostrare solo le opzioni del filtro della categoria corrente.

Conflitti di routing: URL SEO e permalink

Con l'estensione Richiesta URL SEO attiva, il filtro diventa parte del percorso, per esempio /shop/swoof/color-red/, invece di una query string. Alcuni builder risolvono da soli URL e template (Bricks è un caso noto) e non riconoscono quel percorso, quindi l'interfaccia del filtro funziona mentre i prodotti non cambiano mai, oppure la pagina ripiega su un template non filtrato. Per verificare, apri Avanzate → Richiesta URL SEO, imposta Abilita/Disabilita (Enable/Disable) su No, svuota ogni cache e filtra di nuovo. Se i normali link ?swoof=1&... funzionano, la causa è il routing; su quel sito mantieni disattivati gli URL SEO.

Gli URL SEO richiedono anche permalink leggibili. Se in Impostazioni → Permalink è selezionato Semplice (Plain), scegli un'altra struttura, salva e prova di nuovo.

Situazioni comuni con i builder

Che cosa mostra i prodottiChe cosa fare
Griglia prodotti del builder, post card, repeater o elemento query loop (Avada Post Cards, Oxygen Repeater, Bricks query loop, un blocco Query Loop con query personalizzata)Soluzione 2, modalità redirect. Oppure sostituisci l'elemento con [woof_products].
Layout del theme builder che sostituisce il template del negozio o della categoria (layout Avada, YOOtheme, Flatsome, Beaver Themer, Breakdance)Funziona in modalità redirect quando il layout usa il loop di WooCommerce. Modalità AJAX solo se il layout richiama entrambi gli hook del loop del negozio; altrimenti imposta Prova a rendere il negozio AJAX (Try to ajaxify the shop) su No.
Widget prodotti e loop grid di ElementorVedi come rendere filtrabili le griglie di prodotti di Elementor.
WP_Query scritta a mano in un template PHPLa Soluzione 2 la copre; per la modalità AJAX aggiungi i due hook.
Un altro plugin che sostituisce la query o il template dei prodottiDisattivalo per una prova. Se poi il filtro funziona, quel plugin deve usare la query standard di WooCommerce.

Se continua a non funzionare

  • Prova da disconnesso in una finestra privata. Una cache delle pagine che ignora la query string serve lo stesso HTML non filtrato per ogni URL del filtro; escludi dalla cache delle pagine gli URL che contengono swoof.
  • Dopo aver aggiunto lo snippet, apri direttamente un URL del filtro. Se la griglia non è ancora filtrata, probabilmente l'elemento non interroga il post type product, oppure carica i suoi prodotti in un secondo momento con una propria richiesta AJAX senza i parametri del filtro (alcuni pulsanti "carica altri" lo fanno).
  • Se la prima pagina viene filtrata correttamente ma la pagina 2 mostra un 404 o prodotti non filtrati, i link di paginazione della griglia perdono i parametri del filtro. Verifica che il link della pagina 2 contenga ancora swoof=1 e le tue scelte; altre cause sono in paginazione del filtro che non funziona.

Se la prova con lo shortcode della prima sezione funziona e il tuo template no, apri una discussione sul forum di supporto di HUSKY con il link alla pagina, il tema o il builder e l'elemento che mostra i prodotti.