apply_filters( 'wpforms_field_properties', array $properties, array $field, array $form_data)

Descrição

O filtro wpforms_field_properties é acionado no carregamento do formulário para exibir as propriedades do campo, como rótulos, sub-rótulos e descrições acima do campo do formulário.

Parâmetros

$properties

(array) Um array de propriedades de campo, como rótulos, sub-rótulos e descrição.

$field

(array) Dados de campo sanitizados.

$form_data

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

Fonte

wpforms/includes/fields/class-base.php

Mais Informações

O filtro é aplicado a um array para propriedades específicas do campo do formulário. Usar este filtro alterará todos os campos do formulário.

Cada campo do formulário terá seu próprio nome de filtro exclusivo. Veja a seção abaixo para uma lista completa de exemplos documentados. Por exemplo, se você quisesse alterar apenas o campo do formulário Email, você usaria wpforms_field_properties_email.

Exemplos

No exemplo abaixo, a função fará com que a Descrição do campo seja exibida acima do próprio campo, mas apenas para o ID do formulário 225.

/**
 * Move the field description above the form field.
 *
 * @link   https://wpforms.com/developers/wpforms_field_properties/
 *
 * @param  array $properties Field properties.
 * @param  array $field      Field settings.
 * @param  array $form_data  Form data and settings.
 *
 * @return array
 */

function wpf_dev_field_properties( $properties, $field, $form_data ) {

    // Only process this snippet on the form ID 225
    if ( absint( $form_data[ 'id' ] ) !== 225 ) {

        return $properties;
    } 

    // move the field description from under the form field to above the form field
    $properties[ 'description' ][ 'position' ] = 'before';

    return $properties;

}
add_filter( 'wpforms_field_properties', 'wpf_dev_field_properties', 10, 3 );

Artigos de Referência

• Como Posicionar a Descrição do Campo Acima do Campo do Formulário
• Como Alterar Sub-rótulos para o Campo de Email
• Como Processar Smart Tags em Campos HTML
• Como Alterar Sub-rótulos para o Campo de Nome
• Como Alterar os Subrótulos do Campo de Endereço
• Como Alterar os Subtítulos do Campo de Senha
• Como Alterar o Atributo Name de um Campo Oculto