Atenção!

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

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

Dispensar

Como alterar os subtítulos do campo Name

Introdução

Gostaria de alterar os subtítulos do campo Nome em 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 (exibe um único campo, portanto, sem subtítulos)
  • Primeiro Último
  • Nome Meio Sobrenome

Neste tutorial, mostraremos os princípios básicos de como você pode alterar os subtítulos usando um trecho de código PHP.

Criando o formulário

Começaremos criando nosso formulário e adicionando o campo que incluirá o campo Nome.

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

Selecionar formato para o campo Nome no WPForms

Adicionando o snippet

Para alterar os subtítulos no campo de endereço, precisaremos adicionar este snippet ao nosso site.

Se precisar de ajuda para saber 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 );

Esse snippet alterará todos os subtítulos de todos os formulários.

Usando esse snippet, agora você pode alterar os subtítulos no campo de nome

E é isso! Você alterou com êxito os subtítulos no campo Nome! Você gostaria de alterar o símbolo de campo obrigatório nos campos obrigatórios? Dê uma olhada em nosso artigo sobre Como alterar o indicador de campo obrigatório.

Referência do filtro: wpforms_field_properties

PERGUNTAS FREQUENTES

P: Posso alterá-los para apenas um formulário?

R: Com certeza, se você quiser alterar esses subtítulos apenas para um formulário específico, use esse 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 você pode ver no snippet, tudo o que precisamos fazer é adicionar a verificação do ID do formulário com if ( absint( $form_data[ 'id' ] ) !== 123 ) { return $properties; } Se você não tiver um formulário, o restante do snippet permanecerá exatamente igual ao exemplo com todos os formulários.