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

Descrição

The wpforms_html_field_value filter is applied to entry field values in various places. It’s used to make the field value more visual when viewing the entry value.

Parâmetros

$value

(string) The value.

$field

(array) The field.

$form_data

(array) Configurações/dados do formulário processados, preparados para uso posterior.

$context

(string) Context usage.

Fonte

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

Mais Informações

The filter is used to display a more visual graphic in the Entries list rather than just the pure HTML value that is stored in the database.

Exemplos

In this example, we want to include field descriptions inside entries.

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

Artigos de Referência

• Como Exibir Entradas de Formulário
• Como Ocultar o Valor do Preço do Item nas Notificações por E-mail
• Como Incluir Descrições de Campo Dentro das Notificações por E-mail
• Como Tornar Números de Telefone um Link nas Notificações por E-mail
• Como Armazenar Valores de Caixa de Seleção como um Array