HUSKY - WooCommerce Product Filter Professional

Traduzir rótulos do filtro de produtos WooCommerce: Polylang, WPML, Loco

Em uma loja multilíngue, o filtro de produtos costuma ficar meio traduzido: os nomes das cores mudam de idioma, mas os títulos dos blocos, o botão Filtrar (Filter) ou Limpar tudo (Clear All) continuam no original. O filtro exibe textos de várias origens, e cada uma é traduzida em um lugar diferente. Este guia mostra como traduzir os rótulos do filtro de produtos WooCommerce com Polylang, WPML ou Loco Translate, origem por origem, com a sintaxe exata que o plugin espera.

De onde vem cada texto do filtro

Texto no filtroDe onde vemOnde traduzir
Nomes de termos: categorias, cores, tamanhosTermos do WordPressSeu plugin multilíngue, como qualquer termo de categoria ou atributo
Títulos de blocos sem rótulo personalizadoO nome da taxonomia, nos atributos "Product Color" e assim por dianteSeu plugin multilíngue ou, melhor ainda, um rótulo personalizado (abaixo)
Textos digitados nas configurações do filtro: rótulos personalizados, textos de botões, placeholders, textos de alternância e de Mostrar mais (Show more), dicas de ferramenta, títulos e opções dos filtros de meta, títulos de seçõesConfigurações do HUSKYTraduções de rótulos de taxonomias do WPML (WPML taxonomies labels translations) em Avançado (Advanced) → Código (Code)
Strings da interface integradas: Filtrar (Filter), Redefinir (Reset), Limpar tudo (Clear All), faixa de preço (price range), Em estoque (In stock), Mostrar formulário de filtro de produtos (Show products filter form)Domínio de texto woocommerce-products-filterWPML String Translation, Loco Translate ou arquivos .po/.mo
Título do widget do filtroO widget do WordPressTradução de widgets do seu plugin multilíngue

A maioria das tentativas que falham traduz o texto no lugar errado, por exemplo o título de um atributo no Loco Translate, ou um rótulo personalizado no WPML String Translation, onde o plugin nunca o registra.

Traduzir os rótulos do filtro de produtos WooCommerce com Polylang ou WPML

Os títulos do filtro e todos os textos digitados nas configurações do plugin são traduzidos com uma única tabela de consulta no plugin. Ela funciona da mesma forma no WPML e no Polylang; o campo só aparece quando um dos dois está ativo.

  1. Dê ao bloco um original fixo. Na aba Estrutura (Structure), clique na engrenagem (opções adicionais (additional options)) ao lado da taxonomia e preencha Rótulo personalizado da taxonomia (Taxonomy custom label), por exemplo Color. Sem um rótulo personalizado, o original é o nome da taxonomia que o WordPress retorna no idioma atual. Nos atributos, o WooCommerce o monta como "Product Color", e um plugin de tradução pode já tê-lo alterado, de modo que uma linha escrita para uma forma não corresponde à de outro idioma.
  2. Abra Avançado (Advanced) → Código (Code) → Traduções de rótulos de taxonomias do WPML (WPML taxonomies labels translations) e adicione uma linha por rótulo e idioma: idioma, dois-pontos, texto original, circunflexo, tradução.
  3. Use o código de idioma correto. No WPML, é o código de idioma do WPML (fr, de, pt-br). No Polylang, é a localidade do idioma (fr_FR, en_GB, uk), conforme exibido na coluna Localidade (Locale) da lista de idiomas do Polylang. Usar en em um site Polylang que roda en_GB é o motivo mais comum de nada mudar.
  4. Salve, limpe o cache de páginas e verifique a página no outro idioma.

Para uma loja em inglês com francês e alemão, no WPML:

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

O mesmo no Polylang:

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

O idioma padrão não precisa de linhas: sem correspondência, o original é exibido.

Como a consulta faz a correspondência

  • O original deve ser o texto que o bloco exibiria sem tradução: o rótulo personalizado ou, se não houver, o nome da taxonomia. Espaços nas extremidades e maiúsculas/minúsculas não importam, e rótulos em qualquer alfabeto funcionam.
  • Cada linha precisa do prefixo de idioma. Uma linha como Containertyp^Container type é ignorada.
  • O original pode conter dois-pontos, mas não circunflexo: o primeiro ^ o encerra.
  • É uma tabela, não uma configuração por campo. Uma linha traduz aquele texto onde quer que ele passe pelo filtro: o título do bloco, o título no painel de filtros selecionados, um botão ou um placeholder.

A mesma tabela traduz os textos que você digitou nas configurações: Texto do botão Filtrar (Filter button text) e Texto do botão Redefinir (Reset button text), o título do filtro de preço, os placeholders da busca por texto, SKU e autor, os textos de alternância, os textos Mostrar mais (Show more) e Mostrar menos (Show less), as dicas de ferramenta, os títulos e as opções dos filtros de meta e ACF, e os títulos de seções. Escreva a linha com exatamente o texto que você digitou, por exemplo fr:Sort by price^Trier par prix.

Um efeito colateral importa para o CSS personalizado: cada bloco também recebe uma classe construída a partir do título exibido, como woof_container_couleur na página em francês e woof_container_color na em inglês. Estilize os blocos pela classe construída a partir do slug da taxonomia, como .woof_container_pa_color, que é a mesma em todos os idiomas.

Strings da interface: Loco Translate, WPML String Translation e arquivos .po

Os textos integrados do plugin são strings comuns do WordPress no domínio de texto woocommerce-products-filter. Duas configurações os afetam: Texto do botão Filtrar (Filter button text) e Texto do botão Redefinir (Reset button text). Quando esses campos estão vazios, os botões usam os padrões traduzíveis Filtrar (Filter) e Redefinir (Reset); assim que você digita seu próprio texto, ele passa a ser um texto de configurações e vai para a tabela de consulta acima.

WPML. Faça a varredura do plugin em WPML → Localização de temas e plugins (Theme and plugins localization) e depois traduza as strings do domínio woocommerce-products-filter em Tradução de strings (String Translation).

Loco Translate, também a escolha habitual com o Polylang, cuja lista de strings não inclui as strings de plugins:

  1. Vá em Loco Translate → Plugins, abra o HUSKY e adicione um novo idioma.
  2. Escolha o local Personalizado (Custom) ou Sistema (System), não a pasta languages do próprio plugin. As atualizações do plugin substituem essa pasta e, na versão 3.4.6, o plugin não carrega arquivos de tradução dela.
  3. Antes de sincronizar, abra Loco Translate → Configurações (Settings) e aumente Ignorar arquivos PHP maiores que (Skip PHP files larger than) para pelo menos 200 KB. O arquivo principal do plugin tem cerca de 145 KB e contém strings como Limpar tudo (Clear All), faixa de preço (price range), os nomes de ordenação no painel de filtros selecionados e Mostrar formulário de filtro de produtos (Show products filter form). Com o limite padrão de 100 KB, o Loco ignora o arquivo, essas strings ficam ausentes e uma sincronização as remove de uma tradução existente.
  4. Sincronize, traduza, salve. O Loco compila o arquivo .mo ao lado do arquivo .po.

Arquivos de tradução prontos para muitos idiomas estão na página de traduções. Qualquer que seja a ferramenta, o nome do arquivo deve terminar com a localidade exata do seu site, por exemplo woocommerce-products-filter-de_DE.mo, e o arquivo pertence a wp-content/languages/plugins/ ou à pasta personalizada do Loco. O FAQ trabalhando com o WPML traz a versão resumida da sintaxe da tabela.

Strings individuais por hook, por idioma

Alguns textos são mais fáceis de definir em código, principalmente quando o mesmo texto precisa variar conforme o idioma. Estes hooks existem na versão 3.4.6:

  • woof_filter_title: recebe todos os textos que passam pela tabela de consulta, depois da tabela, e por isso pode alterar qualquer título de bloco, botão ou placeholder.
  • woof_clear_all_text: o link Limpar tudo (Clear All) do painel de filtros selecionados.
  • woof_start_filtering_btn_txt: o botão Mostrar formulário de filtro de produtos (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: rótulos das caixas de seleção Em estoque, Em promoção, Destaques e encomenda pendente.
/*
 * 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;
});

Observe que o idioma aqui é o slug do Polylang (fr), e não a localidade usada na tabela de consulta.

Termos, ordem dos termos e amostras em outros idiomas

O filtro exibe os termos do idioma atual que o WordPress retorna. Se um valor aparece no idioma original, o termo em si ainda não foi traduzido: traduza-o no WPML (os atributos pelo WooCommerce Multilingual) ou no Polylang. Se ele está traduzido e ainda mostra o nome antigo, limpe o cache de páginas e o Cache de termos (Cache terms) do plugin com o botão limpar cache de termos (clear terms cache) em Avançado (Advanced) → Opções (Options).

Os termos traduzidos são termos separados, com ordem própria. Para manter a ordem do idioma padrão, abra a lista de termos (Produtos (Products) → Categorias (Categories) ou Produtos (Products) → Atributos (Attributes) → Configurar termos (Configure terms)), troque o idioma do painel e organize os termos novamente. As cores e imagens dos tipos Cor e Imagem só precisam ser definidas nos termos do idioma padrão: um termo traduzido sem cor ou imagem próprias usa as do original.

Lista de verificação

  • Todo bloco que precisa de título traduzido tem um Rótulo personalizado da taxonomia (Taxonomy custom label), e as linhas em Traduções de rótulos de taxonomias do WPML (WPML taxonomies labels translations) repetem esse rótulo exatamente.
  • O prefixo de idioma é o código de idioma do WPML no WPML e a localidade completa no Polylang.
  • Os textos digitados nos campos de configurações estão na tabela de consulta; as strings integradas são traduzidas no domínio woocommerce-products-filter.
  • Os arquivos do Loco estão no local Personalizado ou Sistema, e o limite de tamanho de PHP foi aumentado antes de sincronizar.
  • O CSS personalizado seleciona os blocos pelo slug da taxonomia, não pelo título.
  • O cache de páginas e o cache de termos foram limpos antes de testar o segundo idioma.

Se um rótulo ainda se recusa a mudar, abra um tópico no fórum de suporte do HUSKY com um link para a página no segundo idioma, o plugin de tradução que você usa e as linhas que adicionou.