HUSKY - WooCommerce Product Filter Professional

Personalizzazione CSS del filtro prodotti WooCommerce: skin, titoli, fix

La personalizzazione CSS del filtro prodotti WooCommerce di solito parte da un piccolo desiderio: caselle di controllo nel colore del brand, titoli più piccoli, un menu a tendina in linea con il tema, oppure la correzione di un tema che disegna una seconda casella accanto a ogni checkbox. HUSKY copre una parte di tutto questo con le impostazioni, e il resto richiede poche righe di CSS, una volta che sai dove inserirle e quali classi usare. Questa guida offre entrambe le cose, più le soluzioni ai conflitti con i temi che incontriamo più spesso.

Prima le impostazioni, poi il CSS

La scheda Design (WooCommerce → Impostazioni → Products Filter → Design) cambia l'aspetto senza codice:

  • Skin per pulsanti radio e caselle di controllo (Radio and checkboxes skin): le skin flat, minimal e square in dieci colori, oppure nessuna (none) per le caselle del browser.
  • Skin del menu a tendina (Drop-down skin): Nativo (Native), Chosen o SelectWoo.
  • Skin dello slider a intervallo (Range-slider skin) per lo slider a intervallo ion, Usa il tooltip (Use tooltip) e Icona del tooltip (Tooltip icon), le immagini di apertura e chiusura e quelle di «mostra di più/meno», e l'overlay di caricamento.

Tutto il resto va in Avanzate (Advanced) → Codice (Code) → Codice CSS personalizzato (Custom CSS code). HUSKY stampa quel codice subito dopo il proprio foglio di stile in ogni pagina in cui viene caricato e lo conserva nelle proprie impostazioni, quindi gli aggiornamenti del plugin non lo toccano. Incolla solo regole CSS semplici: i tag HTML come <style> vengono rimossi al salvataggio delle impostazioni e le barre rovesciate non vengono conservate in modo affidabile, quindi scrivi direttamente il simbolo (content: "✓") invece di una sequenza di escape CSS come \2713. Funziona altrettanto bene il CSS aggiuntivo (Additional CSS) del Customizer del tema o il foglio di stile di un tema figlio. Non modificare mai il file css/front.css del plugin: il prossimo aggiornamento lo sostituisce.

Link al file di stili CSS front personalizzato (Custom front css styles file link), in fondo alla scheda Design, è uno strumento diverso. Carica il tuo file al posto di front.css, non in aggiunta, quindi usalo solo per una riscrittura completa che parta da una copia del file del plugin.

Far prevalere le tue regole

I fogli di stile dei temi spesso si caricano dopo quelli del plugin e usano selettori lunghi, e alcune regole del plugin contengono !important. Inizia ogni regola con .woof, o con body .woof quando il tema prevale ancora, e aggiungi !important solo dove lo usano già il plugin o il tema. Per stilizzare un solo filtro lasciando stare gli altri, assegnagli un ID con l'attributo sid: [woof sid="sidebar"] aggiunge al modulo la classe woof_sid_sidebar. Mantieni l'ID in una sola parola, senza spazi. Tre ID hanno già stili pronti nel foglio di stile del plugin: flat_grey, flat_dark e flat_white. Il widget usa sempre woof_sid_widget. Il filtro automatico sopra i prodotti prende le sue classi dall'impostazione della skin: woof_sid_auto_shortcode con la skin Predefinita (Default), e woof_sid_flat_grey più woof_auto_2_columns con la skin flat grigia con cui parte una nuova installazione; ispeziona il modulo per vedere quale usa il tuo sito.

La mappa delle classi

ElementoSelettore
Intero modulo del filtro.woof, .woof_sid_<sid>
Un blocco del filtro.woof_container, per tipo .woof_container_checkbox, .woof_container_radio, .woof_container_select; per tassonomia .woof_container_product_cat, .woof_container_pa_color
Titolo del blocco.woof_container_inner h4
Elenco ed elementi.woof_list, .woof_list li; sottocategorie .woof_childs_list
Casella di controllo, etichetta, conteggioinput.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count; selezionata .woof_checkbox_label_selected
Pulsante radio ed etichettainput.woof_radio_term, .woof_radio_label
Pulsanti-etichetta.woof_list_label .woof_label_term, selezionato .woof_label_term.checked
Menu a tendina nativoselect.woof_select
Pulsanti Filtra e Reimposta.woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form

L'inspector del browser (clic destro su un elemento, Ispeziona (Inspect)) mostra le classi esatte del tuo filtro e quale regola prevale. Il CSS usato sul sito demo è un'ottima fonte di esempi già pronti.

Caselle di controllo e pulsanti radio: colore, dimensione e nitidezza

Le skin flat, minimal e square disegnano ogni casella da un piccolo sprite di immagini: un'unica immagine contiene affiancati gli stati non selezionato, selezionato e disabilitato, e il CSS mostra la parte giusta. Ne derivano due conseguenze: il CSS non può ricolorare la casella e, se cambi width, height o la scala, compaiono gli stati vicini oppure l'immagine diventa sfocata e pixelata. Scegli il colore della skin più vicino al tuo design, oppure passa alle caselle del browser.

Per un colore del brand o una casella più grande, imposta Skin per pulsanti radio e caselle di controllo (Radio and checkboxes skin) su nessuna (none) e stilizza gli input nativi. accent-color li colora in tutti i browser attuali:

/* Skin "none": colour and size of the browser's own boxes */
.woof .woof_list input.woof_checkbox_term,
.woof .woof_list input.woof_radio_term {
    accent-color: #1f7a4d;
    width: 18px;
    height: 18px;
}

Se dopo questo le caselle mantengono l'aspetto del tema, il tema ridisegna ogni checkbox del sito; vedi la sezione sui conflitti con i temi più sotto. Se mantieni una skin, puoi comunque sostituirne lo sprite con una copia ricolorata dello stesso layout (le immagini sono nella cartella js/icheck/skins/ del plugin) tramite una regola background-image sulla classe della skin, ad esempio .woof .icheckbox_flat-blue. Per elementi completamente personalizzati senza CSS, l'estensione Smart Designer crea nell'amministrazione design di caselle di controllo, pulsanti radio e interruttori; vedi come creare il tuo elemento del filtro.

Le caselle semplici lampeggiano prima che compaia la skin

Le skin vengono applicate da JavaScript dopo il caricamento della pagina, quindi per un attimo sono visibili le caselle del browser. Un JavaScript ritardato da un plugin di ottimizzazione prolunga quel momento; vedi l'ottimizzazione JavaScript e il filtro. Con qualsiasi skin diversa da nessuna (none), nascondi gli input finché la skin non li avvolge:

/* Only with a skin other than "none": hide inputs until the skin wraps them */
.woof .woof_list li > input.woof_checkbox_term,
.woof .woof_list li > input.woof_radio_term {
    visibility: hidden;
}

La skin sposta ogni input nel proprio elemento casella, quindi la regola smette di corrispondere non appena la skin è pronta. Con la skin impostata su nessuna (none) nasconderebbe le caselle per sempre, quindi non usarla in quel caso.

Etichette lunghe, spaziatura e pulsanti-etichetta

Il plugin mostra ogni etichetta come blocco in linea accanto alla sua casella. Quando il nome di una categoria o di un attributo è più lungo della riga, l'intera etichetta scende sotto la checkbox. Usa una di queste due soluzioni, a seconda dell'aspetto che vuoi:

/* A: the text starts next to the box and wraps underneath it */
.woof .woof_list label {
    display: inline !important;
}

/* B: the text stays in its own column next to the box */
.woof .woof_list label {
    max-width: calc(100% - 35px);
    vertical-align: top;
}

Adatta 35px alla larghezza delle tue caselle. Per la spaziatura, il plugin assegna a ogni blocco 5 px di padding inferiore e 9 px di margine inferiore, e a ogni etichetta 4 px di padding sopra e sotto:

/* Tighter filter: less space between blocks and between items */
.woof .woof_container {
    margin-bottom: 4px;
    padding-bottom: 0;
}
.woof .woof_list label {
    padding-top: 2px;
    padding-bottom: 2px;
}
.woof .woof_checkbox_count {
    margin-left: 6px;
    color: #888;
}

Per il tipo etichetta (label) (termini come pulsanti), il plugin imposta un riquadro grigio chiaro e uno stato blu per hover e selezione. Larghezze uguali e colori tuoi:

.woof .woof_list_label .woof_label_term {
    min-width: 60px;
}
.woof .woof_list_label li .woof_label_term:hover,
.woof .woof_list_label li .woof_label_term.checked {
    background-color: #1f7a4d;
    border-color: #1f7a4d;
}

Il rientro delle sottocategorie e la loro riduzione sono trattati in alberi di categorie comprimibili.

Titoli: carattere, dimensione e tag del titolo

I titoli dei blocchi sono elementi h4 dentro .woof_container_inner, compreso il titolo del filtro prezzo, quindi ereditano lo stile h4 del tema:

.woof .woof_container_inner h4 {
    font-family: inherit;
    font-size: 15px;
    font-weight: 600;
    text-transform: none;
    margin-bottom: 6px;
}

Per un tag diverso, ad esempio per adattarsi alla gerarchia dei titoli della tua pagina, usa il filtro woof_title_tag. Restituisci p o span se i titoli non devono essere affatto intestazioni:

/*
 * HUSKY: print filter block titles as <h3> instead of <h4>.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_title_tag', function ($tag) {
    return 'h3';
});

Le regole scritte per h4 smettono allora di applicarsi: il margine del plugin, gli stili dei titoli degli ID di filtro integrati flat_grey e flat_dark, e il tuo CSS. Riscrivile per il nuovo tag, ad esempio .woof .woof_container_inner h3.

L'intestazione sopra l'intero widget è un'altra cosa. In una barra laterale del tema usa il markup del titolo del widget che il tema definisce per tutti i widget; woof_widget_title_tag (predefinito h3) si applica solo quando il widget viene stampato senza quel markup. Per cambiare i testi dei titoli anziché il loro stile, vedi come rinominare i titoli dei filtri.

Menu a tendina: Nativo, Chosen o SelectWoo

Quando gli stili di un tema entrano in conflitto con i menu a tendina (testo tagliato, tag fuori posto nelle selezioni multiple, colori sbagliati), cambia Skin del menu a tendina (Drop-down skin) prima di scrivere CSS. Ogni skin è una libreria diversa, e il conflitto spesso sparisce con un'altra. Gli snippet che usano il filtro woof_use_chosen non cambiano più nulla; decide l'impostazione.

  • Nativo: il select del browser, stilizzato dal tuo tema. Usa come bersaglio .woof select.woof_select.
  • Chosen: la casella è .chosen-container con .chosen-single (singola) o .chosen-choices (multipla), e l'elenco aperto .chosen-results li si trova dentro il filtro, quindi .woof delimita tutto.
  • SelectWoo: la casella è .select2-container dentro il filtro, ma l'elenco aperto è collegato in fondo alla pagina. Le regole per .select2-dropdown non possono essere delimitate con .woof e influenzano anche altri campi SelectWoo, come il campo del paese al checkout.
/* Chosen: closed box and open list */
.woof .chosen-container-single .chosen-single {
    text-align: left;
    background: #fff;
    border-color: #ccc;
    border-radius: 4px;
}
.woof .chosen-container .chosen-results li {
    font-size: 15px;
    color: #222;
}

Tooltip

L'icona info accanto al titolo di un blocco apre al clic il testo dell'opzione Tooltip del blocco. Usa la libreria Tooltipster con il tema noir:

.tooltipster-sidetip.tooltipster-noir .tooltipster-box {
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 6px;
}
.tooltipster-sidetip.tooltipster-noir .tooltipster-content {
    color: #333;
    font-size: 14px;
}

Riquadri di tooltip vuoti, o tooltip altrove nel sito che diventano quadrati grigi, indicano che un altro script nella pagina usa la stessa libreria di tooltip o una in conflitto (segnalato con il tema Flatsome e con plugin di badge dei prodotti). Imposta Usa il tooltip (Use tooltip) su No nella scheda Design; le icone info scompaiono allora dal filtro.

I nomi che compaiono sopra le campionature di colori e immagini sono semplice CSS (p.woof_tooltip span.woof_tooltip_data). Se uno di questi nomi copre la campionatura vicina e ne intercetta i clic, lascia che i clic lo attraversino:

.woof p.woof_tooltip span.woof_tooltip_data {
    pointer-events: none;
}

Conflitti con i temi: caselle doppie, cancelletti e allineamento

Molti temi stilizzano ogni elenco, etichetta e casella di controllo della pagina, filtro compreso. Ispeziona l'elemento anomalo per trovare la regola del tema, poi disattivala soltanto dentro .woof.

  • Due caselle per elemento. Il tema disegna la propria checkbox con uno pseudo-elemento sulle etichette. Gli elenchi di HUSKY non usano pseudo-elementi, quindi è sicuro eliminarli lì:
    .woof .woof_list label::before,
    .woof .woof_list label::after {
        display: none !important;
    }
  • Cancelletti, frecce o icone prima degli elementi. Una regola del tema per gli elenchi dei widget aggiunge contenuto prima di ogni li:
    .woof .woof_list li::before {
        content: none !important;
    }
  • Un punto elenco accanto all'intero widget. Il tema stampa i widget come elementi di elenco: li.WOOF_Widget { list-style: none; }.
  • Campi centrati o tagliati. body .woof .woof_redraw_zone { text-align: left; } corregge il testo centrato dal tema; il contenuto tagliato al bordo della barra laterale di solito deriva da overflow: hidden sul widget, quindi imposta .widget.WOOF_Widget { overflow: visible; }.
  • Caselle di controllo invisibili. Una regola del tema nasconde gli input o le caselle della skin; prova prima un'altra skin, poi cerca la regola nell'inspector.

Per stili diversi su mobile o mentre è in corso una ricerca, vedi CSS per dispositivo e stilizzare la pagina durante il filtraggio.

Checklist

  • Skin, skin del menu a tendina e tooltip scelti nella scheda Design prima di scrivere CSS.
  • CSS in Codice CSS personalizzato (Custom CSS code) o nel tema, mai nella cartella del plugin; regole semplici, senza escape.
  • Ogni regola inizia con .woof o con una classe .woof_sid_.
  • Skin nessuna (none) più accent-color per i colori del brand; niente ridimensionamento delle skin a sprite.
  • Dopo una modifica con woof_title_tag, regole per h4 riscritte.
  • Cache e ottimizzazione CSS svuotate prima di giudicare il risultato.

Per un layout specifico che queste regole non coprono, pubblica il link della pagina e una descrizione dell'aspetto desiderato nel forum di supporto di HUSKY; le FAQ sulle piccole personalizzazioni CSS spiegano cosa includere.