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 filtro | De onde vem | Onde traduzir |
|---|---|---|
| Nomes de termos: categorias, cores, tamanhos | Termos do WordPress | Seu plugin multilíngue, como qualquer termo de categoria ou atributo |
| Títulos de blocos sem rótulo personalizado | O nome da taxonomia, nos atributos "Product Color" e assim por diante | Seu 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ções | Configurações do HUSKY | Traduçõ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-filter | WPML String Translation, Loco Translate ou arquivos .po/.mo |
| Título do widget do filtro | O widget do WordPress | Traduçã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.
- 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. - 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.
- 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. Usarenem um site Polylang que rodaen_GBé o motivo mais comum de nada mudar. - 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:
- Vá em Loco Translate → Plugins, abra o HUSKY e adicione um novo idioma.
- Escolha o local Personalizado (Custom) ou Sistema (System), não a pasta
languagesdo 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. - 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.
- 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.