Como alterar o texto de validação do carácter limite

Tem curiosidade em alterar o texto do limite de caracteres apresentado por baixo dos seus campos de formulário, especialmente quando utiliza os campos de formulário Limite de caracteres em texto de linha única ou Texto de parágrafo?

Por predefinição, verá uma mensagem por baixo do campo do formulário a indicar a contagem atual de caracteres fora do limite máximo, tal como 0 de 50 caracteres máximos ou 0 de 50 palavras máximas, dependendo das definições do formulário. Pode personalizar esta mensagem para incluir a contagem dos caracteres restantes. Esse ajuste é facilmente realizado com um simples snippet PHP. Neste tutorial, veremos como utilizar o PHP para alterar essa mensagem.

Criar o formulário

Primeiro, precisamos de criar o nosso formulário e adicionar os nossos campos de formulário.

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

Adicionámos um campo de formulário Texto de parágrafo para guardar a nossa mensagem gravada.

Definir o limite de caracteres

Em seguida, selecione o Texto de parágrafo que adicionou e clique no separador Avançadas para ativar a opção Limitar comprimento, definir o limite para 100 e selecionar Caracteres no menu pendente.

Alterar o texto de validação do carácter limite

Agora é altura de adicionar o snippet ao seu site.

Se não tiver a 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 );

E já está! Alterou com êxito o texto do limite de caracteres que aparece por baixo do campo de formulário quando utiliza o limite de caracteres ou de palavras. Também gostaria de ter um número mínimo de caracteres definido para o seu campo de formulário? Dê uma vista de olhos no nosso tutorial sobre Como definir um número mínimo de caracteres num campo de formulário de texto.

Filtro de referência

wpforms_frontend_strings

FAQ

P: Como posso alterar o texto quando utilizo o limite de palavras e não o limite de caracteres?

R: Para alterar o texto do limite do Word, utilize o seguinte fragmento 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 isto para palavras e caracteres numa só função?

R: Sem dúvida! Pode alterar este texto, tanto para palavras como para caracteres, numa única função, utilizando 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: Pode, obviamente, remover esta mensagem. Mas tenha em atenção que, se os visitantes estiverem a escrever e, de repente, não conseguirem escrever mais devido ao limite, isso pode causar confusão ao preencher o formulário. Recomendamos que deixe algum tipo de mensagem a explicar o limite. No entanto, se ainda quiser remover completamente a mensagem que aparece, utilize este snippet.

/**
 * 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 );