Descrizione

Il wpforms_field_properties si attiva al caricamento del modulo per visualizzare le proprietà del campo, come etichette, sottoetichette e descrizioni, sopra il campo del modulo.

Parametri

$proprietà
(array) Un array di proprietà dei campi, come etichette, sottoetichette e descrizione.
$campo
(array) Dati di campo sanificati.
$form_data
(array) Impostazioni/dati del modulo elaborati, preparati per essere utilizzati in seguito.

Fonte

wpforms/includes/fields/class-base.php

Ulteriori informazioni

Il filtro viene applicato a una matrice per le proprietà specifiche dei campi del modulo. L'uso di questo filtro modificherà ogni campo del modulo.

Ogni campo del modulo avrà un nome di filtro unico. Per un elenco completo di esempi documentati, consultare la sezione sottostante. Ad esempio, se si volesse modificare solo il campo Email si usa il campo del modulo wpforms_field_properties_email.

Esempi

Nell'esempio seguente, la funzione farà in modo che la Descrizione del campo venga visualizzata sopra il campo stesso, ma solo per l'ID 225 del modulo.

/**
 * 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 );

Articoli di riferimento