HUSKY - WooCommerce Product Filter Professional

Filtro prodotti WooCommerce non visibile su mobile: cause e soluzioni

Il filtro funziona sul computer, ma sullo smartphone la barra laterale è sparita, il pulsante Apri filtro (Open filter) non compare mai, oppure compare e non fa nulla. Un filtro prodotti WooCommerce che non si vede su mobile raramente è rotto. La modalità mobile di HUSKY ha tre parti in movimento: il server stabilisce che il visitatore usa uno smartphone, uno script sposta il pulsante al suo posto e un tocco apre il modulo come pannello a schermo intero. Ognuna di queste parti può essere bloccata dal tema, da un page builder, da una cache o da un ottimizzatore. Questa guida mostra quale parte non funziona e come risolvere.

Come funziona la modalità mobile di HUSKY

Molti temi non mostrano affatto la barra laterale sugli smartphone. Se il filtro è un widget della barra laterale e non è stato configurato altro, questo basta a spiegare perché manca. La modalità mobile è il modo in cui il plugin offre agli smartphone un pulsante che apre il filtro. Nelle impostazioni non esiste un interruttore "mobile" globale: la modalità mobile si attiva per ogni modulo di filtro:

  • Widget: imposta Modalità mobile (Mobile mode) su Sì nel widget HUSKY.
  • Shortcode: [woof sid="mobile" mobile_mode=1]. L'attributo sid è obbligatorio; senza di esso mobile_mode viene ignorato.
  • Front builder: attiva Modalità mobile (Mobile mode) nelle opzioni del modulo [woof_front_builder].

Quando la pagina viene generata per uno smartphone, il plugin stampa quel modulo nascosto e vi aggiunge due pulsanti, Apri filtro (Open filter) e Chiudi filtro (Close filter). Sui desktop lo stesso modulo viene mostrato normalmente. Quando la pagina si carica su uno smartphone, uno script sposta il pulsante Apri filtro (Open filter) dal modulo nascosto in un punto visibile:

  1. il contenitore stampato dallo shortcode [woof_mobile], se la pagina ne ha uno;
  2. altrimenti l'elemento che corrisponde a .woocommerce-products-header, il blocco con il titolo del negozio o della categoria nel template standard degli archivi di WooCommerce.

Un tocco sul pulsante aggiunge al modulo la classe woof_show_filter_for_mobile, che lo trasforma in un pannello fisso a schermo intero sopra la pagina. In modalità AJAX il pannello si chiude da solo dopo ogni filtraggio, così il visitatore vede i nuovi prodotti.

Due fatti spiegano la maggior parte dei problemi. Primo, "smartphone" viene deciso sul server da wp_is_mobile() di WordPress in base alle intestazioni della richiesta, non in base alla larghezza dello schermo. Secondo, [woof_mobile] segna soltanto un punto: non mostra nulla se la stessa pagina non contiene anche un modulo con la modalità mobile attiva.

Il pulsante Apri filtro non compare

Il template non ha un posto per il pulsante. I template del theme builder di Elementor e Divi, i layout di Avada, le pagine personalizzate che elencano i prodotti con lo shortcode [products] e molti temi personalizzati spesso non hanno il blocco .woocommerce-products-header. Il pulsante resta allora dentro il modulo nascosto. Inserisci [woof_mobile] esattamente dove deve stare il pulsante, di solito sopra i prodotti, in un widget o blocco Shortcode. È la soluzione più comune. Sui desktop non stampa nulla, quindi può restare nella pagina.

Se in quel template non puoi inserire uno shortcode, indica al pulsante un elemento tuo con l'hook woof_mobile_btn_place_container. Assegna a quell'elemento un ID univoco (in Elementor: Avanzate → ID CSS (Advanced → CSS ID)) e usalo:

/*
 * HUSKY: where to put the mobile "Open filter" button.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_mobile_btn_place_container', function ($selector) {
    return '#filter-button-place';
});

Usa un selettore che corrisponda a un solo elemento. Una classe generica come .elementor-widget-container copia il pulsante in ogni elemento corrispondente della pagina. L'hook non viene usato quando la pagina ha un contenitore [woof_mobile].

Altri motivi per cui il pulsante manca:

  • Il punto scelto è nascosto sugli smartphone dal tema (un'intestazione o una barra degli strumenti visibile solo sui desktop). Scegli un punto visibile su mobile.
  • Il pulsante compare all'inizio e scompare dopo il filtraggio: il contenitore [woof_mobile] si trova dentro l'elenco prodotti che l'AJAX sostituisce. Spostalo sopra l'elenco.
  • L'ottimizzazione JavaScript ritarda gli script fino al primo tocco o scorrimento ("delay JavaScript execution" in WP Rocket e funzioni simili). Il pulsante viene spostato solo quando lo script del plugin viene eseguito. Escludi /wp-content/plugins/woocommerce-products-filter/ da ritardo, defer e combinazione, poi svuota le cache. I dettagli sono in il filtro con WP Rocket e la cache.
  • L'ottimizzazione CSS (combinazione o "rimozione del CSS non utilizzato") ha eliminato gli stili del plugin, quindi il pulsante esiste nella pagina ma è nascosto o senza stile. Escludi anche il CSS del plugin.
  • Stai testando su un tablet. Safari su iPad e Chrome sui tablet Android più grandi richiedono per impostazione predefinita la versione desktop dei siti, quindi questi tablet ricevono il layout desktop. Se il tema nasconde la barra laterale alla larghezza del tablet, il filtro lì sparisce; mostra la barra laterale con il CSS oppure inserisci il modulo nell'area del contenuto.

Il pulsante c'è ma non si apre nulla

Il modulo si trova dentro qualcosa di nascosto. Il pulsante è stato spostato, ma il pannello è sempre il modulo stesso, nella sua posizione originale. Se il tema nasconde la barra laterale sugli smartphone con display: none, il pannello si apre dentro un riquadro nascosto e resta invisibile. Ci sono tre soluzioni:

  • Mostra la barra laterale sugli smartphone con il CSS. Il modulo HUSKY al suo interno resta nascosto finché non tocchi il pulsante, ma diventano visibili anche gli altri widget di quella barra laterale, quindi la soluzione è adatta a una barra laterale che contiene solo il filtro.
  • Sposta il modulo in modalità mobile fuori dalla barra laterale, nell'area del contenuto, per esempio sopra i prodotti.
  • Lascia il widget ai desktop (con Modalità mobile (Mobile mode) su No) e fai inserire al plugin un filtro sopra i prodotti solo sugli smartphone: Opzioni → Imposta il filtro automaticamente → Sì, ma solo per dispositivi mobili (Options → Set filter automatically → Yes, but only for mobile devices), più Design → Nascondi il filtro automatico per impostazione predefinita → Sì (Design → Hide auto filter by default → Yes) per avere un pulsante di mostra/nascondi. Serve un template che esegua il ciclo prodotti standard di WooCommerce.

Una regola tipica per la prima soluzione, con il selettore adattato al tuo tema:

/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
    body.woocommerce-page #secondary {
        display: block;
    }
}

Lo stesso accade quando il filtro si trova dentro un drawer off-canvas del tema o un popup di Elementor: il drawer o il popup ha una propria visibilità e propri script, e il pannello non può aprirsi dall'interno. Usa o il drawer o la modalità mobile di HUSKY, non entrambi.

Il sid contiene uno spazio. La sintassi delle skin come sid="flat_grey woof_auto_3_columns" funziona per l'aspetto del modulo, ma nella versione 3.4.6 il pulsante mobile non riesce a trovare un modulo il cui sid ha due parole. Usa un sid di una sola parola per un modulo in modalità mobile.

Ci sono due copie del filtro. I page builder spesso contengono una sezione per il desktop e un duplicato per il mobile, nascosti con la visibilità responsive. Entrambi sono nell'HTML, nascosti solo dal CSS, quindi due moduli con gli stessi identificatori entrano in conflitto: le sezioni smettono di aprirsi, compaiono due icone del filtro oppure il pulsante apre la copia che non vedi. Mantieni un solo filtro per pagina e lascia che la modalità mobile gestisca gli smartphone.

Un errore di script. Apri la pagina sullo smartphone, oppure nell'emulazione dei dispositivi del desktop dopo un ricaricamento, e controlla la console del browser. Un errore in uno qualsiasi degli script caricati prima di quello di HUSKY blocca anche quest'ultimo.

Layout mobile su desktop, layout desktop su smartphone

Poiché la decisione viene presa quando la pagina viene generata, una cache di pagina che memorizza un'unica copia per tutti serve ciò che ha visto il primo dispositivo. I visitatori desktop ricevono allora il pulsante Apri filtro (Open filter) e un modulo nascosto, oppure i visitatori su smartphone ricevono la barra laterale completa e nessun pulsante, e la situazione cambia a ogni svuotamento della cache. La soluzione sta nella cache, non nel filtro:

  • WP Rocket: abilita la cache per dispositivi mobili e File di cache separati per i dispositivi mobili (Separate cache files for mobile devices).
  • LiteSpeed Cache: attiva Cache mobile (Cache Mobile).
  • Cache di pagina di Cloudflare, Varnish o cache dell'hosting: memorizza in cache per tipo di dispositivo, oppure escludi le pagine del negozio e delle categorie.

Svuota tutte le cache dopo la modifica. Lo stesso vale per la visibilità mobile dell'estensione slideout e per Imposta il filtro automaticamente (Set filter automatically) con i valori Sì, ma solo per dispositivi mobili (Yes, but only for mobile devices) e Sì, ma solo per desktop (Yes, but only for desktop), che usano anch'essi wp_is_mobile().

Per lo stesso motivo, ridimensionare la finestra di un browser desktop non fa mai passare il filtro alla modalità mobile. Testa su uno smartphone reale, senza aver effettuato l'accesso, oppure con l'emulazione dei dispositivi del browser e un ricaricamento della pagina.

Problemi dentro il pannello aperto

I menu a discesa sono compressi, vuoti o aprono la tastiera. I menu a discesa Chosen e SelectWoo calcolano la loro larghezza al caricamento della pagina, quando il modulo è ancora nascosto, e includono un campo di ricerca che fa comparire la tastiera dello smartphone. La soluzione più pulita è Design → Skin del menu a discesa → Nativo (Design → Drop-down skin → Native): gli smartphone mostrano allora il proprio elenco di selezione, senza campo di ricerca e senza problemi di larghezza. Per mantenere Chosen o SelectWoo, assegna loro una larghezza minima:

/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
    min-width: 200px;
}

Il pannello è trasparente, nascosto sotto un'intestazione fissa oppure il suo testo è invisibile. Per impostazione predefinita il pannello è leggermente trasparente e usa z-index: 9999, valore che alcune intestazioni fisse superano. Regolalo nel tuo CSS personalizzato:

/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
    opacity: 1;
    z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
    color: #333;
}

Se il pannello si apre comunque sotto l'intestazione (l'intestazione si trova in un contesto di sovrapposizione sopra il quale il pannello non può salire), aggiungi padding-top: 90px; alla prima regola, in modo che il pulsante Chiudi filtro (Close filter) parta sotto l'intestazione.

Il pannello si chiude a ogni tocco. Con l'invio automatico e l'AJAX, ogni scelta esegue il filtro e il pannello si chiude per mostrare i risultati. Se i visitatori di solito combinano più opzioni, disattiva l'invio automatico per questo modulo, [woof sid="mobile" mobile_mode=1 autosubmit=0], così scelgono e poi toccano il pulsante del filtro.

Piccoli difetti su iPhone. Un segnaposto non allineato nel campo di ricerca testuale si corregge con .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. I contatori dei prodotti dei filtri di tipo etichetta che si allontanano dalle loro etichette si correggono con .woof_container_label .woof_list_label li { position: relative; }.

Modificare il pulsante

L'aspetto del pulsante si imposta nella scheda Design: Immagine per il pulsante del filtro mobile (Image for mobile filter button), Testo per il pulsante del filtro mobile (Text for mobile filter button), Immagine per chiudere il filtro mobile (Image to close mobile filter) e Testo per chiudere il filtro mobile (Text to close mobile filter). Inserisci -1 in un campo immagine per mostrare solo il testo, o in un campo testo per mostrare solo l'icona. Spaziatura e colore si regolano con semplice CSS su .woof_show_mobile_filter, per esempio .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.

Per i passaggi di configurazione di base, consulta come mostrare il filtro sui dispositivi mobili; per tutti gli attributi dello shortcode principale, il riferimento di [woof].

Checklist

  • Un solo modulo di filtro nella pagina, con la modalità mobile attiva (opzione del widget, oppure mobile_mode=1 con un sid di una sola parola, oppure l'opzione del front builder).
  • [woof_mobile] posizionato dove deve stare il pulsante, fuori dall'elenco prodotti, in un punto visibile sugli smartphone.
  • Il modulo stesso non si trova dentro una barra laterale, un drawer o un popup nascosto sugli smartphone.
  • JavaScript e CSS del plugin sono esclusi da ritardo, defer, combinazione e rimozione del CSS non utilizzato.
  • La cache di pagina conserva copie separate per i dispositivi mobili e tutte le cache sono state svuotate.
  • Testato su uno smartphone reale o con l'emulazione dei dispositivi e un ricaricamento, senza aver effettuato l'accesso.

Se il filtro continua a non comparire su uno smartphone, apri una discussione nel forum di supporto di HUSKY indicando il link della pagina, le impostazioni dello shortcode o del widget che usi e gli errori della console del browser.