apply_filters( 'wpforms_pro_fields_entry_preview_get_field_value_show_empty', bool $show, array $field, array $form_data )

Descrição

O filtro wpforms_pro_fields_entry_preview_get_field_value_show_empty permite controlar se os campos vazios são incluídos na Pré-visualização da Entrada. Pode utilizá-lo para ocultar campos que não têm valor, para que não apareçam na pré-visualização.

Parâmetros

$show

(bool) (Obrigatório) Determina se os campos com valores vazios devem ser exibidos na Pré-visualização da Entrada. O valor padrão é true

$campo

(array) (Obrigatório) Dados do campo.

$form_data

(array) (Obrigatório) Dados do formulário.

Origem

wpforms/pro/includes/fields/class-entry-preview.php

Mais Informações

Este filtro é executado para campos que estão vazios na Pré-visualização da Entrada. Por defeito, os campos vazios ainda são mostrados porque o valor $show é true. Se retornar false deste filtro, o campo vazio será ocultado da Pré-visualização da Entrada. Pode utilizá-lo para ocultar campos vazios globalmente ou condicionalmente para campos específicos.

Exemplo

Utilize este exemplo para ocultar campos vazios na Pré-visualização da Entrada e também para tratar campos de Item Único de Pagamento com quantidade zero como vazios, para que também sejam removidos da pré-visualização.

add_filter( 'wpforms_pro_fields_entry_preview_get_field_value_payment-single_field', function( $value, $field, $form_data ) {
    // Single Item fields with Quantity enabled: we check if quantity is zero e.g, $10.00 × 0.
    // This is the exact substring that indicates a quantity of zero bcoz the multiplication sign is an HTML entity.
    $substring_to_check = '× 0';
 
    // We use strpos() for maximum compatibility to check if the substring exists.
    if ( strpos( $value, $substring_to_check ) !== false ) {
        // Return an empty string so the field is considered empty in the preview.
        return '';
    }
	
    // Otherwise, return it unchanged.
    return $value;
 
}, 10, 3 );

add_filter( 'wpforms_pro_fields_entry_preview_get_field_value_show_empty', function( $show, $field, $form_data ) {
    
    // Hide empty fields in Entry Preview.
    return false;
}, 10, 3 );