¿Desea cambiar las sub-etiquetas del campo Dirección en WPForms? Estas sub-etiquetas permiten a los usuarios saber que tipo de información se espera que el usuario llene. En este tutorial, le mostraremos cómo cambiar estas sub-etiquetas usando PHP.
Por defecto, el campo del formulario Dirección mostrará campos adicionales. Cada uno de esos campos tiene sus propias etiquetas llamadas subetiquetas.
Creación del formulario
Comenzaremos creando el formulario y añadiendo nuestros campos, que incluirán el campo de formulario Dirección.
Si necesita ayuda para crear su formulario, consulte esta documentación.
Modificación de las subetiquetas de dirección
Ahora es el momento de añadir el fragmento a su sitio.
Si necesita ayuda sobre dónde y cómo añadir fragmentos a su sitio, consulte este tutorial.
Sólo para direcciones de EE.UU.
El siguiente fragmento de código le permitirá cambiar las subetiquetas de su campo Dirección para el esquema de EE.UU.
/**
* 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 );
Sólo para direcciones internacionales
El siguiente fragmento de código le permitirá cambiar las subetiquetas de su campo Dirección para el 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 );
Y ya está. ¿Desea crear esquemas de dirección adicionales para utilizarlos en su campo Dirección? Eche un vistazo a nuestro artículo sobre Cómo crear esquemas adicionales para el campo Dirección.
Filtro de referencia
PREGUNTAS FRECUENTES
P: ¿Puedo cambiarlas sólo para un formulario?
R: Por supuesto, si sólo desea cambiar estas subetiquetas para un formulario en particular, utilice este fragmento en su lugar y recuerde actualizar el ID de formulario 123 para que coincida con su propio ID de formulario. Si necesita ayuda para encontrar su ID de formulario, consulte esta útil guía.
/**
* 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 se puede ver en el fragmento de código, todo lo que tenemos que hacer es añadir la comprobación del ID del formulario con if ( absint( $form_data[ 'id' ] ) !== 123 ) { return $properties; } El resto del fragmento sigue siendo exactamente igual que en el ejemplo con todas las formas.