Como traduzir o Ninja Forms no WordPress - formulários de várias etapas, ações de e-mail e ações de integração

Antes de começar

Instale e ative estes plugins:

Ninja Forms.
WPML e WPML Tradução de Strings.
Ninja Forms Multilingual (o complemento que esta página aborda).

Crie o formulário no Ninja Forms no idioma de origem do seu site, incluindo qualquer estrutura de várias etapas, lógica condicional, texto de validação e as ações que você precisa (mensagem de sucesso, redirecionamento de envio, e-mail, ações de integração). Envie o formulário para tradução depois que ele estiver funcionalmente completo.

O Traduzir tudo automaticamente cuida disso para você

Se o seu site tem o Traduzir tudo automaticamente ativado, você não precisa enviar o formulário para tradução manualmente. O WPML detecta formulários novos e atualizados junto com o resto 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

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

Campos, opções, ações (mensagem de sucesso, e-mail, redirecionamento de envio, integrações) e mensagens de validação por campo entram no mesmo trabalho de tradução.

Insira o formulário nas suas páginas traduzidas

O Ninja Forms fica dentro de uma página ou post, geralmente por meio do bloco do Ninja Forms ou do shortcode [ninja_form id="X"]. A regra de inserção multilíngue:

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:

Crie o formulário uma vez no seu idioma de origem.
Envie o formulário para tradução (ou deixe o Traduzir tudo automaticamente detectá-lo).
Insira o formulário na página no idioma de origem usando o bloco do Ninja Forms ou o shortcode [ninja_form].
Traduza a página através 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.
Quando um visitante abre a página traduzida, o Ninja Forms Multilingual exibe o formulário no idioma do visitante automaticamente – mesmo ID do formulário, mesmo shortcode, conteúdo traduzido.

Você não precisa de um ID do formulário diferente por idioma. A tradução está vinculada ao formulário de origem; o Ninja Forms Multilingual resolve a versão no idioma correto no momento da renderização.

A exceção – quando você genuinamente quer formulários diferentes por idioma. Se você precisar de formulários estruturalmente diferentes por idioma (campos diferentes, ações diferentes, lógica diferente), crie formulários do Ninja 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.

Pegadinha dos construtores de páginas

Se a sua página for criada no Divi, Elementor ou outro construtor de páginas que envolve shortcodes em seu próprio módulo de texto, o shortcode pode nem sempre sobreviver à tradução de forma limpa. Se a página traduzida mostrar o formulário no idioma de origem, abra a página traduzida no construtor de páginas e reinsira o bloco ou shortcode do formulário lá. O editor de blocos nativo do WordPress e o editor clássico não têm esse problema.

Rótulos de campos e tipos de campos

Cada rótulo de campo, espaço reservado e opção do Ninja Forms aparece no trabalho de tradução. O catálogo completo de campos é traduzido: texto, parágrafo, nome, e-mail, endereço, telefone, lista (seleção, rádio, caixa de seleção, seleção múltipla), número, data/hora, envio de arquivo, enviar.

Os campos repetidores são traduzidos no nível da linha: o rótulo do botão de adicionar linha e cada rótulo de campo por linha ficam no trabalho de tradução. Os tradutores veem a estrutura do repetidor intacta com o rótulo de cada subcampo como uma linha traduzível.

Campos de seleção de imagem

Os campos de seleção de imagem combinam uma miniatura com um rótulo de texto. O Ninja Forms Multilingual traduz o rótulo por idioma, enquanto a imagem permanece compartilhada. Os seletores baseados em imagens funcionam de forma idêntica em todos os idiomas; apenas as legendas são traduzidas.

Formulários de várias etapas

Para formulários de várias etapas, cada título de etapa e os botões de navegação por etapa (Anterior, Próximo, Enviar) são traduzidos como suas próprias linhas. A lógica condicional por etapa sobrevive à tradução. O mapa de valores mantém os valores de escolha subjacentes alinhados entre os idiomas.

Após a tradução, percorra o fluxo de várias etapas em cada idioma para confirmar se a navegação soa natural e se a ramificação condicional ainda é acionada nas etapas corretas.

Layout e estilos

As saídas do designer de layout e estilos do Ninja são traduzidas sem perder o layout. A grade, as colunas e o estilo visual permanecem; apenas o conteúdo das strings muda por idioma. Sem etapas especiais: traduza o formulário e o layout o acompanha.

Salvar progresso

Para formulários com a opção de salvar progresso ativada, os avisos visíveis para o visitante são traduzidos:

Rótulo do botão Salvar progresso.
Assunto e corpo do e-mail com o link de retomada.
A mensagem de sucesso após salvar.

Os três ficam no trabalho de tradução. Após a tradução, teste salvando na metade de um formulário em cada idioma e confirmando se o e-mail de retomada chega no idioma correto.

Mensagens de validação por campo

Cada campo traz seu próprio texto de validação: erro de campo obrigatório, erro de formato, mensagem de validação personalizada. Cada um deles aparece no trabalho de tradução. O texto do Anti-Spam e Honeypot é traduzido através do WPML Tradução de Strings (não no trabalho de tradução do formulário).

Ação de mensagem de sucesso e ação de redirecionamento de envio

O texto de agradecimento embutido da ação de mensagem de sucesso é traduzido por idioma. O URL da ação de redirecionamento de envio também é traduzível. Defina um URL de agradecimento diferente para cada idioma, para que os visitantes cheguem a uma página no idioma correspondente após o envio.

Ação de e-mail

Cada ação de e-mail no formulário é traduzida independentemente. Para, Nome do remetente, Assunto e Mensagem de e-mail aparecem no trabalho de tradução. Formulários com várias ações de e-mail (notificação do administrador + confirmação do visitante, por exemplo) traduzem cada ação separadamente para que o texto de cada idioma seja independente.

Uma limitação conhecida

As tags de mesclagem (merge tags) dentro dos modelos de ação de e-mail não são traduzidas por idioma. A inserção da tag de mesclagem usa o modelo do idioma de origem, então os dados do formulário são substituídos, mas as frases ao redor permanecem no idioma de origem. Acompanhado na página de erratas. Solução alternativa: crie as frases ao redor sem tags de mesclagem onde a diferença de idioma for importante, ou aceite a limitação para textos de menor importância.

Ações de integração

A arquitetura de ações do Ninja Forms significa que cada integração é uma etapa do fluxo de trabalho por formulário. O texto visível para o visitante de cada ação é traduzido:

Ações de Webhook. O corpo da requisição e quaisquer rótulos visíveis para o visitante são traduzidos; os valores dos campos permanecem canônicos para que os endpoints de recebimento não quebrem.
Mailchimp / AWeber / Constant Contact / ActiveCampaign / Campaign Monitor / CleverReach / Drip / EmailOctopus / Emma / Kit / MailerLite / MailPoet. Os rótulos de lista / segmento / tag são traduzidos se existirem como strings no nível do formulário.
HubSpot / Salesforce / ZohoCRM. Os rótulos de pipeline / estágio / formulário são traduzidos.
Zapier / Slack / Trello. As strings de canal, rótulo e nome do formulário do webhook são traduzidas.

Para integrações de pagamento (Stripe, Authorize.net, Elavon, PayPal), as descrições de compra e os rótulos de botões visíveis para o visitante são traduzidos. Execute uma transação de teste em cada idioma usando o modo de teste do processador de pagamento e confirme se o texto do recibo chega corretamente.

Uma limitação conhecida – Envio de formulário em PDF

O complemento PDF Form Submission do Ninja Forms não gera PDFs quando o Ninja Forms Multilingual está ativo em formulários com traduções configuradas. Isso está sendo acompanhado em um tópico do fórum. Solução alternativa: desative o complemento de PDF para formulários traduzidos até que a compatibilidade seja resolvida.

Armadilhas comuns

O corpo da ação de e-mail tem arredores de tags de mesclagem não traduzidos. Limitação conhecida (veja acima). Reestruture o corpo do e-mail para colocar o texto traduzido fora das inserções de tags de mesclagem, ou aceite a limitação.
Os e-mails de notificação do administrador chegam no idioma de origem. Confirme se a ação de e-mail que você está testando foi reenviada para tradução após sua última edição. Se ainda estiver quebrado, verifique o tópico recorrente do fórum para saber o status.
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. Reenvie o formulário para tradução para atualizar o mapa de valores.
O envio de formulário em PDF para de funcionar. Desative o complemento ou remova a tradução enquanto aguarda a resolução da compatibilidade.