Descrição

O wpforms_checkbox_field_display dispara no carregamento do formulário para exibir os atributos do campo, como rótulo e descrição.

Parâmetros

$campo
(matriz) Dados de campo higienizados.
$field_atts
(array) Um array de atributos de campo, como rótulo e descrição.
$form_data
(array) Configurações/dados de formulários processados, preparados para serem usados posteriormente.

Fonte

wpforms/includes/fields/class-base.php

Mais informações

Esse filtro é aplicado a uma matriz de atributos de campo de formulário. Cada campo de formulário terá seu próprio nome exclusivo. Para obter mais informações e exemplos, consulte este tutorial de snippet.

Exemplos

Neste exemplo, estamos usando esse filtro para permitir que as Smart Tags do WPForms sejam usadas em cada rótulo de campo de formulário Checkbox.

/**
 * Using Smart Tags in Checkbox field labels.
 *
 * @link https://wpforms.com/developers/wpforms_checkbox_field_display/
 */
 
function wpf_dev_checkbox_choices_process_smarttags( $field, $deprecated, $form_data ) {

    foreach ( $field[ 'choices' ] as $key => $choice ) {

        if ( ! empty( $choice[ 'label' ] ) ) {

            $field[ 'choices' ][ $key ][ 'label' ] = apply_filters( 'wpforms_process_smart_tags', $choice[ 'label' ], $form_data );

        }

    }

    return $field;
}
add_filter( 'wpforms_checkbox_field_display', 'wpf_dev_checkbox_choices_process_smarttags', 10, 3 );

Artigos de referência