HUSKY - WooCommerce Product Filter Professional

Il filtro AJAX di WooCommerce rompe la griglia prodotti: cause e soluzioni

Il negozio sembra a posto fino al primo clic sul filtro. Poi tre colonne diventano quattro, le righe hanno dei buchi, le schede prodotto perdono i badge o i pulsanti del tema, oppure la sidebar scivola sotto i prodotti. Quando un filtro AJAX di WooCommerce rompe il layout della griglia dei prodotti, i prodotti in sé sono corretti; ciò che è cambiato è l'HTML che li disegna. Qui sotto trovi cosa sostituisce la modalità AJAX di HUSKY, perché il markup specifico del tema va perso lungo il percorso e la soluzione per ogni sintomo.

Cosa sostituisce la modalità AJAX e cosa non può copiare

Con Prova a rendere il negozio AJAX (Try to ajaxify the shop) impostato su Sì (Yes) (WooCommerce → Impostazioni (Settings) → Products Filter → Opzioni (Options)), il plugin delimita l'area dei prodotti delle pagine del negozio e delle categorie. Sull'hook woocommerce_before_shop_loop (priorità 2) apre un contenitore <div class="woocommerce woocommerce-page woof_shortcode_output"> con al suo interno <div id="woof_results_by_ajax">, e su woocommerce_after_shop_loop (priorità 10) li chiude entrambi.

Quando un visitatore modifica il filtro, lo script invia una richiesta a /wp-admin/admin-ajax.php con l'azione woof_draw_products. Il server genera [woof_products is_ajax=1] e lo script sostituisce il contenitore con il risultato. Quel risultato è costruito solo con parti standard di WooCommerce:

  • l'hook woocommerce_before_shop_loop (avvisi, numero di risultati, menu a discesa dell'ordinamento);
  • woocommerce_product_loop_start(), che stampa <ul class="products columns-N">;
  • la parte di template content-product.php per ogni prodotto;
  • woocommerce_product_loop_end() e l'hook woocommerce_after_shop_loop (paginazione).

Ne derivano due cose. Primo, tutto ciò che il template dell'archivio del tuo tema stampa da sé tra i due hook (wrapper aggiuntivi, una classe della griglia, la skin di un loop di un builder) non è presente nel nuovo HTML. Secondo, il nuovo HTML è prodotto in una richiesta admin-ajax, non nella pagina del negozio. Il codice che viene eseguito durante il caricamento della pagina del negozio, sull'azione wp o template_redirect, dentro il template dell'archivio o solo quando is_admin() è false, non viene mai eseguito per esso. Anche gli script del tema che hanno applicato lo stile alla griglia una sola volta al caricamento della pagina non vengono rieseguiti.

Scopri cosa è cambiato: confronta il markup prima e dopo

Apri il negozio in una finestra privata, fai clic con il tasto destro sul primo prodotto e scegli Ispeziona (Inspect). Annota le classi di ul.products, dei suoi elementi padre e del primo li.product. Applica un filtro e ispeziona di nuovo lo stesso punto. La differenza indica la soluzione:

Sintomo dopo il filtraggioCausaSezione
Numero di colonne diverso, columns-4 invece di columns-3L'impostazione delle colonne del tema non viene applicata nella richiesta AJAXColonne e spazi
Righe di 3, poi 1, poi 3; buchi nella grigliaLe classi di riga first/last sono calcolate per un altro numero di colonneColonne e spazi
La sidebar o il footer si spostano, spariscono o si ripetono; prodotti mostrati due volteIl tema non chiama entrambi gli hook del loop del negozio attorno al loopHook del loop del negozio
Classe mancante su ul.products, pulsanti o badge tornati, vista griglia/elenco persa, immagini vuoteMarkup del tema, condizioni PHP o script del temaFunzioni delle schede del tema

Le colonne dei prodotti cambiano dopo il filtraggio e compaiono degli spazi

[woof_products] prende il numero di colonne dal filtro loop_shop_columns di WooCommerce, che ripiega su Prodotti per riga (Products per row) in Aspetto → Personalizza → WooCommerce → Catalogo prodotti (Appearance → Customize → WooCommerce → Product Catalog). I temi con una propria opzione per le colonne spesso la applicano solo mentre si carica una pagina del negozio. Nella richiesta AJAX quel codice non viene eseguito, quindi i risultati tornano con il valore di WooCommerce: spesso 4 dove il negozio ne mostra 3.

Gli spazi hanno la stessa origine. WooCommerce assegna al primo prodotto di ogni riga la classe first e all'ultimo la classe last, contando a partire da quel numero di colonne, e la classica griglia con float inizia una nuova riga a ogni first. Se il CSS del tema dispone 3 prodotti per riga e l'HTML AJAX ne conta 4, ogni quarto prodotto forza una nuova riga: 3 prodotti, poi 1 da solo, poi di nuovo 3.

Imposta una sola volta il numero di colonne, per ogni richiesta, con il numero che il tuo negozio mostra su desktop:

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

Non racchiuderlo in is_shop() o controlli simili, altrimenti verrà saltato nella richiesta AJAX. La priorità 999 gli fa prevalere sul filtro proprio del tema. Le FAQ brevi forzare i risultati filtrati in un numero fisso di colonne usano lo stesso filtro. In una pagina personalizzata, [woof_products columns=3] imposta direttamente il numero. Smartphone e tablet sono gestiti in entrambi i casi dalle media query del CSS del tema.

Se dopo il filtraggio la classe riporta columns-3 e le larghezze sono comunque sbagliate, il tema dimensiona i prodotti tramite una classe sul proprio wrapper all'esterno dell'area sostituita. Aggiungi CSS per il contenitore AJAX in Aspetto → Personalizza → CSS aggiuntivo (Appearance → Customize → Additional CSS) oppure nel campo Codice CSS personalizzato (Custom CSS code) del plugin (Avanzate (Advanced) → Codice (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;
}

Se il tuo tema dispone ul.products con CSS grid invece dei float, basta una regola: #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Racchiudi entrambe le versioni in una media query per desktop se il tema usa meno colonne sugli smartphone.

Sidebar sotto i prodotti, footer rotto, risultati doppi: gli hook del loop del negozio

La modalità AJAX richiede che il tema chiami woocommerce_before_shop_loop direttamente prima dell'elenco dei prodotti e woocommerce_after_shop_loop direttamente dopo, come fa il template standard di WooCommerce. Quando non lo fa:

  • Manca l'hook di chiusura. I due contenitori non vengono mai chiusi, e il browser li chiude solo alla fine del loro elemento padre. La sidebar, la seconda colonna o il footer finiscono dentro l'area dei prodotti: spesso la sidebar si trova già sotto i prodotti al caricamento della pagina e, dopo il primo clic sul filtro, tutto ciò che sta dentro il contenitore, sidebar con il filtro inclusa, viene sostituito dai risultati.
  • Gli hook sono chiamati altrove. Se il tema li attiva in una barra degli strumenti e stampa il loop dei prodotti dopo woocommerce_after_shop_loop, i risultati AJAX finiscono nel contenitore mentre la griglia originale resta sotto di esso, quindi i prodotti compaiono due volte.
  • I wrapper del tema attraversano i contenitori. Un elemento che il tema apre su woocommerce_before_shop_loop e chiude su woocommerce_after_shop_loop deve trovarsi interamente dentro i contenitori di HUSKY (aperti dopo la priorità 2, chiusi prima della priorità 10) o interamente fuori. Qualsiasi posizione intermedia li sovrappone e rompe l'annidamento.

Per verificare, apri il sorgente della pagina (Ctrl+U), cerca woof_results_by_ajax e segui l'HTML verso il basso: dopo il </ul> di chiusura dei prodotti e la paginazione devono esserci due </div> prima che inizi la sidebar o il footer. Nella cartella del tema cerca woocommerce_after_shop_loop nei template degli archivi. La parte dei prodotti di un template che funziona con la modalità AJAX assomiglia all'archive-product.php di 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' );
}

Fai la modifica in una copia del template nel child theme, oppure chiedi all'autore del tema di aggiungere l'hook mancante. I layout dei page builder raramente chiamano entrambi gli hook; per loro la modalità redirect, descritta più avanti, è la scelta realistica. I prodotti che non cambiano affatto sono trattati in l'URL del filtro cambia ma i prodotti no, e i template Elementor in Elementor Loop Grid e template di archivio che non filtrano.

Funzioni delle schede del tema perse: badge, pulsanti, classi della griglia, script

Modifiche che il tuo PHP applica solo nelle pagine del negozio

Il codice che nasconde i pulsanti di aggiunta al carrello, aggiunge una riga con la categoria o un badge, e lo decide su wp o template_redirect con is_shop(), non viene eseguito nella richiesta AJAX, quindi dopo il filtraggio ritorna la scheda predefinita. Eseguilo anche per la richiesta di HUSKY. admin_init viene attivato in ogni richiesta 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();
    }
} );

Le opzioni del tema che modificano la scheda (una riga con la categoria, un'immagine al passaggio del mouse, un pulsante di anteprima rapida) vengono spesso applicate allo stesso modo all'interno del tema. Se spariscono dopo il filtraggio e il tema non ha un hook che copra anche le richieste AJAX, usa la modalità redirect.

Classi che il tema aggiunge all'elenco dei prodotti

Se il confronto mostra una classe su ul.products che esiste al caricamento della pagina e manca dopo il filtraggio, aggiungila alla risposta AJAX con il filtro woof_draw_products_html. Riceve l'HTML che sta per essere inviato al browser:

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

La stringa di ricerca corrisponde al file loop/loop-start.php di WooCommerce; se il tuo tema sovrascrive quel file, copia il tag di apertura dal sorgente della pagina. Quando il tema genera le schede con una parte di template diversa da content-product.php, restituisci il suo nome con il filtro woof_template_part: il valore product-grid carica content-product-grid.php dalla cartella woocommerce del tuo tema.

Script del tema: immagini lazy, altezze uguali, masonry, quick view

Gli script che vengono eseguiti una sola volta al caricamento della pagina (immagini a caricamento lazy, schede di altezza uguale, masonry, selettori griglia/elenco, pulsanti di anteprima rapida) non vedono i nuovi prodotti. HUSKY attiva l'evento jQuery woof_ajax_done dopo ogni sostituzione; inserisci lì la chiamata di inizializzazione del tema, in un file JS del tema o in Codice JavaScript dopo il completamento di AJAX (JavaScript code after AJAX is done) (Avanzate (Advanced) → Codice (Code)). L'autore del tema può indicare il nome della funzione; maggiori dettagli sull'evento in 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
});

Numero di risultati o ordinamento mostrati due volte

Un tema che stampa un proprio conteggio e una propria barra di ordinamento fuori dall'area dei prodotti può comunque ricevere le copie predefinite di WooCommerce all'interno dei risultati AJAX. Nascondi le copie interne, solo se sono davvero duplicati:

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

Se il conteggio del tema all'esterno dell'area non si aggiorna dopo il filtraggio, inserisci il suo selettore CSS in Selettore CSS del conteggio dei risultati (Result count css selector) (Avanzate (Advanced) → Opzioni (Options)): il plugin invierà allora un conteggio aggiornato con ogni risposta AJAX e sostituirà l'elemento che trova.

Quando rinunciare ad AJAX: modalità redirect e Modalità Turbo

Alcuni layout non possono essere ricostruiti con le parti standard di WooCommerce: skin di loop dei builder, caroselli, template del tema senza gli hook. Imposta Prova a rendere il negozio AJAX (Try to ajaxify the shop) su No. Ogni modifica del filtro carica allora l'URL filtrato e il tuo tema genera l'intera pagina come al solito, quindi la griglia è identica a quella del negozio non filtrato. Quello che perdi è l'aggiornamento sul posto. Per ricaricare una sola volta per ricerca invece che dopo ogni clic, imposta Invio automatico (Autosubmit) su No in modo che il filtro attenda il suo pulsante, e vedi scorrimento automatico ai prodotti in modalità redirect per portare il visitatore sui risultati.

Se Prova a rendere il negozio AJAX (Try to ajaxify the shop) torna su Sì (Yes), è attiva la Modalità Turbo: attiva la modalità AJAX a ogni caricamento di pagina. Imposta prima Abilita la modalità Turbo (Enable turbo mode) su No nella sua scheda, poi disattiva AJAX, e svuota la cache delle pagine in modo che i visitatori ricevano la nuova impostazione.

Checklist

  • Markup confrontato prima e dopo il filtraggio nell'ispettore del browser.
  • loop_shop_columns restituisce il numero di colonne del negozio senza condizioni di pagina.
  • Il sorgente della pagina mostra i due contenitori di HUSKY che si chiudono subito dopo i prodotti e la paginazione.
  • Le modifiche PHP alle schede vengono eseguite anche per la richiesta woof_draw_products; gli script del tema vengono rieseguiti su woof_ajax_done.
  • Se il layout continua a essere diverso: Prova a rendere il negozio AJAX (Try to ajaxify the shop) = No, con la Modalità Turbo disattivata e le cache svuotate.

Se il layout continua a rompersi con un tema predefinito come Storefront e con il solo HUSKY attivo, apri un argomento nel forum di supporto di HUSKY con il link alla pagina del negozio e una descrizione di cosa cambia dopo il filtraggio.