Você gostaria de alterar os subtítulos do campo Endereço no WPForms? Esses subtítulos permitem que os usuários saibam que tipo de informação se espera que o usuário preencha. Neste tutorial, mostraremos a você como alterar esses subtítulos usando PHP.
Por padrão, o campo do formulário Address exibirá campos adicionais. Cada um desses campos tem seus próprios rótulos, chamados de subrótulos.
Criando o formulário
Começaremos criando o formulário e adicionando nossos campos, que incluirão o campo de formulário Address.
Se precisar de ajuda para criar seu formulário, consulte esta documentação.
Alterar os subtítulos de endereço
Agora é hora de adicionar o snippet ao seu site.
Se precisar de ajuda para saber onde e como adicionar snippets ao seu site, consulte este tutorial.
Somente no esquema de endereços dos EUA
O trecho de código abaixo permitirá que você altere as sublinhas no campo Address (Endereço ) para o esquema dos EUA.
/**
* Change the sublabels for the Address field for the US Address Scheme.
*
* @link https://wpforms.com/developers/how-to-change-the-address-field-sublabels/
*/
function wpf_dev_address_field_properties_usa( $properties, $field, $form_data ) {
// check for address scheme
if ( $field[ 'scheme' ] === 'us' ){
// Change sublabel values
$properties[ 'inputs' ][ 'address1' ][ 'sublabel' ][ 'value' ] = __( 'Street Address' );
$properties[ 'inputs' ][ 'address2' ][ 'sublabel' ][ 'value' ] = __( 'Apartment #' );
$properties[ 'inputs' ][ 'city' ][ 'sublabel' ][ 'value' ] = __( 'City' );
$properties[ 'inputs' ][ 'state' ][ 'sublabel' ][ 'value' ] = __( 'State' );
$properties[ 'inputs' ][ 'postal' ][ 'sublabel' ][ 'value' ] = __( 'Zip' );
}
return $properties;
}
add_filter( 'wpforms_field_properties_address', 'wpf_dev_address_field_properties_usa', 10, 3 );
Somente esquema de endereço internacional
O trecho de código abaixo permitirá que você altere as sublinhas no campo Address (Endereço ) para o esquema Internacional.
/**
* Change the sublabels for the Address field for the International Address Scheme.
*
* @link https://wpforms.com/developers/how-to-change-the-address-field-sublabels/
*/
function wpf_dev_address_field_properties_international( $properties, $field, $form_data ) {
// check for address scheme
if ( $field['scheme'] === 'international' ){
// Change sublabel values
$properties[ 'inputs' ][ 'address1' ][ 'sublabel' ][ 'value' ] = __( 'Address' );
$properties[ 'inputs' ][ 'address2' ][ 'sublabel' ][ 'value' ] = __( 'Apartment / Suite #' );
$properties[ 'inputs' ][ 'city' ][ 'sublabel' ][ 'value' ] = __( 'City' );
$properties[ 'inputs' ][ 'state' ][ 'sublabel' ][ 'value' ] = __( 'State / Province / Region' );
$properties[ 'inputs' ][ 'postal' ][ 'sublabel' ][ 'value' ] = __( 'Postal Code' );
$properties[ 'inputs' ][ 'country' ][ 'sublabel' ][ 'value' ] = __( 'Country' );
}
return $properties;
}
add_filter( 'wpforms_field_properties_address', 'wpf_dev_address_field_properties_international', 10, 3 );
E é isso! Gostaria de criar esquemas de endereço adicionais para serem usados em seu campo Address? Dê uma olhada em nosso artigo sobre Como criar esquemas adicionais para o campo de endereço.
Filtro de referência
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.
/**
* Change the sublabels for the Address field for the US Address Scheme.
*
* @link https://wpforms.com/developers/how-to-change-the-address-field-sublabels/
*/
function wpf_dev_address_field_properties_usa( $properties, $field, $form_data ) {
// Only process this snippet on the form ID 123
if ( absint( $form_data[ 'id' ] ) !== 123 ) {
return $properties;
}
// check for address scheme
if ( $field[ 'scheme' ] === 'us' ){
// Change sublabel values
$properties[ 'inputs' ][ 'address1' ][ 'sublabel' ][ 'value' ] = __( 'Street Address' );
$properties[ 'inputs' ][ 'address2' ][ 'sublabel' ][ 'value' ] = __( 'Apartment #' );
$properties[ 'inputs' ][ 'city' ][ 'sublabel' ][ 'value' ] = __( 'City' );
$properties[ 'inputs' ][ 'state' ][ 'sublabel' ][ 'value' ] = __( 'State' );
$properties[ 'inputs' ][ 'postal' ][ 'sublabel' ][ 'value' ] = __( 'Zip' );
}
return $properties;
}
add_filter( 'wpforms_field_properties_address' , 'wpf_dev_address_field_properties_usa', 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.