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

Descrição

O wpforms_html_field_value é aplicado aos valores do campo de entrada em vários sítios. É utilizado para tornar o valor do campo mais visual quando se visualiza o valor de entrada.

Parâmetros

valor

(string) O valor.

$campo

(matriz) O campo.

$form_data

(matriz) Definições/dados de formulários processados, preparados para serem utilizados posteriormente.

$contexto

(string) Utilização do contexto.

Fonte

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

Mais informações

O filtro é utilizado para apresentar um gráfico mais visual na lista de Entradas, em vez de apenas o valor HTML puro que está armazenado na base de dados.

Exemplos

Neste exemplo, queremos incluir descrições de campos dentro das entradas.

/**
 * 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 correio eletrónico
• Como incluir descrições de campos nas notificações por correio eletrónico
• Como tornar os números de telefone numa ligação nas notificações de correio eletrónico
• Como armazenar valores de caixas de seleção como uma matriz