Pular para o conteúdo Pular para a barra lateral
Início » Documentação do WPML » Projetos relacionados » Advanced Custom Fields (ACF) Multilingual – Traduza todos os campos com o WPML » Definir preferências de tradução para campos do ACF em PHP e arquivos JSON

Definir preferências de tradução para campos do ACF em PHP e arquivos JSON

Kathy
Atualizado
Março 3, 2026

Saiba como definir preferências de tradução para campos do ACF registrados em PHP e incluí-las automaticamente em arquivos JSON gerados pelo ACF.

Definir preferências de tradução para campos do ACF registrados com PHP

Para definir preferências de tradução para campos do ACF registrados com PHP, é necessário usar a função acf_add_local_field_group e adicionar wpml_cf_preferences à definição de cada campo.

Existem quatro valores numéricos que você pode usar para wpml_cf_preferences:

  • 0 — Não traduzir. O WPML ignora o campo completamente.
  • 1 — Copiar. O valor do campo é copiado para todos os idiomas e permanece sincronizado.
  • 2 — Traduzir. O valor do campo fica disponível para tradução.
  • 3 — Copiar uma vez. O valor do campo é copiado para todos os idiomas uma vez; depois disso, ele pode ser editado em cada idioma de forma independente.

Não tem certeza de qual opção de tradução usar? Veja a opção recomendada para cada campo do ACF.

Abaixo você pode ver um exemplo de adição da chave wpml_cf_preferences a um grupo de campos registrado programaticamente.

acf_add_local_field_group( [
  'key' => 'group_1',
  'title' => 'My Group',
  'fields' => [
  [
  'key' => 'field_1',
  'label' => 'Sub Title',
  'name' => 'sub_title',
  'type' => 'text',
  'prefix' => '',
  'instructions' => '',
  'required' => 0,
  'conditional_logic' => 0,
  'wrapper' => [
  'width' => '',
  'class' => '',
  'id' => '',
  ],
  'default_value' => '',
  'placeholder' => '',
  'prepend' => '',
  'append' => '',
  'maxlength' => '',
  'readonly' => 0,
  'disabled' => 0,
  'wpml_cf_preferences' => 2, // Este campo ("Sub Title") será traduzido.
  ],
  ],
  'location' => [
  [
  [
  'param' => 'post_type',
  'operator' => '==',
  'value' => 'post',
  ],
  ],
  ],
  'menu_order' => 0,
  'position' => 'normal',
  'style' => 'default',
  'label_placement' => 'top',
  'instruction_placement' => 'label',
  'hide_on_screen' => '',
] );

Sincronizar seus campos com o WPML

Depois de definir seus campos usando PHP, você precisa informar o WPML sobre eles.

  1. Acesse a página ACF → Ferramentas.
  2. Role para baixo até Traduzir ACF Local JSON e campos registrados em PHP.
Sincronizando campos ACF locais com o WPML
  1. Na seção Sincronizar preferências de tradução para campos locais, selecione quando a sincronização deve ocorrer. Na maioria dos casos, você deverá usar a opção Sincronizar uma vez agora e, em seguida, clicar no botão Aplicar.

O WPML sincronizará os campos e depois redefinirá para a opção de não sincronização. Dessa forma, a sincronização afeta seu banco de dados apenas uma vez e no momento que você escolher.

Definir preferências de tradução para campos do ACF em arquivos JSON

Se você estiver usando o recurso Local JSON do ACF, o ACF Multilingual (ACFML) adicionará automaticamente as preferências de tradução para cada campo em seu arquivo JSON. Isso significa que, ao exportar e importar arquivos JSON entre sites, as preferências de tradução serão aplicadas automaticamente no site de destino.

Tudo o que você precisa fazer é ativar o ACFML tanto no site de origem quanto no site de destino. Depois disso, sempre que o ACF gerar um arquivo JSON, ele também incluirá suas preferências de tradução.

Se seus arquivos JSON foram gerados originalmente sem o ACFML ativo, ative o ACFML, importe os arquivos JSON na interface do usuário do ACF, defina as preferências de tradução e salve novamente os grupos de campos. Isso regenera os arquivos JSON com as preferências incluídas.