Como alterar mensagens de validação

Gostaria de alterar as mensagens de validação que aparecem em seus formulários? A personalização das mensagens de validação é especialmente útil se você quiser traduzir seus formulários para um idioma diferente ou se quiser simplesmente modificar o texto.

Este tutorial mostrará alguns exemplos de mensagens de validação e como alterá-las.

O que são mensagens de validação?

Alguns campos em seus formulários têm determinadas regras. Por exemplo, os usuários não podem enviar um formulário se um campo obrigatório estiver vazio. Eles também não podem enviar um campo E-mail com texto que não seja um endereço de e-mail adequado ou um campo URL que não contenha um endereço da Web.

O WPForms usa um processo chamado validação para verificar se cada entrada segue as regras dos seus formulários. Se o usuário não tiver preenchido um campo corretamente, será exibida uma mensagem informando como corrigir o problema antes de concluir o envio.

Por exemplo, a mensagem de validação que aparece se um campo obrigatório estiver vazio diz: "Este campo é obrigatório".

Personalização de mensagens de validação

O WPForms gerencia as mensagens de validação de todo o seu site nas configurações do plug-in.

Para visualizar a lista existente de mensagens de validação para seus formulários, acesse WPForms " Configurações e abra a guia Validação.

As mensagens específicas disponíveis aqui dependem do seu nível de licença e dos complementos que você instalou. Para personalizar essas mensagens, basta substituir o texto padrão pela mensagem que deseja que seus usuários vejam.

Abaixo, listamos todas as mensagens de validação atualmente disponíveis para personalização, juntamente com seus valores padrão:

• Obrigatório: Este campo é obrigatório.
• URL do site: Digite um URL válido.
• E-mail: Digite um endereço de e-mail válido.
• Email Suggestion: Did you mean {suggestion}?
• Restrição de e-mail: Esse endereço de e-mail não é permitido.
• Número: Digite um número válido.
• Número positivo: Digite um número positivo válido.
• Confirmar valor: Os valores do campo não correspondem.
• Máscara de entrada incompleta: Preencha o campo no formato necessário.
• Checkbox Selection Limit: You have exceeded the number of allowed selections: {#}.
• Character Limit: Limit is {limit} characters. Characters remaining: {remaining}.
• Word Limit: Limit is {limit} words. Words remaining: {remaining}.
• Telefone: Digite um número de telefone válido.
• Extensão de arquivo: O tipo de arquivo não é permitido.
• Tamanho do arquivo: O arquivo excede o tamanho máximo permitido. O arquivo não foi carregado.
• Hora (12 horas): Digite a hora no formato AM/PM de 12 horas (por exemplo, 8:45 AM).
• Hora (24 horas): Digite a hora no formato de 24 horas (por exemplo, 22:45).
• Pagamento obrigatório: O pagamento é obrigatório.
• Cartão de crédito: Digite um número de cartão de crédito válido.
• Field Upload Total Size: The total size of the selected files {totalSize} Mb exceeds the allowed limit {maxSize} Mb.
• Força da senha: É necessária uma senha mais forte. Considere o uso de letras maiúsculas e minúsculas, números e símbolos.
• Resposta única: O valor deve ser exclusivo.
• Erro de cupom: Este não é um cupom válido.

Observe que algumas das mensagens padrão incluem espaços reservados entre chaves. Eles extrairão valores de outras áreas do seu site e os exibirão nas mensagens de validação.

Os espaços reservados disponíveis incluem:

• {suggestion}: Inserts a suggested correction if a user enters a common email address (e.g., @gmail.com, @yahoo.com) with a typo.
• {#}: Shows the maximum number of selections allowed by a Checkboxes field, as determined in its field options.
• {limit}: Shows the word or character limit for a Single Line Text or Paragraph Text field, as set in its field options.
• {remaining}: Displays the remaining available words or characters until the user reaches the limit for a Single Line Text or Paragraph field, as set in its field options.
• {totalSize}: Inserts the size of a file a user has attempted to upload using the File Upload field.
• {maxSize}: Displays the maximum file size allowed by the File Upload field.

Depois de fazer as alterações, não se esqueça de clicar em Salvar configurações na parte inferior da tela. Todos os WPForms em seu site usarão essas mensagens de validação.

Perguntas frequentes

Essas são algumas das perguntas mais comuns que recebemos sobre a personalização de mensagens de validação no WPForms.

Traduzi minhas mensagens de validação e agora meus placeholders não estão funcionando. O que devo fazer?

Ao traduzir suas mensagens de validação, você deve deixar os espaços reservados em inglês.

For example, if you were to translate the default email suggestion validation message, you would enter “Did you mean” in your target language, but leave “{suggestion}” in English, like so:

Como posso alterar o texto de erro para envios de formulários com falha no WPForms?

Você pode modificar o texto de erro exibido para envios com falha no WPForms usando um snippet PHP. Isso permite personalizar a mensagem para atender melhor às necessidades do seu site ou para fornecer instruções mais específicas aos usuários.

Para obter instruções detalhadas sobre como implementar esse snippet, consulte nossa documentação para desenvolvedores sobre como alterar o texto de erro para envios com falha.

É isso aí! Agora você pode personalizar as mensagens de validação em seus formulários.

Em seguida, você também gostaria de personalizar a aparência das mensagens de validação ou estilizar outras partes dos formulários? Para começar, confira nosso guia de CSS para iniciantes.