Traducir etiquetas del filtro de productos WooCommerce: Polylang, WPML, Loco
En una tienda multilingüe, el filtro de productos suele quedar traducido a medias: los nombres de los colores cambian de idioma, pero los títulos de los bloques, el botón Filtro (Filter) o Borrar todo (Clear All) siguen en el idioma original. El filtro muestra textos de varias fuentes y cada una se traduce en un sitio distinto. Esta guía explica cómo traducir las etiquetas del filtro de productos de WooCommerce con Polylang, WPML o Loco Translate, fuente por fuente y con la sintaxis exacta que espera el plugin.
De dónde sale cada texto del filtro
| Texto en el filtro | De dónde sale | Dónde traducirlo |
|---|---|---|
| Nombres de términos: categorías, colores, tallas | Términos de WordPress | Tu plugin multilingüe, como cualquier término de categoría o de atributo |
| Títulos de bloque sin etiqueta personalizada | El nombre de la taxonomía, en los atributos "Product Color" y similares | Tu plugin multilingüe o, mejor, una etiqueta personalizada (más abajo) |
| Textos que escribiste en los ajustes del filtro: etiquetas personalizadas, textos de botones, marcadores de posición, textos de conmutación y de Mostrar más (Show more), tooltips, títulos y opciones de los filtros de meta, títulos de sección | Ajustes de HUSKY | Traducciones de etiquetas de taxonomías WPML (WPML taxonomies labels translations) en Avanzadas (Advanced) → Código (Code) |
| Cadenas de interfaz integradas: Filtro (Filter), Re-inicializar (Reset), Borrar todo (Clear All), rango de precios (price range), En stock (In stock), Mostrar formulario de filtro de productos (Show products filter form) | Dominio de texto woocommerce-products-filter | WPML String Translation, Loco Translate o archivos .po/.mo |
| Título del widget del filtro | El widget de WordPress | Traducción de widgets de tu plugin multilingüe |
La mayoría de los intentos fallidos traducen un texto en el lugar equivocado, por ejemplo el título de un atributo en Loco Translate, o una etiqueta personalizada en WPML String Translation, donde el plugin nunca la registra.
Traducir las etiquetas del filtro de productos de WooCommerce con Polylang o WPML
Los títulos del filtro y todos los textos escritos en los ajustes del plugin se traducen con una única tabla de correspondencias del propio plugin. Funciona igual con WPML y con Polylang; el campo solo aparece cuando uno de los dos está activo.
- Dale al bloque un original fijo. En la pestaña Estructura (Structure) haz clic en el engranaje (opciones adicionales (additional options)) junto a la taxonomía y rellena Taxonomía etiqueta personalizada (Taxonomy custom label), por ejemplo
Color. Sin etiqueta personalizada, el original es el nombre de la taxonomía que WordPress devuelve en el idioma actual. En los atributos, WooCommerce lo construye como "Product Color", y un plugin de traducción puede haberlo cambiado ya, de modo que una línea escrita para una forma no coincide en otro idioma. - Abre Avanzadas (Advanced) → Código (Code) → Traducciones de etiquetas de taxonomías WPML (WPML taxonomies labels translations) y añade una línea por etiqueta e idioma: idioma, dos puntos, texto original, acento circunflejo, traducción.
- Usa el código de idioma correcto. Con WPML es el código de idioma de WPML (
fr,de,pt-br). Con Polylang es el locale del idioma (fr_FR,en_GB,uk), tal como aparece en la columna Locale de la lista de idiomas de Polylang. Usarenen un sitio con Polylang que funciona conen_GBes el motivo más habitual de que no cambie nada. - Guarda, vacía la caché de páginas y comprueba la página en el otro idioma.
Para una tienda en inglés con francés y alemán, con WPML:
fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe
Lo mismo con Polylang:
fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe
El idioma por defecto no necesita líneas: si no hay coincidencia, se muestra el original.
Cómo se hace la coincidencia
- El original debe ser el texto que el bloque mostraría sin traducción: la etiqueta personalizada o, si no hay ninguna, el nombre de la taxonomía. Los espacios en los extremos y las mayúsculas no importan, y las etiquetas funcionan en cualquier alfabeto.
- Cada línea necesita el prefijo de idioma. Una línea como
Containertyp^Container typese ignora. - El original puede contener dos puntos, pero no un acento circunflejo: el primer
^lo termina. - Es una tabla, no un ajuste por campo. Una línea traduce ese texto allí donde pase por el filtro: el título del bloque, el título en el panel de filtros seleccionados, un botón o un marcador de posición.
La misma tabla traduce los textos que escribiste en los ajustes: Texto del botón de filtro (Filter button text) y Texto del botón de reiniciar (Reset button text), el título del filtro de precios, los marcadores de posición de la búsqueda por texto, SKU y autor, los textos de conmutación, los textos Mostrar más (Show more) y Mostrar menos (Show less), los tooltips, los títulos y las opciones de los filtros de meta y de ACF, y los títulos de sección. Escribe la línea con exactamente el texto que introdujiste, por ejemplo fr:Sort by price^Trier par prix.
Hay un efecto secundario que importa para el CSS personalizado: cada bloque recibe también una clase construida a partir de su título mostrado, así que habrá woof_container_couleur en la página francesa y woof_container_color en la inglesa. Da estilo a los bloques mediante la clase construida a partir del slug de la taxonomía, como .woof_container_pa_color, que es la misma en todos los idiomas.
Cadenas de interfaz: Loco Translate, WPML String Translation y archivos .po
Los textos integrados del plugin son cadenas normales de WordPress del dominio de texto woocommerce-products-filter. Dos ajustes les afectan: Texto del botón de filtro (Filter button text) y Texto del botón de reiniciar (Reset button text). Cuando esos campos están vacíos, los botones usan los textos traducibles por defecto Filtro (Filter) y Re-inicializar (Reset); en cuanto escribes tu propio texto, pasa a ser un texto de ajustes y entra en la tabla de correspondencias descrita arriba.
WPML. Analiza el plugin en WPML → Theme and plugins localization y traduce después las cadenas del dominio woocommerce-products-filter en String Translation.
Loco Translate, que también es la opción habitual con Polylang, cuya lista de cadenas no incluye las de los plugins:
- Ve a Loco Translate → Plugins, abre HUSKY y añade un idioma nuevo.
- Elige la ubicación Custom o System, no la carpeta
languagesdel propio plugin. Las actualizaciones del plugin reemplazan esa carpeta y, en la 3.4.6, el plugin no carga archivos de traducción desde ella. - Antes de sincronizar, abre Loco Translate → Configurar (Settings) y sube Skip PHP files larger than a 200 KB como mínimo. El archivo principal del plugin pesa unos 145 KB y contiene cadenas como Borrar todo (Clear All), rango de precios (price range), los nombres de ordenación del panel de filtros seleccionados y Mostrar formulario de filtro de productos (Show products filter form). Con el límite por defecto de 100 KB, Loco omite el archivo, esas cadenas faltan y una sincronización las elimina de una traducción existente.
- Sincroniza, traduce y guarda. Loco compila el archivo .mo junto al archivo .po.
Los archivos de traducción ya preparados para muchos idiomas están en la página de traducciones. Uses la herramienta que uses, el nombre del archivo debe terminar con el locale exacto de tu sitio, por ejemplo woocommerce-products-filter-de_DE.mo, y el archivo debe estar en wp-content/languages/plugins/ o en la carpeta personalizada de Loco. La FAQ trabajar con WPML incluye la versión corta de la sintaxis de la tabla.
Cadenas sueltas con hooks, por idioma
Algunos textos son más fáciles de definir en código, sobre todo cuando el mismo texto debe variar según el idioma. Estos hooks existen en la 3.4.6:
- woof_filter_title: recibe cada texto que pasa por la tabla de correspondencias, después de la tabla, así que puede cambiar cualquier título de bloque, botón o marcador de posición.
- woof_clear_all_text: el enlace Borrar todo (Clear All) del panel de filtros seleccionados.
- woof_start_filtering_btn_txt: el botón Mostrar formulario de filtro de productos (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: etiquetas de las casillas En stock, En oferta, Destacados y pedido pendiente de reposición.
/*
* 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;
});
Ten en cuenta que aquí el idioma es el slug de Polylang (fr), no el locale que se usa en la tabla de correspondencias.
Términos, orden de los términos y muestras en otros idiomas
El filtro muestra los términos del idioma actual que devuelve WordPress. Si un valor aparece en el idioma original, el propio término aún no está traducido: tradúcelo en WPML (los atributos, a través de WooCommerce Multilingual) o en Polylang. Si está traducido y sigue mostrando el nombre antiguo, vacía la caché de páginas y los Términos de la caché (Cache terms) del plugin con el botón limpiar términos de la caché (clear terms cache) en Avanzadas (Advanced) → Opciónes (Options).
Los términos traducidos son términos independientes, con su propio orden. Para conservar el orden del idioma por defecto, abre la lista de términos (Productos (Products) → Categorías (Categories), o Productos (Products) → Atributos (Attributes) → Configurar términos (Configure terms)), cambia el idioma del administrador y vuelve a ordenar los términos. Los colores y las imágenes de los tipos Color e Imagen solo hay que definirlos en los términos del idioma por defecto: un término traducido sin color o imagen propios usa los de su original.
Lista de comprobación
- Cada bloque que necesita un título traducido tiene una Taxonomía etiqueta personalizada (Taxonomy custom label), y las líneas de Traducciones de etiquetas de taxonomías WPML (WPML taxonomies labels translations) repiten esa etiqueta exactamente.
- El prefijo de idioma es el código de idioma de WPML en WPML y el locale completo en Polylang.
- Los textos escritos en los campos de ajustes están en la tabla de correspondencias; las cadenas integradas se traducen en el dominio
woocommerce-products-filter. - Los archivos de Loco están en la ubicación Custom o System, y el límite de tamaño de PHP se subió antes de sincronizar.
- El CSS personalizado apunta a los bloques por el slug de la taxonomía, no por el título.
- La caché de páginas y la caché de términos se vaciaron antes de probar el segundo idioma.
Si una etiqueta sigue sin cambiar, abre un tema en el foro de soporte de HUSKY con un enlace a la página en el segundo idioma, el plugin de traducción que usas y las líneas que añadiste.