apply_filters( 'wpforms_html_field_value', string $value, array $field, array $form_data, string $context );

Description

Le filtre wpforms_html_field_value est appliqué aux valeurs des champs de saisie à divers endroits. Il est utilisé pour rendre la valeur du champ plus visuelle lors de la visualisation de la valeur de la saisie.

Paramètres

$value

(string) La valeur.

$field

(array) Le champ.

$form_data

(array) Paramètres/données du formulaire traités, préparés pour une utilisation ultérieure.

$contexte

(string) Utilisation du contexte.

Source

wpforms_html_field_value

Plus d'informations

Le filtre est utilisé pour afficher un graphique plus visuel dans la liste Saisies plutôt que la simple valeur HTML stockée dans la base de données.

Exemples

Dans cet exemple, nous voulons inclure les descriptions des champs dans les saisies.

/**
 * Filter used to convert a given entry value to a more robust visual format.
 *
 * In this example, if a hex color code is given in a text value, it's converted
 * to a link to view more details about the color.
 *
 * @link  https://wpforms.com/developers/wpforms_html_field_value/
 *
 * @param  string  $value      The value.
 * @param  array   $field      The field.
 * @param  array   $form_data  Processed form settings/data, prepared to be used later.
 * @param  string  $context    Context usage.
 *
 * @return string 
 */

function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
     
    if ( $context !== 'email-html' ) {
        return $field_val;
    }
 
    if ( $field['type'] !== 'name' ) {
        return $field_val;
    }
 
    if ( empty( $form_data[ 'fields' ][$field[ 'id' ]] ) ) {
        return $field_val;
    }
 
    $field_data = $form_data[ 'fields' ][$field[ 'id' ]];
 
    if ( empty( $field_data[ 'description' ] ) ) {
        return $field_val;
    }
 
    return $field_val . '<br><br>' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );

Articles de référence

• Comment afficher les entrées du formulaire
• Comment masquer la valeur du prix de l'article dans les notifications par e-mail
• Comment inclure les descriptions de champ dans les notifications par e-mail
• Comment transformer les numéros de téléphone en lien dans les notifications par e-mail
• Comment stocker les valeurs des cases à cocher sous forme de tableau