Descripción

En wpforms_field_properties se activa al cargar el formulario para mostrar las propiedades del campo, como etiquetas, subetiquetas y descripciones, encima del campo de formulario.

Parámetros

$propiedades
(matriz) Una matriz de propiedades de campo como etiquetas, subetiquetas y descripción.
$campo
(array) Datos de campo saneados.
$form_data
(array) Ajustes/datos del formulario procesados, preparados para su uso posterior.

Fuente

wpforms/includes/fields/class-base.php

Más información

El filtro se aplica a un array para propiedades específicas de campos de formulario. El uso de este filtro cambiará cada campo de formulario.

Cada campo de formulario tendrá su propio nombre de filtro único. Consulte la sección siguiente para ver una lista completa de ejemplos documentados. Por ejemplo, si sólo desea cambiar el filtro Correo electrónico utilizaría wpforms_field_properties_email.

Ejemplos

En el ejemplo siguiente, la función mostrará la Descripción del campo encima del propio campo, pero sólo para el ID de formulario 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 );

Artículos de referencia