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

Descripción

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

Parámetros

$properties

(array) Una matriz de propiedades del campo, como etiquetas, subetiquetas y descripción.

$campo

(array) Datos del campo saneados.

$form_data

(array) Configuración/datos del formulario procesados, preparados para ser utilizados más adelante.

Origen

wpforms/includes/fields/class-base.php

Más Información

El filtro se aplica a una matriz para propiedades específicas del campo del formulario. Usar este filtro cambiará todos los campos del formulario.

Cada campo del formulario tendrá su propio nombre de filtro único. Consulte la sección a continuación para obtener una lista completa de ejemplos documentados. Por ejemplo, si solo quisiera cambiar el campo del formulario de Correo electrónico, usaría wpforms_field_properties_email.

Ejemplos

En el siguiente ejemplo, la función mostrará la Descripción del campo encima del propio campo, pero solo 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

• Cómo posicionar la descripción del campo encima del campo del formulario
• Cómo cambiar las subetiquetas para el campo de correo electrónico
• Cómo procesar etiquetas inteligentes en campos HTML
• Cómo cambiar las subetiquetas para el campo Nombre
• Cómo cambiar las subetiquetas del campo de dirección
• Cómo cambiar las subetiquetas del campo de contraseña
• Cómo cambiar el atributo de nombre de un campo oculto