HUSKY - WooCommerce Product Filter Professional

Traduire les libellés du filtre de produits WooCommerce : Polylang, WPML, Loco

Sur une boutique multilingue, le filtre de produits reste souvent à moitié traduit : les noms de couleurs changent de langue, mais les titres de blocs, le bouton Filtrer (Filter) ou Tout effacer (Clear All) restent dans la langue d’origine. Le filtre affiche des textes issus de plusieurs sources, et chacune se traduit à un endroit différent. Ce guide montre comment traduire les libellés du filtre de produits WooCommerce avec Polylang, WPML ou Loco Translate, source par source, avec la syntaxe exacte attendue par le plugin.

D’où vient chaque texte du filtre

Texte dans le filtreOrigineOù le traduire
Noms de termes : catégories, couleurs, taillesTermes WordPressVotre plugin multilingue, comme n’importe quel terme de catégorie ou d’attribut
Titres de blocs sans libellé personnaliséLe nom de la taxonomie, pour les attributs « Product Color » et ainsi de suiteVotre plugin multilingue, ou mieux, un libellé personnalisé (voir plus bas)
Textes saisis dans les réglages du filtre : libellés personnalisés, textes des boutons, textes d’exemple (placeholders), textes de dépliage et Afficher plus (Show more), infobulles, titres et options des filtres de métadonnées, titres de sectionsRéglages de HUSKYTraductions des libellés de taxonomies WPML (WPML taxonomies labels translations) dans Avancé (Advanced) → Code
Chaînes d’interface intégrées : Filtrer (Filter), Réinitialiser (Reset), Tout effacer (Clear All), fourchette de prix (price range), En stock (In stock), Afficher le formulaire de filtre des produits (Show products filter form)Domaine de texte woocommerce-products-filterWPML String Translation, Loco Translate ou fichiers .po/.mo
Titre du widget de filtreLe widget WordPressTraduction des widgets de votre plugin multilingue

La plupart des tentatives échouent parce que le texte est traduit au mauvais endroit, par exemple un titre d’attribut dans Loco Translate, ou un libellé personnalisé dans WPML String Translation, où le plugin ne l’enregistre jamais.

Traduire les libellés du filtre de produits WooCommerce avec Polylang ou WPML

Les titres du filtre et tous les textes saisis dans les réglages du plugin se traduisent grâce à une seule table de correspondance. Elle fonctionne de la même façon pour WPML et Polylang ; le champ n’apparaît que si l’un des deux est actif.

  1. Donnez au bloc un original fixe. Dans l’onglet Structure, cliquez sur la roue dentée (options supplémentaires (additional options)) à côté de la taxonomie et renseignez Libellé personnalisé de la taxonomie (Taxonomy custom label), par exemple Color. Sans libellé personnalisé, l’original est le nom de la taxonomie que WordPress renvoie dans la langue courante. Pour les attributs, WooCommerce le construit sous la forme « Product Color », et un plugin de traduction peut déjà l’avoir modifié : une ligne écrite pour une forme ne correspond donc pas dans une autre langue.
  2. Ouvrez Avancé (Advanced) → Code → Traductions des libellés de taxonomies WPML (WPML taxonomies labels translations) et ajoutez une ligne par libellé et par langue : la langue, deux-points, le texte d’origine, accent circonflexe, la traduction.
  3. Utilisez le bon code de langue. Avec WPML, c’est le code de langue WPML (fr, de, pt-br). Avec Polylang, c’est la locale de la langue (fr_FR, en_GB, uk), telle qu’elle apparaît dans la colonne Paramètres régionaux (Locale) de la liste des langues de Polylang. Utiliser en sur un site Polylang qui fonctionne en en_GB est la cause la plus fréquente d’un changement qui ne se produit pas.
  4. Enregistrez, videz le cache des pages, puis vérifiez la page dans l’autre langue.

Pour une boutique en anglais avec le français et l’allemand, sous WPML :

fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe

La même chose sous Polylang :

fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe

La langue par défaut n’a besoin d’aucune ligne : sans correspondance, l’original s’affiche.

Comment la correspondance est établie

  • L’original doit être le texte que le bloc afficherait sans traduction : le libellé personnalisé, ou le nom de la taxonomie s’il n’y en a pas. Les espaces en début et en fin de texte et la casse n’ont pas d’importance, et les libellés dans n’importe quelle écriture fonctionnent.
  • Chaque ligne exige le préfixe de langue. Une ligne comme Containertyp^Container type est ignorée.
  • L’original peut contenir un deux-points, mais pas d’accent circonflexe : le premier ^ le termine.
  • C’est une table, pas un réglage par champ. Une seule ligne traduit ce texte partout où il passe par le filtre : titre du bloc, titre dans le panneau des filtres sélectionnés, bouton ou texte d’exemple.

La même table traduit les textes que vous avez saisis dans les réglages : Texte du bouton Filtrer (Filter button text) et Texte du bouton Réinitialiser (Reset button text), le titre du filtre de prix, les textes d’exemple des recherches par texte, par référence (SKU) et par auteur, les textes de dépliage, les textes Afficher plus (Show more) et Afficher moins (Show less), les infobulles, les titres et options des filtres de métadonnées et ACF, ainsi que les titres de sections. Écrivez la ligne avec exactement le texte que vous avez saisi, par exemple fr:Sort by price^Trier par prix.

Un effet secondaire compte pour le CSS personnalisé : chaque bloc reçoit aussi une classe construite à partir de son titre affiché, donc woof_container_couleur sur la page française et woof_container_color sur la page anglaise. Stylez les blocs avec la classe construite à partir du slug de la taxonomie, comme .woof_container_pa_color, qui est identique dans toutes les langues.

Chaînes d’interface : Loco Translate, WPML String Translation et fichiers .po

Les textes intégrés au plugin sont des chaînes WordPress ordinaires du domaine de texte woocommerce-products-filter. Deux réglages les concernent : Texte du bouton Filtrer (Filter button text) et Texte du bouton Réinitialiser (Reset button text). Quand ces champs sont vides, les boutons utilisent les valeurs traduisibles par défaut Filtrer (Filter) et Réinitialiser (Reset) ; dès que vous saisissez votre propre texte, il devient un texte de réglages et va dans la table de correspondance ci-dessus.

WPML. Analysez le plugin dans WPML → Localisation des thèmes et des plugins (Theme and plugins localization), puis traduisez les chaînes du domaine woocommerce-products-filter dans String Translation.

Loco Translate, aussi le choix habituel avec Polylang, dont la liste de chaînes n’inclut pas celles des plugins :

  1. Allez dans Loco Translate → Extensions (Plugins), ouvrez HUSKY et ajoutez une nouvelle langue.
  2. Choisissez l’emplacement Personnalisé (Custom) ou Système (System), pas le dossier languages du plugin lui-même. Les mises à jour du plugin remplacent ce dossier, et dans la version 3.4.6 le plugin n’y charge pas les fichiers de traduction.
  3. Avant la synchronisation, ouvrez Loco Translate → Réglages (Settings) et portez Ignorer les fichiers PHP plus grands que (Skip PHP files larger than) à 200 Ko au moins. Le fichier principal du plugin pèse environ 145 Ko et contient des chaînes comme Tout effacer (Clear All), fourchette de prix (price range), les noms des tris dans le panneau des filtres sélectionnés et Afficher le formulaire de filtre des produits (Show products filter form). Avec la limite par défaut de 100 Ko, Loco ignore le fichier, ces chaînes manquent, et une synchronisation les supprime d’une traduction existante.
  4. Synchronisez, traduisez, enregistrez. Loco compile le fichier .mo à côté du fichier .po.

Des fichiers de traduction prêts à l’emploi pour de nombreuses langues se trouvent sur la page des traductions. Quel que soit l’outil, le nom du fichier doit se terminer par la locale exacte de votre site, par exemple woocommerce-products-filter-de_DE.mo, et le fichier doit se trouver dans wp-content/languages/plugins/ ou dans le dossier personnalisé de Loco. La FAQ travailler avec WPML donne la version courte de la syntaxe de la table.

Chaînes individuelles par hook, langue par langue

Certains textes sont plus simples à définir dans le code, surtout lorsqu’un même texte doit varier selon la langue. Ces hooks existent dans la version 3.4.6 :

  • woof_filter_title : reçoit chaque texte qui passe par la table de correspondance, après la table, et peut donc modifier n’importe quel titre de bloc, bouton ou texte d’exemple.
  • woof_clear_all_text : le lien Tout effacer (Clear All) du panneau des filtres sélectionnés.
  • woof_start_filtering_btn_txt : le bouton Afficher le formulaire de filtre des produits (Show products filter form).
  • woof_ext_custom_title_by_instock, woof_ext_custom_title_by_onsales, woof_ext_custom_title_by_featured, woof_ext_custom_title_by_backorder : libellés des cases à cocher En stock, En promotion, Mis en avant et Sur commande.
/*
 * Product filter: per-language texts set in code.
 * Child theme functions.php or a code snippets plugin.
 */
function my_filter_lang() {
    if (function_exists('pll_current_language')) {
        return pll_current_language(); // Polylang: language slug, e.g. "fr"
    }
    return apply_filters('wpml_current_language', null); // WPML: language code
}

add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
    $texts = array(
        'en' => array('Formations' => 'Bands'),
        'de' => array('Formations' => 'Besetzungen'),
    );
    return $texts[my_filter_lang()][$title] ?? $title;
}, 10, 3);

add_filter('woof_clear_all_text', function ($text) {
    return my_filter_lang() === 'fr' ? 'Tout effacer' : $text;
});

Notez que la langue est ici le slug de Polylang (fr), et non la locale utilisée dans la table de correspondance.

Termes, ordre des termes et pastilles dans les autres langues

Le filtre affiche les termes de la langue courante que renvoie WordPress. Si une valeur apparaît dans la langue d’origine, c’est que le terme lui-même n’est pas encore traduit : traduisez-le dans WPML (les attributs via WooCommerce Multilingual) ou dans Polylang. S’il est traduit mais affiche toujours l’ancien nom, videz le cache des pages et le Cache des termes (Cache terms) du plugin avec le bouton vider le cache des termes (clear terms cache) dans Avancé (Advanced) → Options.

Les termes traduits sont des termes distincts, avec leur propre ordre. Pour conserver l’ordre de la langue par défaut, ouvrez la liste des termes (Produits (Products) → Catégories (Categories), ou Produits (Products) → Attributs (Attributes) → Configurer les termes (Configure terms)), changez la langue de l’administration et réorganisez les termes. Les couleurs et les images des types Color et Image ne doivent être définies que sur les termes de la langue par défaut : un terme traduit sans couleur ni image propre utilise ceux de son original.

Liste de contrôle

  • Chaque bloc dont le titre doit être traduit a un Libellé personnalisé de la taxonomie (Taxonomy custom label), et les lignes de Traductions des libellés de taxonomies WPML (WPML taxonomies labels translations) reprennent exactement ce libellé.
  • Le préfixe de langue est le code de langue WPML avec WPML et la locale complète avec Polylang.
  • Les textes saisis dans les champs de réglages figurent dans la table de correspondance ; les chaînes intégrées sont traduites dans le domaine woocommerce-products-filter.
  • Les fichiers Loco sont à l’emplacement Personnalisé ou Système, et la limite de taille PHP a été relevée avant la synchronisation.
  • Le CSS personnalisé cible les blocs par le slug de la taxonomie, et non par le titre.
  • Le cache des pages et le cache des termes ont été vidés avant de tester la seconde langue.

Si un libellé refuse toujours de changer, ouvrez un sujet sur le forum d’assistance de HUSKY avec un lien vers la page dans la seconde langue, le plugin de traduction utilisé et les lignes que vous avez ajoutées.