Como traduzir o Gravity Forms no WordPress – campos, notificações, confirmações, lógica condicional

Antes de começar

Instale e ative estes plugins:

• Gravity Forms.
• WPML e WPML Tradução de Strings.
• GFML – Gravity Forms Multilingual (o add-on que esta página aborda).

Crie o formulário no Gravity Forms no idioma de origem do seu site. Adicione todos os campos que você quiser (campos de preço, estrutura paginada, lógica condicional, notificações e confirmações) antes de enviar o formulário para tradução. Você sempre pode alterar o formulário mais tarde e retraduzir as diferenças.

O Traduzir tudo automaticamente cuida disso para você

Se o seu site tiver o Traduzir tudo automaticamente ativado, você não precisará enviar o formulário para tradução manualmente. O WPML detecta formulários novos e atualizados junto com o restante do seu conteúdo e os traduz em segundo plano. A etapa de inserção na página abaixo ainda se aplica, mas a etapa de enviar o formulário para tradução é automática. O restante desta página descreve o caminho manual para sites no Traduzir uma parte: você escolhe o que traduzir (ou para formulários que você quer traduzir antes da fila automática).

Envie o formulário para tradução

1. Abra WPML → Traduções → Painel.
2. Expanda a seção Gravity Forms.
3. Marque o formulário que você quer traduzir.
4. Escolha um método de tradução: PTC (recomendado), seu tradutor ou Traduzir eu mesmo.
5. Clique em Traduzir.

O formulário, seus campos, opções, notificações, confirmações e mensagens de validação por campo entram todos no mesmo trabalho de tradução. Os tradutores os veem como linhas rotuladas no Editor de tradução avançado.

Insira o formulário nas suas páginas traduzidas

O Gravity Forms fica dentro de uma página ou post, geralmente através do bloco do Gravity Forms ou do shortcode [gravityform id="X" title="false"]. A maneira como você lida com a inserção multilíngue é a parte que mais surpreende os clientes, então aqui está a regra:

Use o mesmo bloco ou shortcode em todas as versões de idioma da página. Não crie um formulário separado por idioma.

O fluxo:

1. Crie o formulário uma vez no seu idioma de origem.
2. Envie o formulário para tradução (ou deixe o Traduzir tudo automaticamente detectá-lo).
3. Insira o formulário na página no idioma de origem usando o bloco do Gravity Forms ou o shortcode [gravityform].
4. Traduza a página por meio de WPML → Traduções → Painel da mesma forma que você traduziria qualquer outra página. A incorporação do formulário é preservada na página traduzida.
5. Quando um visitante acessa a página traduzida, o GFML exibe o formulário no idioma do visitante automaticamente – mesmo ID de formulário, mesmo shortcode, conteúdo traduzido.

Você não precisa de um ID de formulário diferente por idioma. Você não precisa trocar os shortcodes por idioma. A tradução é vinculada ao formulário de origem; o plugin de integração resolve a versão no idioma correto no momento da renderização com base no idioma da página.

A exceção – quando você genuinamente quer formulários diferentes por idioma. Alguns sites precisam de formulários estruturalmente diferentes por idioma (campos diferentes, lógica diferente, não apenas textos diferentes). Nesse caso, crie formulários do Gravity Forms separados (um por idioma) e insira o shortcode de cada um na versão de idioma correspondente da página usando o editor do WordPress para aquela tradução. Essa é a única situação em que os shortcodes divergem entre os idiomas.

Rótulos e opções de campo são traduzidos junto com campos de preço e produto

Cada rótulo de campo, espaço reservado (placeholder), opção de menu suspenso, escolha de rádio, rótulo de caixa de seleção e conteúdo de campo HTML aparece no trabalho de tradução. Para os distintivos campos de preço (produto, quantidade, total, frete) do Gravity Forms, os rótulos também são traduzidos – “Quantity” se torna “Quantité” (Quantidade) – enquanto o tratamento numérico subjacente permanece intacto. Campos de lista, assinaturas digitais e envios de arquivo são traduzidos da mesma forma. Múltipla escolha e escolha de imagem (tipos de campo do Gravity Forms 2.9) são traduzidos a partir do GFML 1.8.3.

Formulários paginados e formulários conversacionais

Para formulários paginados, cada cabeçalho de página e título de quebra de página fica no trabalho de tradução. A lógica condicional que se ramifica entre as páginas sobrevive à tradução. Os valores de escolha permanecem alinhados entre os idiomas, de modo que as regras de mostrar/ocultar continuam sendo acionadas com os mesmos dados. Os formulários conversacionais (o modo de uma pergunta por vez) traduzem cada prompt e cada transição. Escolha uma versão de idioma, percorra o fluxo conversacional e confirme se cada etapa soa natural antes de publicar.

Mensagens de validação por campo

Cada campo no Gravity Forms tem sua própria configuração de Mensagem de validação na aba Avançado do campo – o texto mostrado quando a validação falha. Cada uma aparece como uma linha no Editor de tradução avançado.

Se você não vir uma mensagem de validação por campo no trabalho de tradução, o campo provavelmente está usando a mensagem padrão do Gravity Forms (definida em Formulários → Configurações → Configurações do formulário) em vez de uma substituição por campo. Defina uma mensagem personalizada por campo e envie novamente o formulário para tradução, ou traduza o padrão global via WPML Tradução de Strings.

Confirmações – texto, redirecionamento e página

O Gravity Forms suporta três tipos de Confirmação e todos os três funcionam de forma multilíngue:

• Confirmações de Texto são traduzidas de forma inline. Edite a confirmação no idioma de origem no Gravity Forms → envie novamente o formulário para tradução → o texto traduzido aparece para cada idioma.
• Confirmações de Página apontam para uma página do WordPress. Traduza essa página por meio do fluxo de trabalho normal de tradução de páginas do WPML; o visitante vê a versão do idioma que corresponde ao seu contexto.
• Confirmações de Redirecionamento enviam o visitante para um URL após o envio. O próprio URL é traduzível por idioma. Defina um URL de agradecimento diferente para cada idioma no Editor de tradução avançado.

Notificações e roteamento de notificações

Cada Notificação do Gravity Forms é traduzida por idioma: Para e-mail, Nome de origem, Assunto, modelos de corpo e tags de mesclagem. O corpo da notificação usa tags de mesclagem do Gravity Forms ({Name}, {Email}, {All Fields}) e elas são resolvidas corretamente após a tradução. As regras de roteamento de notificação enviam envios diferentes para destinatários diferentes com base nos valores dos campos. Elas sobrevivem à tradução porque os valores de escolha subjacentes permanecem alinhados entre os idiomas.

Após a tradução, envie um envio de teste em cada idioma e confirme se a notificação chega no idioma do visitante com as substituições corretas de tags de mesclagem.

Lógica condicional em valores de escolha traduzidos

A lógica condicional em escolhas baseadas em texto (botões de rádio, caixas de seleção, menus suspensos) continua funcionando nas traduções porque o GFML mantém um mapa de valores entre os rótulos de origem e traduzidos. O visitante vê “Pas encore” (Ainda não) em francês; o valor subjacente permanece “Not yet”; a regra condicional continua sendo acionada em “Not yet”.

A única coisa que quebra a lógica condicional: alterar o rótulo de escolha no idioma de origem após a tradução sem reenviar o formulário para tradução. O mapeamento fica desatualizado. Corrija isso reenviando o formulário – o GFML atualiza o mapa de valores.

Add-ons de integração – Mailchimp, ActiveCampaign, HubSpot, Zapier, Slack, Webhooks

Os add-ons do Gravity Forms que enviam envios para serviços de terceiros (Mailchimp, ActiveCampaign, HubSpot, Zapier, Slack, Webhooks e o restante) recebem a entrada traduzida do visitante. O nome e a mensagem de um visitante francês chegam em francês ao destino. Rótulos de lista mapeados, estágios de pipeline e nomes de canais também são traduzidos se existirem como strings no nível do formulário.

Se a sua integração usar valores de campo em vez de rótulos (por exemplo, mapear um valor de menu suspenso para uma lista do Mailchimp), o valor permanecerá canônico entre os idiomas para que o mapeamento não quebre.

Armadilhas comuns

• Os rótulos de escolha não são traduzidos em e-mails de notificação. Envie novamente o formulário para tradução após alterar os rótulos no idioma de origem. Se o problema persistir, verifique se o GFML está atualizado. Esse era um problema recorrente em versões mais antigas e é acompanhado nas dúvidas de suporte.
• O estilo do bloco de formulário parece errado nas páginas traduzidas. Regressão de estilo conhecida – veja a página de errata. Solução alternativa: use a incorporação padrão do shortcode [gravityform] em vez do bloco de formulário enquanto uma correção estiver pendente.
• O formulário mostra “There is nothing to translate” (Não há nada para traduzir) quando obviamente há. Geralmente é um problema de cache do painel. Atualize a página ou envie novamente o formulário para tradução a partir do post que o incorpora.
• A lógica condicional para de ser acionada em formulários traduzidos. Um rótulo de escolha foi editado no idioma de origem após a tradução. Envie novamente o formulário para tradução para atualizar o mapa de valores.