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

Descrizione

Il filtro wpforms_html_field_value viene applicato ai valori dei campi delle voci in vari punti. Viene utilizzato per rendere il valore del campo più visivo quando si visualizza il valore della voce.

Parametri

$value

(string) Il valore.

$field

(array) Il campo.

$form_data

(array) Impostazioni/dati del modulo elaborati, preparati per l'uso successivo.

$context

(string) Utilizzo del contesto.

Origine

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

Maggiori Informazioni

Il filtro viene utilizzato per visualizzare una grafica più visiva nell'elenco Voci piuttosto che il puro valore HTML memorizzato nel database.

Esempi

In questo esempio, vogliamo includere le descrizioni dei campi all'interno delle voci.

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

Articoli di riferimento

• Come visualizzare le voci del modulo
• Come nascondere il valore del prezzo dell'articolo nelle notifiche email
• Come includere le descrizioni dei campi nelle notifiche email
• Come rendere i numeri di telefono un link nelle notifiche email
• Come archiviare i valori delle caselle di controllo come array