Atenção!

Este artigo contém código PHP e destina-se a desenvolvedores. Oferecemos este código como uma cortesia, mas não fornecemos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação extra, consulte o tutorial do WPBeginner sobre como adicionar código personalizado.

Dispensar

Descrição

O wpforms_checkbox_field_display é acionado ao carregar o formulário para exibir os atributos do campo, como rótulo e descrição.

Parâmetros

$field
(array) Dados de campo sanitizados.
$field_atts
(array) Um array de atributos do campo, como rótulo e descrição.
$form_data
(array) Configurações/dados do formulário processados, preparados para uso posterior.

Fonte

wpforms/includes/fields/class-base.php

Mais Informações

Este filtro é aplicado a um array de atributos de campo do formulário. Cada campo do formulário terá seu próprio nome exclusivo. Para mais informações e exemplos, por favor, revise este tutorial em snippet.

Exemplos

Neste exemplo, estamos usando este filtro para permitir que as Smart Tags do WPForms sejam usadas em todos os rótulos de campo do 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