How to Change the Address Field Sublabels

Ver Markdown

¿Te gustaría cambiar las subetiquetas del campo Dirección en WPForms? Estas subetiquetas indican a los usuarios qué tipo de información se espera que introduzcan. En este tutorial, te mostraremos cómo cambiar estas subetiquetas usando PHP.

Por defecto, el campo de formulario Dirección mostrará campos adicionales. Cada uno de esos campos tiene sus propias etiquetas, llamadas subetiquetas.

Por defecto, el campo de formulario Dirección incluirá 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 necesitas ayuda para crear tu formulario, consulta esta documentación.

crea el formulario y añade tus campos

Cambiar las subetiquetas de dirección

Ahora es el momento de añadir el fragmento a tu sitio.

Si necesitas ayuda sobre dónde y cómo añadir fragmentos a tu sitio, revisa este tutorial.

Solo esquema de dirección de EE. UU.

El siguiente fragmento de código te permitirá cambiar las subetiquetas de tu 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 );

Solo esquema de dirección internacional

El siguiente fragmento de código te permitirá cambiar las subetiquetas de tu 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 );

ahora puedes cambiar las subetiquetas del campo de dirección por lo que quieras

¡Y eso es todo! ¿Te gustaría crear esquemas de dirección adicionales para usar en tu campo Dirección? Echa un vistazo a nuestro artículo sobre Cómo crear esquemas adicionales para el campo de dirección.

Filtro de Referencia

wpforms_field_properties

Preguntas frecuentes

P: ¿Puedo cambiar esto solo para un formulario?

R: Absolutamente, si solo desea cambiar estas subetiquetas para un formulario en particular, use este fragmento en su lugar y recuerde actualizar el ID del formulario 123 para que coincida con su propio ID de formulario. Si necesita ayuda para encontrar su ID de formulario, revise 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 puede ver en el fragmento, todo lo que necesitamos hacer es agregar la verificación del ID del formulario con if ( absint( $form_data[ 'id' ] ) !== 123 ) { return $properties; } , el resto del fragmento sigue siendo exactamente igual que el ejemplo con todos los formularios.

Cómo cambiar las subetiquetas del campo de dirección

Resumen de IA