Description

Le wpforms_field_properties se déclenche au chargement du formulaire pour afficher les propriétés du champ, telles que les étiquettes, les sous-étiquettes et les descriptions, au-dessus du champ du formulaire.

Paramètres

Propriétés
(tableau) Un tableau de propriétés de champ telles que les étiquettes, les sous-étiquettes et la description.
champ
(tableau) Données de terrain assainies.
$form_data
(tableau) Paramètres/données de formulaire traités, préparés pour être utilisés ultérieurement.

Source

wpforms/includes/fields/class-base.php

Plus d'informations

Le filtre est appliqué à un tableau de propriétés de champs de formulaire spécifiques. L'utilisation de ce filtre modifiera tous les champs du formulaire.

Chaque champ de formulaire aura son propre nom de filtre. Voir la section ci-dessous pour une liste complète d'exemples documentés. Par exemple, si vous souhaitez uniquement modifier le champ Courriel vous utiliserez wpforms_field_properties_email.

Exemples

Dans l'exemple ci-dessous, la fonction affichera la description du champ au-dessus du champ lui-même, mais uniquement pour le formulaire ID 225.

/**
 * Move the field description above the form field.
 *
 * @link   https://wpforms.com/developers/wpforms_field_properties/
 *
 * @param  array $properties Field properties.
 * @param  array $field      Field settings.
 * @param  array $form_data  Form data and settings.
 *
 * @return array
 */

function wpf_dev_field_properties( $properties, $field, $form_data ) {

    // Only process this snippet on the form ID 225
    if ( absint( $form_data[ 'id' ] ) !== 225 ) {

        return $properties;
    } 

    // move the field description from under the form field to above the form field
    $properties[ 'description' ][ 'position' ] = 'before';

    return $properties;

}
add_filter( 'wpforms_field_properties', 'wpf_dev_field_properties', 10, 3 );

Articles de référence