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

Descrizione

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

Parametri

$properties

(array) Un array di proprietà del campo come etichette, sottoetichette e descrizione.

$field

(array) Dati del campo sanificati.

$form_data

(array) Impostazioni/dati del modulo elaborati, preparati per l'uso successivo.

Origine

wpforms/includes/fields/class-base.php

Maggiori Informazioni

Il filtro viene applicato a un array per le proprietà specifiche di un campo del modulo. L'utilizzo di questo filtro cambierà ogni campo del modulo.

Ogni campo del modulo avrà il proprio nome filtro univoco. Vedi la sezione sottostante per un elenco completo di esempi documentati. Ad esempio, se volessi cambiare solo il campo modulo Email, useresti wpforms_field_properties_email.

Esempi

Nell'esempio seguente, la funzione visualizzerà la Descrizione del campo sopra il campo stesso, ma solo per l'ID del modulo 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 );

Articoli di riferimento

• Come posizionare la descrizione del campo sopra il campo del modulo
• Come cambiare le sottoetichette per il campo Email
• Come elaborare gli Smart Tag nei campi HTML
• Come cambiare le sottoetichette per il campo Nome
• Come cambiare le sottoetichette del campo Indirizzo
• Come modificare le etichette secondarie del campo password
• Come cambiare l'attributo Name di un campo Nascosto