Alterando Mensagens de Validação

Você gostaria de alterar as mensagens de validação que aparecem em seus formulários? Personalizar suas mensagens de validação é especialmente útil se você quiser traduzir seus formulários para um idioma diferente, ou se simplesmente quiser 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 regras específicas. 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 de E-mail com um texto que não seja um endereço de e-mail válido, ou um campo de 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 de seus formulários. Se o usuário não preencheu um campo corretamente, uma mensagem aparecerá para dizer 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.”

Personalizando Mensagens de Validação

O WPForms gerencia as mensagens de validação para todo o seu site nas configurações do plugin.

Para ver a lista existente de mensagens de validação para seus formulários, vá para WPForms » Configurações e abra a aba Validação.

As mensagens específicas disponíveis aqui dependem do seu nível de licença e dos addons que você instalou. Para personalizar essas mensagens, basta substituir o texto padrão pela mensagem que você 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: Por favor, insira uma URL válida.
• E-mail: Por favor, insira um endereço de e-mail válido.
• Sugestão de E-mail: Você quis dizer {suggestion}?
• E-mail Restrito: Este endereço de e-mail não é permitido.
• Número: Por favor, insira um número válido.
• Número Positivo: Por favor, insira um número positivo válido.
• Confirmar Valor: Os valores dos campos não coincidem.
• Máscara de Entrada Incompleta: Por favor, preencha o campo no formato exigido.
• Limite de Seleção de Caixa de Seleção: Você excedeu o número de seleções permitidas: {#}.
• Limite de Caracteres: O limite é de {limit} caracteres. Caracteres restantes: {remaining}.
• Limite de Palavras: O limite é de {limit} palavras. Palavras restantes: {remaining}.
• Telefone: Por favor, insira um número de telefone válido.
• Extensão de Arquivo: Tipo de arquivo não permitido.
• Tamanho do Arquivo: O arquivo excede o tamanho máximo permitido. O arquivo não foi enviado.
• Hora (12 horas): Por favor, insira a hora no formato de 12 horas AM/PM (ex: 8:45 AM).
• Hora (24 horas): Por favor, insira a hora no formato de 24 horas (ex: 22:45).
• Pagamento Obrigatório: Pagamento é obrigatório.
• Cartão de Crédito: Por favor, insira um número de cartão de crédito válido.
• Tamanho Total do Upload do Campo: O tamanho total dos arquivos selecionados {totalSize} Mb excede o limite permitido de {maxSize} Mb.
• Força da Senha: Uma senha mais forte é necessária. Considere usar letras maiúsculas e minúsculas, números e símbolos.
• Resposta Única: O valor deve ser único.
• Erro de Cupom: Este não é um cupom válido.

Observe que algumas das mensagens padrão incluem placeholders entre chaves. Estes puxarão valores de outras áreas do seu site e os exibirão em suas mensagens de validação.

Os placeholders disponíveis incluem:

• {suggestion}: Insere uma sugestão de correção se um usuário digitar um endereço de e-mail comum (por exemplo, @gmail.com, @yahoo.com) com um erro de digitação.
• {#}: Mostra o número máximo de seleções permitidas por um campo de Caixas de Seleção, conforme determinado nas opções do campo.
• {limit}: Mostra o limite de palavras ou caracteres para um campo de Linha de Texto Única ou Texto de Parágrafo, conforme definido em suas opções de campo.
• {remaining}: Exibe as palavras ou caracteres restantes disponíveis até que o usuário atinja o limite para um campo de Linha de Texto Única ou Parágrafo, conforme definido em suas opções de campo.
• {totalSize}: Insere o tamanho de um arquivo que um usuário tentou enviar usando o campo de Upload de Arquivo.
• {maxSize}: Exibe o tamanho máximo de arquivo permitido pelo campo de Upload de Arquivo.

Depois de fazer suas alterações, certifique-se 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

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

Eu 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 seus placeholders em inglês.

Por exemplo, se você fosse traduzir a mensagem de validação padrão de sugestão de e-mail, você digitaria “Você quis dizer” em seu idioma de destino, mas deixaria “{suggestion}” em inglês, assim:

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

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

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

Pronto! Agora você pode personalizar as mensagens de validação em seus formulários.

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