HUSKY - WooCommerce Product Filter Professional

Supprimer le préfixe Product et renommer les titres du filtre WooCommerce

Product Color, Product Size, Product Material : quand chaque bloc d’attribut du filtre de votre boutique commence par le même mot, le filtre ne fait qu’afficher le nom que WooCommerce a donné à l’attribut. Pour supprimer le préfixe Product des titres du filtre WooCommerce, vous donnez au bloc un titre personnalisé, soit un par un dans les réglages du filtre, soit pour tous les attributs d’un coup avec quelques lignes de code. Les mêmes endroits contrôlent les autres textes du filtre : les titres de blocs, la première option d’une liste déroulante, Tout effacer (Clear All), Réinitialiser (Reset), Filtrer (Filter), Afficher plus (Show more) et même les noms de termes individuels. Tous peuvent être modifiés sans toucher aux fichiers du plugin.

D’où vient chaque texte du filtre

HUSKY ne stocke pas de nom propre pour une taxonomie. Il demande à WordPress le nom au pluriel de la taxonomie et l’affiche, sauf si vous définissez un libellé personnalisé. WooCommerce enregistre chaque attribut global avec le nom au pluriel Product %s : l’attribut Couleur (Color) devient donc une taxonomie appelée « Product Color », alors que son nom au singulier reste « Color ». Les catégories et les étiquettes fonctionnent de la même façon : leurs noms au pluriel sont « Product categories » et « Product tags ». Le tableau montre l’origine de chaque texte visible et l’endroit où le modifier.

Texte sur la pageOrigineOù le modifier
Titre au-dessus de tout le filtre (« HUSKY Filter »)Le titre du widgetLe champ Titre (Title) du widget
Titre d’un bloc (Product Color, Product categories)Le nom de la taxonomieLibellé personnalisé de la taxonomie (Taxonomy custom label), ou le hook woof_filter_title
Première option d’une liste déroulanteLe même nom de taxonomieLe titre du bloc, ou une copie du modèle de liste déroulante
Titre du filtre de prixLe Texte du titre (Title text) du filtre de prixOptions supplémentaires de Recherche par prix (Search by Price)
En stock (In stock), En promotion (On sale), Produits mis en avant (Featured products)Textes des extensionsLes hooks woof_ext_custom_title_*
Tout effacer (Clear All) dans le panneau des filtres actifsChaîne du pluginLe hook woof_clear_all_text
Boutons Filtrer (Filter) et Réinitialiser (Reset), libellé orderbyChaînes et options du pluginL’onglet Options, ou une traduction
Afficher plus (Show more) / Afficher moins (Show less), Ouvrir le filtre (Open filter) / Fermer le filtre (Close filter) sur mobileOptions de l’onglet DesignL’onglet Design
Nom d’un terme individuelLe terme lui-mêmeLe hook woof_sort_terms_before_out

Supprimer le préfixe Product des titres du filtre WooCommerce

Il existe trois méthodes, de l’effet le plus ciblé au plus large. Choisissez-en une ; vous n’avez pas besoin de toutes.

Un bloc à la fois : Libellé personnalisé de la taxonomie

  1. Ouvrez WooCommerce > Réglages > Products Filter (WooCommerce > Settings > Products Filter), onglet Structure.
  2. Dans la ligne de l’attribut (par exemple pa_color), cliquez sur l’icône d’engrenage, options supplémentaires (additional options).
  3. Saisissez le titre voulu dans Libellé personnalisé de la taxonomie (Taxonomy custom label), par exemple Color. Laissez le champ vide pour revenir au nom WooCommerce.
  4. Cliquez sur Appliquer (Apply) dans la fenêtre, puis sur Enregistrer les modifications (Save changes) en bas de la page de réglages.

Le libellé personnalisé remplace le nom de la taxonomie partout où le filtre l’utilise : le titre du bloc, la première option d’une liste déroulante, le texte d’exemple (placeholder) d’une liste à choix multiples et le libellé de la valeur sélectionnée dans le panneau des filtres actifs. C’est aussi ainsi que vous renommez « Product categories » en « Catégories » ou « Acheter par type », ou que vous donnez un autre titre à une taxonomie de marques. Pour une liste déroulante hiérarchique, le même champ contient les titres de chaque niveau ; le guide du filtre année, marque et modèle explique ce format.

Tous les attributs d’un coup : le hook woof_filter_title

Avec vingt attributs, saisir un libellé pour chacun est fastidieux, et chaque nouvel attribut demande de recommencer. Chaque titre de bloc du filtre passe par le hook woof_filter_title : un seul extrait de code peut donc remplacer le nom « Product ... » de chaque attribut par son nom au singulier :

/*
 * HUSKY: show "Color" instead of "Product Color" in attribute filter titles.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
    if (is_object($taxonomy_info)
        && isset($taxonomy_info->name, $taxonomy_info->labels->name, $taxonomy_info->labels->singular_name)
        && 0 === strpos($taxonomy_info->name, 'pa_')
        && $title === $taxonomy_info->labels->name) {
        // No custom label is set: use the attribute name without the prefix
        return $taxonomy_info->labels->singular_name;
    }
    return $title;
}, 10, 3);

La vérification $title === $taxonomy_info->labels->name préserve tout Libellé personnalisé de la taxonomie (Taxonomy custom label) que vous avez défini : l’extrait ne touche que les titres qui sont encore le nom WooCommerce. Il ne change rien en dehors du filtre. Le hook reçoit aussi certains textes de boutons avec un $taxonomy_info vide, c’est pourquoi l’extrait vérifie d’abord is_object().

Partout sur le site : modifier la chaîne WooCommerce

Si vous voulez faire disparaître le préfixe partout où les noms de taxonomies d’attributs s’affichent, y compris dans d’autres widgets et dans les écrans d’administration, modifiez la chaîne WooCommerce elle-même. Le préfixe vient de _x( 'Product %s', 'Product Attribute', 'woocommerce' ), de sorte qu’un filtre de traduction peut renvoyer le nom seul :

/*
 * Remove the "Product" prefix from WooCommerce attribute names site-wide.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('gettext_with_context', function ($translation, $text, $context, $domain) {
    if ('woocommerce' === $domain && 'Product Attribute' === $context && 'Product %s' === $text) {
        return '%s';
    }
    return $translation;
}, 10, 4);

On obtient le même résultat avec Loco Translate en traduisant Product %s par %s dans le domaine de texte de WooCommerce ; enregistrez le fichier à l’emplacement personnalisé de Loco pour qu’une mise à jour de WooCommerce ne l’écrase pas. Sur un site dans une autre langue, c’est la chaîne traduite (par exemple « Produkt %s ») que vous voyez, mais l’extrait compare le texte anglais d’origine : il fonctionne donc quelle que soit la langue du site.

Un effet secondaire de toute méthode de renommage : chaque bloc reçoit aussi une classe CSS construite à partir de son titre, comme woof_container_productcolor. Après le renommage, elle devient woof_container_color. Si votre CSS personnalisé cible l’ancienne classe, remplacez-la par la classe basée sur le slug, woof_container_pa_color, qui ne change jamais.

Modifier ou masquer le titre du filtre et l’en-tête du widget

Le texte « HUSKY Filter » au-dessus de tout le filtre n’est pas un réglage du plugin : c’est le titre du widget. Ouvrez Apparence > Widgets (Appearance > Widgets) (ou l’éditeur de widgets par blocs), ouvrez le widget HUSKY et modifiez son champ Titre (Title) ou videz-le. Un titre vide n’affiche rien. Un filtre placé avec le shortcode [woof] n’a aucun en-tête de ce genre.

Pour masquer le titre d’un seul bloc, réglez Afficher le libellé du titre (Show title label) sur Non (No) dans ses options supplémentaires. C’est courant pour les listes déroulantes, où la première option indique déjà de quoi il s’agit. Le filtre de prix a son propre champ : ouvrez les options supplémentaires de Recherche par prix (Search by Price) et renseignez Texte du titre (Title text) ; s’il est vide, le bloc de prix n’a pas de titre. Pour un filtre de prix en liste déroulante, Texte du filtre de prix en liste déroulante (Drop-down price filter text), dans la même fenêtre, définit sa première option.

Une taxonomie n’a qu’un seul titre pour toute la boutique. Si une catégorie a besoin d’un titre différent, par exemple « Pointure » sur la catégorie Chaussures, la FAQ sur le libellé par catégorie y répond ; le code le plus simple est une condition à l’intérieur de woof_filter_title :

add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
    if (is_object($taxonomy_info) && 'pa_size' === $taxonomy_info->name && is_product_category('shoes')) {
        return 'Shoe size';
    }
    return $title;
}, 10, 3);

Cela fonctionne quand la page se recharge après chaque changement du filtre. En mode AJAX, le formulaire du filtre est reconstruit par une requête en arrière-plan où is_product_category() est faux : le titre revient donc à sa valeur par défaut après la première sélection.

Modifier le texte d’exemple de la liste déroulante

La première option d’une liste déroulante de taxonomie, celle qui signifie « rien de sélectionné », affiche le même texte que le titre du bloc. Un libellé personnalisé modifie donc les deux. Si vous voulez qu’ils diffèrent, par exemple le titre Couleur (Color) et la première option Toutes les couleurs (Any colour), utilisez une copie du modèle de liste déroulante. Le plugin la charge par le hook woof_html_types_view_select : la copie peut donc se trouver dans votre thème enfant et survit aux mises à jour du plugin.

  1. Copiez wp-content/plugins/woocommerce-products-filter/views/html_types/select.php vers wp-content/themes/your-child-theme/husky/select.php.
  2. Indiquez au plugin d’utiliser la copie :
    /*
     * HUSKY: load the drop-down template from the child theme.
     * Child theme functions.php.
     */
    add_filter('woof_html_types_view_select', function ($path) {
        $custom = get_stylesheet_directory() . '/husky/select.php';
        return file_exists($custom) ? $custom : $path;
    });
  3. Dans la copie, trouvez la ligne <option value="0"> et remplacez-la par votre propre texte. $tax_slug y est disponible : un seul modèle peut donc servir toutes les listes déroulantes :
    <option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>

Les blocs à choix multiples affichent le titre comme texte d’exemple ; leur modèle est views/html_types/mselect.php, chargé de la même façon par woof_html_types_view_mselect. Après une mise à jour du plugin, comparez votre copie avec le nouvel original et reportez les changements éventuels.

Modifier Tout effacer, Réinitialiser, Filtrer et les autres textes intégrés

Les textes propres au plugin se répartissent en trois groupes.

Options. Dans l’onglet Options, Texte du bouton Filtrer (Filter button text) et Texte du bouton Réinitialiser (Reset button text) définissent les deux boutons du formulaire ; écrire none dans Texte du bouton Réinitialiser (Reset button text) masque ce bouton. Dans la version gratuite, les deux champs sont ignorés et les mots par défaut s’affichent ; modifiez-les avec l’extrait de traduction ci-dessous. Dans l’onglet Design, vous trouverez Texte pour le bloc plus/moins ouvert (Text for block more/less opened) et Texte pour le bloc plus/moins fermé (Text for block more/less closed) (par défaut Afficher plus (Show more) et Afficher moins (Show less), utilisés quand un bloc a Nombre de termes non repliés (Not toggled terms count) défini), ainsi que Texte du bouton de filtre mobile (Text for mobile filter button) et Texte pour fermer le filtre mobile (Text to close mobile filter).

Hooks. Tout effacer (Clear All) dans le panneau des filtres actifs a son propre hook woof_clear_all_text, et les extensions à cases à cocher ont les hooks woof_ext_custom_title_* : woof_ext_custom_title_by_instock, _by_onsales, _by_featured, _by_backorder et woof_ext_custom_title_stock_quantity.

/*
 * HUSKY: rename built-in texts. Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_clear_all_text', function ($text) {
    return 'Remove all filters';
});

add_filter('woof_ext_custom_title_by_instock', function ($title) {
    return 'Only products in stock';
});

add_filter('woof_ext_custom_title_by_onsales', function ($title) {
    return 'Discounted products';
});

Le texte Tout effacer (Clear All) est écrit dans une chaîne JavaScript entre guillemets doubles : n’utilisez donc pas de guillemets doubles dedans.

Traduction. Tout le reste, comme les libellés orderby, per page et fourchette de prix (price range) du panneau des filtres actifs et les valeurs de tri comme popularity, est une chaîne traduisible du domaine de texte woocommerce-products-filter. Sur une boutique monolingue, l’outil le plus simple est un filtre gettext avec une liste de chaînes exactes :

/*
 * HUSKY: replace front-end strings. Child theme functions.php or a code snippets plugin.
 */
add_filter('gettext', function ($translation, $text, $domain) {
    if ('woocommerce-products-filter' !== $domain || (is_admin() && ! wp_doing_ajax())) {
        return $translation;
    }
    $texts = array(
        'Filter'     => 'Show products',
        'Reset'      => 'Start over',
        'orderby'    => 'Sort by',
        'popularity' => 'Popularity',
        'rating'     => 'Rating',
    );
    return isset($texts[$text]) ? $texts[$text] : $translation;
}, 20, 3);

Les chaînes doivent correspondre exactement, casse comprise : le texte par défaut du bouton est Clear All, et non « Clear all ». La condition is_admin() laisse les pages de réglages du plugin dans leur formulation d’origine tout en couvrant les requêtes AJAX qui redessinent le filtre. Une chaîne remplacée change partout où le plugin l’affiche : Filter est aussi le bouton du curseur de prix de style WooCommerce et le texte par défaut de l’onglet coulissant. Loco Translate fait la même chose sans code. Traduire le filtre en plusieurs langues est une autre tâche, traitée dans traduire les libellés du filtre avec WPML, Polylang ou Loco Translate.

Renommer un terme uniquement dans le filtre

Parfois, une catégorie ou une valeur d’attribut doit se lire autrement dans le filtre que sur la fiche produit, par exemple un nom de catégorie long qui casse la mise en page de la barre latérale. Chaque liste de termes passe par woof_sort_terms_before_out avant d’être affichée, pour les cases à cocher, les boutons radio, les listes déroulantes, les libellés, les couleurs et les images :

/*
 * HUSKY: show other names for some terms in the filter only.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_sort_terms_before_out', function ($terms, $type) {
    $new_names = array(
        1019 => 'Garden tools',    // term ID => name shown in the filter
        1697 => 'Kids (4-12)',
    );
    foreach ($terms as $key => $term) {
        if (isset($term['term_id'], $new_names[$term['term_id']])) {
            $terms[$key]['name'] = $new_names[$term['term_id']];
        }
    }
    return $terms; // always return the whole array
}, 99, 2);

Trouvez l’ID d’un terme en survolant le terme dans Produits > Catégories (Products > Categories) ou dans l’écran Configurer les termes (Configure terms) de l’attribut : c’est le tag_ID dans le lien. Le hook s’exécute aussi pour les termes enfants : les sous-catégories peuvent donc être renommées de la même façon. La liste est déjà triée quand la priorité 99 s’exécute, de sorte qu’un terme renommé garde la position de son ancien nom. Renvoyez toujours le tableau complet : ne renvoyer que les termes modifiés retire tous les autres du filtre.

Si le nouveau nom n’apparaît pas

  • Non enregistré. Appliquer (Apply) dans la fenêtre des options supplémentaires ne fait que remplir le formulaire ; le libellé n’est stocké que lorsque vous cliquez sur Enregistrer les modifications (Save changes) sur la page de réglages.
  • Cache des termes. Si Cache des termes (Cache terms) est activé sous Avancé > Options (Advanced > Options), le filtre conserve les noms de termes mis en cache. Un terme renommé dans WooCommerce garde son ancien nom jusqu’à ce que vous cliquiez sur vider le cache des termes (clear terms cache) ou que la période de nettoyage automatique expire.
  • Cache des pages. Les pages en cache conservent l’ancien HTML. Purgez le cache de votre plugin de cache, de votre serveur ou de votre CDN, et testez dans une fenêtre de navigation privée.
  • Extrait de code inactif. Assurez-vous que le code se trouve dans le functions.php du thème (enfant) actif ou dans un extrait actif, et que le nom du filtre, le nombre d’arguments et les chaînes sont exactement ceux indiqués ci-dessus.

Si un texte de votre filtre n’est pas couvert ici, posez la question sur le forum d’assistance de HUSKY en indiquant le texte exact et l’endroit où il apparaît.