Atenção!

Este artigo contém código PHP e destina-se a desenvolvedores. Oferecemos este código como uma cortesia, mas não fornecemos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação extra, consulte o tutorial do WPBeginner sobre como adicionar código personalizado.

Dispensar

Como Alterar o Texto de Validação de Limite de Caracteres

Curioso para alterar o texto do limite de caracteres exibido abaixo dos campos do seu formulário, especialmente ao usar o Limite de Caracteres em campos de formulário de Texto de Linha Única ou Texto de Parágrafo?

Por padrão, você notará uma mensagem abaixo do campo do formulário indicando a contagem atual de caracteres em relação ao limite máximo, como 0 de 50 caracteres máximos ou 0 de 50 palavras máximas, dependendo das configurações do seu formulário. Você pode personalizar essa mensagem para incluir a contagem de caracteres restantes. Esse ajuste é facilmente realizado com um simples trecho de PHP. Neste tutorial, mostraremos como usar PHP para alterar essa mensagem.

Criando o formulário

Primeiro, precisaremos criar nosso formulário e adicionar nossos campos.

Se precisar de ajuda para criar seu formulário, consulte esta documentação.

adicione seus campos ao seu novo formulário

Adicionamos um campo de formulário de Texto de Parágrafo para conter nossa mensagem gravada.

Configurando o limite de caracteres

Em seguida, selecione o Texto de Parágrafo que você adicionou e clique na aba Avançado para ativar a opção Limitar Comprimento e definir o limite para 100 e selecionar Caractere no menu suspenso.

habilite a opção Limitar Comprimento na aba Avançado

Para mais informações sobre a opção Limitar Comprimento, revise esta documentação.

Alterando o texto de validação de limite de caracteres

Agora é hora de adicionar o snippet ao seu site.

Se você não tem certeza de como ou onde adicionar snippets ao seu site, consulte este tutorial.

/**
 * Change the text for the character limit.
 *
 * @link https://wpforms.com/developers/how-to-change-the-limit-character-validation-text/
 */

function wpf_dev_frontend_strings( $strings ) {
	
    // val_limit_words when using words
    // val_limit_characters when using characters   
    
    // Change the message that will appear to your visitors after the = sign below
    $strings[ 'val_limit_characters' ] = __( 'You have used {count} characters out of allotted {limit}. You have {remaining} remaining.', 'plugin-domain' );

	return $strings;
}

add_filter( 'wpforms_frontend_strings' , 'wpf_dev_frontend_strings', 10, 1 );

com este snippet os usuários podem ver quantos caracteres restam do limite de caracteres

E é isso! Você alterou com sucesso o texto do limite de caracteres que aparece sob o campo do formulário ao usar o limite de caracteres ou palavras. Você também gostaria de definir um número mínimo de caracteres para o seu campo de formulário? Dê uma olhada em nosso tutorial sobre Como Definir um Número Mínimo de Caracteres em um Campo de Formulário de Texto.

Filtro de Referência

wpforms_frontend_strings

Perguntas Frequentes

P: Como eu mudaria o texto ao usar o limite de Palavras e não o limite de Caracteres?

R: Para alterar o texto do limite de Palavras, use o seguinte trecho de código:

/**
 * Change the text for the character limit.
 *
 * @link https://wpforms.com/developers/how-to-change-the-limit-character-validation-text/
 */

function wpf_dev_frontend_strings( $strings ) {
	
    // val_limit_words when using words
    // val_limit_characters when using characters   
    
    // Change the message that will appear to your visitors after the = sign below
    $strings[ 'val_limit_words' ] = __( 'You have used {count} words out of allotted {limit}. You have {remaining} remaining.', 'plugin-domain' );
	return $strings;
}

add_filter( 'wpforms_frontend_strings' , 'wpf_dev_frontend_strings', 10, 1 );

P: Posso alterar isso para palavras e caracteres em uma única função?

R: Com certeza! Você pode alterar esse texto para palavras e caracteres em uma única função usando este snippet.

/**
 * Change the text for the character and word limit.
 *
 * @link https://wpforms.com/developers/how-to-change-the-limit-character-validation-text/
 */
  
function wpf_dev_frontend_strings( $strings ) {
      
    // val_limit_words when using words
    // val_limit_characters when using characters   
      
    // Change the message that will appear to your visitors after the = sign below
    $strings[ 'val_limit_words' ] = __( 'You have used {count} words out of allotted {limit}. You have {remaining} remaining.', 'plugin-domain' );
    $strings[ 'val_limit_characters' ] = __( 'You have used {count} characters out of allotted {limit}. You have {remaining} remaining.', 'plugin-domain' );
    return $strings;
}
  
add_filter( 'wpforms_frontend_strings' , 'wpf_dev_frontend_strings', 10, 1 );

P: Posso remover completamente o texto que aparece?

R: Você pode, é claro, remover esta mensagem. Mas lembre-se, se seus visitantes estiverem digitando e de repente não puderem mais digitar devido ao limite, isso pode causar confusão ao preencher o formulário. Recomendamos deixar algum tipo de mensagem explicando o limite. No entanto, se você ainda quiser remover completamente a mensagem que aparece, use este snippet em vez disso.

/**
 * Remove the text for the character and word limit.
 *
 * @link https://wpforms.com/developers/how-to-change-the-limit-character-validation-text/
 */
 
function wpf_dev_frontend_strings( $strings ) {
     
    // val_limit_words when using words
    // val_limit_characters when using characters   
     
    // Change the message that will appear to your visitors after the = sign below
    $strings[ 'val_limit_words' ] = '';
    $strings[ 'val_limit_characters' ] = '';
    return $strings;
}
 
add_filter( 'wpforms_frontend_strings' , 'wpf_dev_frontend_strings', 10, 1 );