Descrição

O wpforms_field_properties é ativado no carregamento do formulário para apresentar as propriedades do campo, como rótulos, subrótulos e descrições, acima do campo do formulário.

Parâmetros

$propriedades
(matriz) Uma matriz de propriedades de campo, tais como etiquetas, sub-rótulos e descrição.
$campo
(matriz) Dados de campo higienizados.
$form_data
(matriz) Definições/dados de formulários processados, preparados para serem utilizados posteriormente.

Fonte

wpforms/includes/fields/class-base.php

Mais informações

O filtro é aplicado a uma matriz para propriedades específicas do campo do formulário. A utilização deste filtro irá alterar todos os campos do formulário.

Cada campo de formulário terá o seu próprio nome de filtro exclusivo. Consulte a secção abaixo para obter uma lista completa de exemplos documentados. Por exemplo, se apenas pretender alterar o campo Correio eletrónico campo de formulário, usaria wpforms_field_properties_email.

Exemplos

No exemplo abaixo, a função fará com que o campo Descrição seja apresentado por cima do próprio campo, mas apenas para o ID de 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