How to Change the Address Field Sublabels

Afficher Markdown

Souhaitez-vous modifier les sous-libellés du champ Adresse dans WPForms ? Ces sous-libellés indiquent aux utilisateurs le type d'informations qu'ils doivent saisir. Dans ce tutoriel, nous vous expliquerons comment modifier ces sous-libellés à l'aide de PHP.

Par défaut, le champ de formulaire Adresse affichera des champs supplémentaires. Chacun de ces champs a ses propres libellés appelés sous-libellés.

Par défaut, le champ de formulaire Adresse inclura des champs supplémentaires. Chacun de ces champs a ses propres libellés appelés sous-libellés.

Création du formulaire

Nous commencerons par créer le formulaire et ajouter nos champs, y compris le champ de formulaire Adresse.

Si vous avez besoin d'aide pour créer votre formulaire, veuillez consulter cette documentation.

créer le formulaire et ajouter vos champs

Modification des sous-libellés d'adresse

Il est maintenant temps d'ajouter le extrait de code à votre site.

Si vous avez besoin d'aide pour savoir où et comment ajouter des extraits de code à votre site, veuillez consulter ce tutoriel.

Schéma d'adresse US uniquement

L'extrait de code ci-dessous vous permettra de modifier les sous-libellés de votre champ Adresse pour le schéma US.

/**
 * 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 );

Schéma d'adresse international uniquement

L'extrait de code ci-dessous vous permettra de modifier les sous-libellés de votre champ Adresse pour le schéma International.

/**
 * 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 );

vous pouvez maintenant modifier les sous-libellés du champ adresse comme vous le souhaitez

Et voilà ! Souhaitez-vous créer des schémas d'adresse supplémentaires à utiliser dans votre champ Adresse ? Consultez notre article sur Comment créer des schémas supplémentaires pour le champ Adresse.

Filtre de référence

wpforms_field_properties

FAQ

Q : Puis-je modifier cela pour un seul formulaire ?

R : Absolument, si vous souhaitez uniquement modifier ces sous-libellés pour un formulaire particulier, utilisez cet extrait de code à la place et n'oubliez pas de mettre à jour l'ID du formulaire 123 pour qu'il corresponde à votre propre ID de formulaire. Si vous avez besoin d'aide pour trouver votre ID de formulaire, veuillez consulter ce guide utile.

/**
 * 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 );

Comme vous pouvez le voir dans l'extrait de code, tout ce que nous avons à faire est d'ajouter la vérification de l'ID du formulaire avec if ( absint( $form_data[ 'id' ] ) !== 123 ) { return $properties; } , le reste de l'extrait de code reste identique à l'exemple avec tous les formulaires.

Comment modifier les sous-libellés du champ Adresse

Résumé IA