Você traduz uma planilha e na versão em inglês metade do conteúdo ainda está em espanhol: o subtítulo, a lista de funcionalidades, o texto do botão. Todos esses são campos personalizados, e eles vivem em uma tabela diferente do conteúdo.
Advanced Custom Fields é o plugin que os gerencia na maioria dos sites profissionais. Traduzi-los bem tem pouco mistério, mas exige uma decisão para cada campo: traduzir, copiar ou não tocar. Cometer um erro nessa decisão quebra o cartão de uma forma que leva semanas para aparecer.
Direto ao ponto: nem todos os campos são traduzidos. Um campo de número, data ou cor deve ser copiado como está- Se passar por um tradutor, o valor fica inválido e o site começa a travar em lugares estranhos. A regra é simples: o que o visitante lê é traduzido; ele copia o que o código usa.
Por que eles não se traduzem?
WordPress salva campos personalizados como postar meta: pares de chave e valor associados a uma entrada, na tabela wp_postmeta. Quando um plugin multilíngue cria uma tradução para uma postagem, ele copia o conteúdo principal, mas os metadados precisam de tratamento explícito — deve ser informado o que fazer com cada chave.
É por isso que quase todos os plugins possuem uma tela de “preferências de tradução de campos personalizados” onde você marca, campo por campo, o que deseja que aconteça. É tedioso na primeira vez e você não precisa tocá-lo novamente.
A decisão por tipo de campo
| Tipo de campo | Pendência | Porque |
|---|---|---|
| Texto, área de texto | Traducir | É o conteúdo que o visitante lê |
| Editor WYSIWYG | Traducir | Tenha cuidado com os links dentro |
| Imagem, arquivo, galeria | Copiar | O arquivo funciona; traduzir apenas o alt |
| Número, data, cor | Copiar | Traduzi-lo invalida o valor |
| Verdadeiro/falso | Copiar | É uma mudança, não um texto |
| Link (URL) | Copiar e revisar | Você deve segmentar o idioma correto |
| Relacionamento, postar objeto | Copiar e apontar | Para a tradução, não para o original |
| Seletor de opções | Depende | Não é a chave; a etiqueta sim |
| Repetidor, grupo flexível | Campo a campo | Cada subcampo tem sua regra |
Os três campos que causam problemas
Relacionamento e objeto de postagem
Um campo que aponta para outra entrada – “produtos relacionados”, “autor da planilha”, “história de sucesso associada” – armazena um ID numérico. Se você copiá-lo como está, a versão em inglês apontará para a entrada em espanhol.
O resultado: o visitante inglês está lendo seu arquivo, clica em “ver caso relacionado” e chega em espanhol. É exatamente o mesmo problema que descrevemos em link interno multilíngue, mas oculto dentro de um campo.
A maioria dos plug-ins tem um modo “copiar uma vez” ou “referência de tradução” que redireciona o ID para a tradução. Se o seu não tiver, você deverá corrigi-lo manualmente em cada cartão.
Repetidores e grupos flexíveis
Um repetidor de cinco linhas com três subcampos tem quinze valores e cada subcampo precisa de sua própria regra. Quase todos os plugins gerenciam isso, mas é onde a maioria das coisas não são traduzidas: verifique uma folha completa do repetidor antes de aceitar o trabalho.
Seletores de opções
um campo select salve a chave (premium) e exibe o rótulo (“Premium” ou “Premium”). A chave nunca traduz: é o que o código compara. A tag é traduzida, mas na definição do campo, não na entrada — e isso significa tratá-la como uma string de tópico, com Tradutor Loco ou com o gerenciador de strings do seu plugin.
Ojo: Existe uma segunda camada que sempre é esquecida: os rótulos dos próprios campos. “Preço de”, “Duração”, “Inclui” são textos que o ACF salva na definição do grupo de campos, não na entrada. Se o modelo os imprimir, eles aparecerão em espanhol em todos os idiomas, não importa o quanto você traduza o conteúdo.
Como fazer, passo a passo
- Faça um inventário. Em ACF → Grupos de campos, anote cada campo e seu tipo. Com mais de trinta, uma planilha economiza tempo.
- Classifique cada um conforme tabela acima: traduzir, copiar ou copiar e reponto.
- Configure-o no plugin multilíngue, na tela de preferências de campos personalizados.
- Traduzir um arquivo completo como prova. Apenas um.
- Abra-o no navegador e compare-o lado a lado com o original. Não olhe para o painel: olhe para a página.
- Corrija a configuração com o que você encontrou e agora, jogue fora o resto.
Conselho: use a aba mais complexo do que você como prova, não é a mais simples. Aquele que tem repetidor, galeria, campo de relacionamento e seletor. Se esse correr bem, os outros correrão bem. O contrário não funciona: uma simples planilha não ensina nenhum dos três problemas que realmente existem.
Verificação: o que ver na página
Com o arquivo traduzido aberto no navegador, verifique:
- Todo o texto visível está no idioma correto, incluindo rótulos de campo.
- Os números, datas e preços Eles são os mesmos do original.
- Links de campo eles levam à linguagem correta.
- As imagens aparecem – se estiverem faltando, o campo da imagem não foi copiado – e seu texto alternativo é traduzido. O detalhe, em imagens e metadados multilíngues.
- Os repetidores Eles têm o mesmo número de linhas.
Quando os campos não aparecem para tradução
Se um grupo de campos não aparecer no gerenciador de tradução, verifique nesta ordem: se o tipo de conteúdo está marcado como traduzível - o mesmo requisito do tipos de postagem personalizados—; que o campo não esteja definido como "não traduzir" herdado de uma instalação anterior; e que o grupo de campos não seja restrito por regras de posicionamento que excluam o novo idioma.
WP-Translate Ele percorre os metadados de cada entrada junto com seu conteúdo e traduz os campos de texto, deixando intactos os valores não textuais, para que o arquivo traduzido saia completo sem configurar campo por campo. Os campos de relacionamento ainda precisam de revisão, pois a decisão correta ali depende da sua estrutura. Pode ser verificado em um cartão real com o versão gratuita.
Perguntas frequentes
O ACF Pro é necessário para traduzir campos?
Não. A tradução é feita pelo plugin multilíngue, não pelo ACF. O Pro adiciona repetidores e grupos flexíveis, que dão mais trabalho para traduzir, mas não são obrigatórios.
E as áreas de um designer de layout visual?
É o mesmo problema com outro formulário: o texto reside na estrutura do designer de layout. Como isso é resolvido está em compatibilidad con Elementor y WooCommerce.
Posso traduzir campos de opções globais?
As páginas de opções do ACF armazenam valores no nível do site, não no nível de entrada. Eles precisam de tratamento separado e muitos plugins os tratam como strings, não como conteúdo.
O que acontece se eu traduzir um campo numérico por engano?
O valor torna-se inválido e o código que o utiliza pode falhar silenciosamente: um preço que não é exibido, um filtro que não encontra nada. É a razão pela qual a tabela acima existe.
Continuar lendo
Esta peça faz parte do guia WordPress multilíngue, onde está o tour completo: estrutura de URL, escolha de plugin, tradução automática, SEO e orçamento. Se o que você precisa é decidir por uma ferramenta, a comparação está em os melhores plugins de tradução.
- alterar o idioma do WordPress — Alterar o idioma do WordPress (e por que não é o mesmo que traduzir o seu site)
- como traduzir um plugin do WordPress — Loco Translate, arquivos .po e quando não funciona
- traduzir categorias e tags — Como traduzir categorias e tags no WordPress (e também seus URLs)