Description

Le wpforms_html_field_value est appliqué aux valeurs des champs d'entrée à différents endroits. Il est utilisé pour rendre la valeur du champ plus visuelle lors de l'affichage de la valeur de l'entrée.

Paramètres

valeur
(chaîne) La valeur.
champ
(tableau) Le champ.
$form_data
(tableau) Paramètres/données de formulaire traités, préparés pour être utilisés ultérieurement.
$contexte
(chaîne) Utilisation du contexte.

Source

wpforms/pro/includes/admin/entries/class-entries-single.php

Plus d'informations

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

Exemples

Dans cet exemple, nous voulons inclure des descriptions de champs dans les entrées.

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

En utilisant le filtre wpforms_html_field_value, vous pouvez facilement inclure des descriptions de champs dans vos entrées.

Articles de référence