Introdução
Gostaria de alterar os subtítulos do campo Nome nos seus formulários? Usando um pequeno trecho de PHP, isso é muito fácil de fazer.
No WPForms, o campo Nome pode ser exibido em três formatos:
- Simples (apresenta um único campo, sem sub-rótulos)
- Primeiro Último
- Primeiro Médio Último
Neste tutorial, mostraremos o básico sobre como alterar os subtítulos usando um trecho de código PHP.
Criar o formulário
Vamos começar por criar o nosso formulário e adicionar o campo que incluirá o campo Nome.
Se precisar de ajuda para criar o seu formulário, consulte esta documentação.
Adicionar o snippet
Para alterar os subtítulos no campo de endereço, precisamos de adicionar este snippet ao nosso site.
Se precisar de ajuda sobre como e onde adicionar snippets ao seu site, consulte este tutorial.
/**
* Customize name field properties.
*
* @link https://wpforms.com/developers/how-to-change-sublabels-for-the-name-field/
*/
function wpf_dev_name_field_properties( $properties, $field, $form_data ) {
// Change sublabel values
$properties[ 'inputs' ][ 'first' ][ 'sublabel' ][ 'value' ] = __( 'First Name', 'plugin-domain' );
$properties[ 'inputs' ][ 'middle' ][ 'sublabel' ][ 'value' ] = __( 'Middle Initial', 'plugin-domain' );
$properties[ 'inputs' ][ 'last' ][ 'sublabel' ][ 'value' ] = __( 'Last Name', 'plugin-domain' );
return $properties;
}
add_filter( 'wpforms_field_properties_name' , 'wpf_dev_name_field_properties', 10, 3 );
Este snippet irá alterar todos os subtítulos de todos os formulários.
E já está! Alterou com êxito os subtítulos do campo Nome! Gostaria de alterar o símbolo de campo obrigatório nos campos obrigatórios? Consulte o nosso artigo sobre Como alterar o indicador de campo obrigatório.
Relacionadas
Referência do filtro: wpforms_field_properties
FAQ
P: Posso alterá-las apenas para um formulário?
R: Sem dúvida, se apenas pretender alterar estes subtítulos para um formulário específico, utilize este snippet e lembre-se de atualizar o ID do formulário 123 para corresponder ao seu próprio ID do formulário. Se precisar de ajuda para encontrar o ID do formulário, consulte este guia útil.
/**
* Customize name field properties.
*
* @link https://wpforms.com/developers/how-to-change-sublabels-for-the-name-field/
*/
function wpf_dev_name_field_properties( $properties, $field, $form_data ) {
// Only process this snippet on the form ID 123
if ( absint( $form_data[ 'id' ] ) !== 123 ) {
return $properties;
}
// Change sublabel values
$properties[ 'inputs' ][ 'first' ][ 'sublabel' ][ 'value' ] = __( 'First Name', 'plugin-domain' );
$properties[ 'inputs' ][ 'middle' ][ 'sublabel' ][ 'value' ] = __( 'Middle Initial', 'plugin-domain' );
$properties[ 'inputs' ][ 'last' ][ 'sublabel' ][ 'value' ] = __( 'Last Name', 'plugin-domain' );
return $properties;
}
add_filter( 'wpforms_field_properties_name' , 'wpf_dev_name_field_properties', 10, 3 );
Como pode ver no snippet, tudo o que precisamos de fazer é adicionar a verificação do ID do formulário com if ( absint( $form_data[ 'id' ] ) !== 123 ) { return $properties; } O resto do snippet permanece exatamente o mesmo que o exemplo com todos os formulários.