Pular para o conteúdo Pular para a barra lateral

Home » Documentação do WPML » Projetos relacionados » Advanced Custom Fields (ACF) Multilingual – Traduza todos os campos com o WPML

Advanced Custom Fields (ACF) Multilingual – Traduza campos com o WPML

O ACFML é um add-on do WPML que permite criar sites multilíngues com o ACF e o ACF Pro.

Confiado por mais de 70.000 desenvolvedores

ACFML em ação

Principais recursos

Traduza qualquer campo disponível no ACF e no ACF Pro

Use tradução por IA ou traduza você mesmo

Exiba os mesmos campos ou campos diferentes em cada idioma

Nesta página

Plugins obrigatórios

Como traduzir com o ACFML

Mesmos campos em todos os idiomas

Campos diferentes em cada idioma

Modo especialista (avançado)

Traduzir rótulos de campos

Traduzir opções de escolha de campos do ACF

Traduzir páginas de opções do ACF

Plugins obrigatórios

Para traduzir seu site com o ACFML, instale e ative os seguintes plugins:

Como traduzir com o ACFML

As etapas necessárias para traduzir os campos do ACF dependem da configuração do grupo de campos. Ao configurar um novo grupo de campos, o ACFML oferecerá três opções de tradução.

Opção 1: Mesmos campos em todos os idiomas

Esta opção é a configuração típica usada pela maioria dos sites com ACF. Ela permite traduzir os valores dos seus campos personalizados, mantendo a estrutura em todos os idiomas.

Por exemplo, pense na página “nossa equipe” do seu site. Sua equipe é a mesma, independentemente do idioma da página. Como você está exibindo as mesmas informações (as pessoas da sua equipe e seus detalhes), você deve usar “mesmos campos em todos os idiomas” para os campos deste grupo.

Você inserirá as informações sobre sua equipe uma única vez, no idioma padrão do site. Em seguida, você traduzirá esses detalhes para os demais idiomas do site.

Team page in English
Página da equipe em inglês
Team page in Spanish
Página da equipe em espanhol

Para exibir os mesmos campos em todos os idiomas:

  1. Vá em ACF → Grupos de campos e edite seu Grupo de campos.
  2. Em Configuração multilíngue, selecione a opção Mesmos campos em todos os idiomas.
Selecting same fields across languages
Selecionando os mesmos campos em todos os idiomas
  1. Por fim, vá em WPML → Translation dashboard e envie o conteúdo com seus campos personalizados para tradução.

Se você não encontrar seu conteúdo no Translation Dashboard, vá em WPML → Configurações, role até Tradução de tipo de post e verifique se o seu conteúdo está definido como Traduzível.

Opção 2: Campos diferentes em cada idioma

Esta opção permite exibir campos traduzidos com valores diferentes em cada idioma. Ela é útil quando você deseja mostrar versões localizadas de conteúdos semelhantes.

Pense em uma empresa que organiza eventos e oferece eventos diferentes para públicos em idiomas diferentes. A página “eventos” precisará exibir conteúdos diferentes (eventos) para cada idioma.

Events in English
Eventos em inglês
Events in Spanish
Eventos em espanhol

Para exibir campos diferentes em cada idioma:

  1. Vá em ACF → Grupos de campos e edite seu Grupo de campos.
  2. Em Configuração multilíngue, selecione a opção Campos diferentes em cada idioma.
Selecting different fields across languages
Selecionando campos diferentes em cada idioma
  1. Em seguida, localize o conteúdo com seus campos personalizados (por exemplo, página, post) e clique em Editar.
  2. Na barra lateral direita, clique no ícone de Mais do idioma para o qual você deseja exibir campos diferentes.
Plus icons in under Translate this Document
Ícones de mais na barra lateral direita
  1. Um rascunho em branco será aberto com campos personalizados vazios. Insira seus valores traduzidos e diferentes para cada campo e clique em Publicar.
Empty custom fields
Campos personalizados vazios

Opção 3: Modo especialista (avançado)

O Modo especialista permite controlar manualmente as preferências de tradução de cada campo personalizado. Esta opção é útil quando você deseja uma combinação de campos iguais e diferentes em todos os idiomas e precisa de controle de tradução independente por campo.

Por exemplo, no exemplo de evento abaixo, temos uma combinação de campos com preferências de tradução diferentes; o título e a descrição são traduzidos, enquanto o preço, a data e o endereço são copiados.

Event in English
Evento em inglês
Event in Spanish
Evento em espanhol

O modo especialista está disponível junto com as outras opções do ACFML, ao escolher um método de tradução do Grupo de campos.

Traduzir rótulos de campos

Os rótulos de campos do ACF são os nomes que identificam cada campo personalizado no editor do WordPress. No front-end, os rótulos de campos geralmente são exibidos em formulários para ajudar a identificar diferentes campos.

Field label in backend
Rótulo de campo no back-end
Field label on front-end
Rótulo de campo no front-end

Para traduzir rótulos de campos do ACF:

  1. Vá em WPML → Translation Dashboard.
  2. Abra a seção Grupo de campos do ACF e envie o item Rótulos do grupo de campos para tradução.

Traduzir opções de escolha de campos do ACF

As opções de escolha de campos do ACF são campos personalizados com múltiplas opções, como botões de opção, seletores suspensos e caixas de seleção. Esses campos normalmente são usados em formulários e precisam ser traduzidos separadamente.

ACF choices in a contact form
Opções do ACF em um formulário de contato

Para traduzir opções de escolha de campos do ACF:

  1. Vá em WPML → Translation Dashboard.
  2. Abra a seção Grupo de campos do ACF e envie o item com suas opções do ACF para tradução.

Traduzir páginas de opções do ACF

As Páginas de opções permitem criar páginas globais de configurações no painel do WordPress para gerenciar informações do site inteiro, como detalhes de contato e logotipos.

Páginas de opções no menu de administração do ACF

Para traduzir campos nas Páginas de opções:

  1. Vá em WPML → Translation Dashboard.
  2. Abra a seção Opções do ACF e envie sua Página de opções para tradução.

Comece com o ACFML

Comece a criar um site multilíngue com campos personalizados.

Obter o ACFML

Perguntas frequentes

Posso traduzir blocos do ACF com o ACFML?

Sim, você pode traduzir blocos do ACF com o ACFML usando os mesmos métodos de tradução abordados anteriormente: mesmos campos ou campos diferentes em cada idioma.

Posso usar imagens diferentes em cada idioma?

Sim, você pode usar imagens diferentes em cada idioma. Basta usar Campos diferentes em cada idioma e enviar mídias diferentes em cada idioma.

Se você quiser usar Mesmos campos em todos os idiomas, instale o add-on WPML Media Translation e vá em WPML → Media Translation para enviar imagens diferentes por idioma.

Por que alguns campos não aparecem para tradução?

Para garantir que os campos apareçam para tradução, evite usar o mesmo nome de campo mais de uma vez e não comece com um sublinhado (por exemplo, _custom_field).

Posso traduzir campos do ACF registrados usando PHP?

Sim, você pode traduzir campos do ACF registrados usando PHP. Ao registrar campos, você pode controlar como o WPML lida com cada campo adicionando o parâmetro wpml_cf_preferences à definição do campo.

Para mais detalhes, consulte nosso guia sobre como definir preferências de tradução para campos do ACF criados usando código PHP.

Tomer Helzer
Atualizado
maio 6, 2026