HUSKY - WooCommerce Product Filter Professional

Personnalisation CSS du filtre de produits WooCommerce : habillages et correctifs

La personnalisation CSS du filtre de produits WooCommerce commence généralement par un petit souhait : des cases à cocher aux couleurs de la marque, des titres plus petits, une liste déroulante assortie au thème, ou la correction d’un thème qui dessine une seconde case à côté de chaque case à cocher. HUSKY couvre une partie de ces besoins par des réglages, et le reste demande quelques lignes de CSS, une fois que vous savez où les placer et quelles classes cibler. Ce guide donne les deux, ainsi que les solutions aux conflits de thème que nous rencontrons le plus souvent.

D’abord les réglages, ensuite le CSS

L’onglet Design (WooCommerce → Réglages → Products Filter → Design) modifie l’apparence sans code :

  • Habillage des boutons radio et des cases à cocher (Radio and checkboxes skin) : les habillages plat, minimal et carré en dix couleurs, ou aucun (none) pour les cases natives du navigateur.
  • Habillage des listes déroulantes (Drop-down skin) : Natif (Native), Chosen ou SelectWoo.
  • Habillage du curseur de plage (Range-slider skin) pour l’ion range-slider, Utiliser l’infobulle (Use tooltip) et Icône d’infobulle (Tooltip icon), les images de bascule et plus/moins, ainsi que la superposition de chargement.

Tout le reste va dans Avancé (Advanced) → Code → CSS personnalisé (Custom CSS code). HUSKY affiche ce code juste après sa propre feuille de style sur chaque page où il se charge, et le conserve dans ses réglages ; les mises à jour du plugin n’y touchent donc pas. Collez uniquement des règles CSS simples : les balises HTML comme <style> sont supprimées à l’enregistrement des réglages, et les barres obliques inverses ne sont pas conservées de façon fiable ; écrivez donc directement le symbole (content: "✓") au lieu d’un échappement CSS comme \2713. Le CSS additionnel (Additional CSS) du thème dans l’outil Personnaliser ou la feuille de style d’un thème enfant fonctionne tout aussi bien. Ne modifiez jamais le fichier css/front.css du plugin : la prochaine mise à jour le remplace.

Lien du fichier de styles CSS front personnalisé (Custom front css styles file link), à la fin de l’onglet Design, est un outil différent. Il charge votre fichier à la place de front.css, et non en plus, utilisez-le donc uniquement pour une réécriture complète qui part d’une copie du fichier du plugin.

Faire en sorte que vos règles l’emportent

Les feuilles de style des thèmes se chargent souvent après le plugin et utilisent de longs sélecteurs, et quelques règles du plugin portent !important. Commencez chaque règle par .woof, ou par body .woof si le thème l’emporte encore, et n’ajoutez !important que là où le plugin ou le thème l’utilise déjà. Pour styliser un filtre sans toucher aux autres, donnez-lui un identifiant avec l’attribut sid : [woof sid="sidebar"] ajoute la classe woof_sid_sidebar au formulaire. Gardez un identifiant d’un seul mot, sans espaces. Trois identifiants disposent de styles prêts à l’emploi dans la feuille de style du plugin : flat_grey, flat_dark et flat_white. Le widget utilise toujours woof_sid_widget. Le filtre automatique placé au-dessus des produits prend ses classes dans le réglage de son habillage : woof_sid_auto_shortcode avec l’habillage Par défaut (Default), et woof_sid_flat_grey plus woof_auto_2_columns avec l’habillage gris plat sur lequel démarre une nouvelle installation ; inspectez le formulaire pour voir lequel est utilisé sur votre site.

La carte des classes

ÉlémentSélecteur
Formulaire complet du filtre.woof, .woof_sid_<sid>
Un bloc de filtre.woof_container, par type .woof_container_checkbox, .woof_container_radio, .woof_container_select ; par taxonomie .woof_container_product_cat, .woof_container_pa_color
Titre du bloc.woof_container_inner h4
Liste et éléments.woof_list, .woof_list li ; sous-catégories .woof_childs_list
Case à cocher, libellé, compteurinput.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count ; sélectionné .woof_checkbox_label_selected
Bouton radio et libelléinput.woof_radio_term, .woof_radio_label
Boutons-libellés.woof_list_label .woof_label_term, sélectionné .woof_label_term.checked
Liste déroulante nativeselect.woof_select
Boutons Filtrer et Réinitialiser.woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form

L’inspecteur du navigateur (clic droit sur un élément, Inspecter (Inspect)) montre les classes exactes de votre filtre et la règle qui l’emporte. Le CSS utilisé sur le site de démonstration est une bonne source d’exemples prêts à l’emploi.

Cases à cocher et boutons radio : couleur, taille et netteté

Les habillages plat, minimal et carré dessinent chaque case à partir d’un petit sprite d’images : une seule image contient côte à côte les états non coché, coché et désactivé, et le CSS en affiche la bonne partie. Deux conséquences : le CSS ne peut pas recolorer la case, et modifier sa width, sa height ou son échelle fait apparaître les états voisins ou la rend floue et pixellisée. Choisissez la couleur d’habillage la plus proche de votre design, ou passez aux cases du navigateur.

Pour une couleur de marque ou une case plus grande, réglez Habillage des boutons radio et des cases à cocher (Radio and checkboxes skin) sur aucun (none) et stylisez les champs natifs. accent-color les colore dans tous les navigateurs actuels :

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

Si les cases gardent l’aspect du thème après cela, c’est que le thème restylise toutes les cases à cocher du site ; voir la section sur les conflits de thème plus bas. Si vous gardez un habillage, vous pouvez toujours remplacer son sprite par une copie recolorée de la même disposition (les images se trouvent dans le dossier js/icheck/skins/ du plugin) au moyen d’une règle background-image sur la classe de l’habillage, par exemple .woof .icheckbox_flat-blue. Pour des éléments entièrement personnalisés sans CSS, l’extension Smart Designer crée dans l’administration des designs de cases à cocher, de boutons radio et d’interrupteurs ; voir comment créer votre propre élément de filtre.

Des cases simples clignotent avant l’apparition de l’habillage

Les habillages sont appliqués par JavaScript après le chargement de la page ; pendant un instant, les cases natives du navigateur sont donc visibles. Un JavaScript différé par un plugin d’optimisation prolonge cet instant ; voir l’optimisation JavaScript et le filtre. Avec n’importe quel habillage autre que aucun (none), masquez les champs jusqu’à ce que l’habillage les enveloppe :

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

L’habillage déplace chaque champ dans son propre élément de case, de sorte que la règle cesse de s’appliquer dès que l’habillage est prêt. Avec l’habillage réglé sur aucun (none), elle masquerait définitivement les cases ; ne l’utilisez donc pas dans ce cas.

Libellés longs, espacement et boutons-libellés

Le plugin affiche chaque libellé comme un bloc en ligne à côté de sa case. Lorsque le nom d’une catégorie ou d’un attribut est plus long que la ligne, tout le libellé passe sous la case à cocher. Utilisez l’une de ces deux solutions, selon l’aspect souhaité :

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

Adaptez 35px à la largeur de vos cases. Pour l’espacement, le plugin donne à chaque bloc 5 px de marge intérieure en bas et 9 px de marge extérieure en bas, et à chaque libellé 4 px de marge intérieure au-dessus et en dessous :

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

Pour le type label (termes sous forme de boutons), le plugin définit une case gris clair et un état bleu au survol et à la sélection. Pour des largeurs égales et vos propres couleurs :

.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;
}

L’indentation et le repli des sous-catégories sont traités dans les arborescences de catégories repliables.

Titres : police, taille et balise de titre

Les titres de blocs sont des éléments h4 à l’intérieur de .woof_container_inner, y compris le titre du filtre de prix ; ils héritent donc du style h4 du thème :

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

Pour une autre balise, par exemple pour s’adapter à la hiérarchie des titres de votre page, utilisez le filtre woof_title_tag. Renvoyez p ou span si les titres ne doivent pas être des titres du tout :

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

Les règles écrites pour h4 cessent alors de s’appliquer : la marge du plugin lui-même, les styles de titre des identifiants de filtre intégrés flat_grey et flat_dark, et votre propre CSS. Réécrivez-les pour la nouvelle balise, par exemple .woof .woof_container_inner h3.

Le titre situé au-dessus de l’ensemble du widget est différent. Dans la barre latérale d’un thème, il utilise le balisage de titre de widget que le thème définit pour tous les widgets ; woof_widget_title_tag (par défaut h3) ne s’applique que lorsque le widget est affiché sans ce balisage. Pour modifier le texte des titres plutôt que leur style, voir comment renommer les titres des filtres.

Listes déroulantes : Natif, Chosen ou SelectWoo

Lorsque les styles d’un thème entrent en conflit avec les listes déroulantes (texte coupé, étiquettes mal placées dans les listes à sélection multiple, couleurs incorrectes), changez Habillage des listes déroulantes (Drop-down skin) avant d’écrire du CSS. Chaque habillage correspond à une bibliothèque différente, et le conflit disparaît souvent avec une autre. Les extraits qui utilisent le filtre woof_use_chosen ne changent plus rien ; c’est le réglage qui décide.

  • Natif : le select du navigateur, stylisé par votre thème. Ciblez .woof select.woof_select.
  • Chosen : la boîte est .chosen-container avec .chosen-single (simple) ou .chosen-choices (multiple), et la liste ouverte .chosen-results li se trouve à l’intérieur du filtre ; .woof délimite donc l’ensemble.
  • SelectWoo : la boîte est .select2-container à l’intérieur du filtre, mais la liste ouverte est rattachée à la fin de la page. Les règles pour .select2-dropdown ne peuvent pas être délimitées avec .woof et affectent aussi d’autres champs SelectWoo, comme le champ pays à la commande.
/* 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;
}

Infobulles

L’icône d’information à côté du titre d’un bloc ouvre, au clic, le texte de l’option Infobulle (Tooltip) du bloc. Elle utilise la bibliothèque Tooltipster avec son thème 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;
}

Des boîtes d’infobulle vides, ou des infobulles ailleurs sur le site qui se transforment en carrés gris, signifient qu’un autre script de la page utilise la même bibliothèque d’infobulles ou une bibliothèque en conflit (signalé avec le thème Flatsome et avec des plugins de badges produit). Réglez Utiliser l’infobulle (Use tooltip) sur Non (No) dans l’onglet Design ; les icônes d’information disparaissent alors du filtre.

Les noms qui apparaissent au-dessus des pastilles de couleur et d’image sont du simple CSS (p.woof_tooltip span.woof_tooltip_data). Si un tel nom recouvre la pastille voisine et intercepte ses clics, laissez les clics le traverser :

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

Conflits de thème : doubles cases, croisillons et alignement

De nombreux thèmes stylisent toutes les listes, tous les libellés et toutes les cases à cocher de la page, filtre compris. Inspectez l’élément parasite pour trouver la règle du thème, puis désactivez-la uniquement à l’intérieur de .woof.

  • Deux cases par élément. Le thème dessine sa propre case à cocher avec un pseudo-élément sur les libellés. Les listes de HUSKY n’utilisent pas de pseudo-éléments, il est donc sans risque de les supprimer ici :
    .woof .woof_list label::before,
    .woof .woof_list label::after {
        display: none !important;
    }
  • Croisillons, flèches ou icônes avant les éléments. Une règle du thème pour les listes de widgets ajoute du contenu avant chaque li :
    .woof .woof_list li::before {
        content: none !important;
    }
  • Une puce à côté de l’ensemble du widget. Le thème affiche les widgets comme des éléments de liste : li.WOOF_Widget { list-style: none; }.
  • Champs centrés ou coupés. body .woof .woof_redraw_zone { text-align: left; } corrige le texte centré par le thème ; un contenu coupé au bord de la barre latérale vient généralement de overflow: hidden sur le widget, définissez donc .widget.WOOF_Widget { overflow: visible; }.
  • Cases à cocher invisibles. Une règle du thème masque les champs ou les cases de l’habillage ; essayez d’abord un autre habillage, puis cherchez la règle dans l’inspecteur.

Pour des styles différents sur mobile ou pendant qu’une recherche est en cours, voir le CSS selon l’appareil et styliser la page pendant le filtrage.

Liste de contrôle

  • Habillage, habillage des listes déroulantes et infobulles choisis dans l’onglet Design avant d’écrire du CSS.
  • CSS dans CSS personnalisé (Custom CSS code) ou dans le thème, jamais dans le dossier du plugin ; règles simples, sans échappements.
  • Chaque règle commence par .woof ou par une classe .woof_sid_.
  • Habillage aucun (none) plus accent-color pour les couleurs de marque ; pas de redimensionnement des habillages à sprite.
  • Après un changement de woof_title_tag, règles pour h4 réécrites.
  • Caches et optimisation CSS vidés avant de juger le résultat.

Pour une mise en page précise que ces règles ne couvrent pas, publiez le lien de la page et une description de l’aspect souhaité sur le forum d’assistance de HUSKY ; la FAQ sur les petites personnalisations CSS explique ce qu’il faut indiquer.