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

Beschreibung

Der wpforms_field_properties Filter wird beim Laden des Formulars ausgelöst, um die Feld-Eigenschaften wie Bezeichnungen, Unterbezeichnungen und Beschreibungen über dem Formularfeld anzuzeigen.

Parameter

$properties

(array) Ein Array von Feld-Eigenschaften wie Bezeichnungen, Unterbezeichnungen und Beschreibung.

$field

(array) Bereinigte Felddaten.

$form_data

(array) Verarbeitete Formulareinstellungen/Daten, die zur späteren Verwendung vorbereitet sind.

Quelle

wpforms/includes/fields/class-base.php

Weitere Informationen

Der Filter wird auf ein Array für spezifische Formularfeldeigenschaften angewendet. Die Verwendung dieses Filters ändert jedes Formularfeld.

Jedes Formularfeld hat seinen eigenen eindeutigen Filternamen. Eine vollständige Liste der dokumentierten Beispiele finden Sie im Abschnitt unten. Wenn Sie beispielsweise nur das Formularfeld E-Mail ändern möchten, würden Sie wpforms_field_properties_email verwenden.

Beispiele

Im folgenden Beispiel wird die Funktion die Beschreibung des Feldes über dem Feld selbst anzeigen, aber nur für die Formular-ID 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 );

Referenzartikel

• So positionieren Sie die Feld-Beschreibung über dem Formularfeld
• So ändern Sie Unterbezeichnungen für das E-Mail-Feld
• So verarbeiten Sie Smart Tags in HTML-Feldern
• So ändern Sie Unterbeschriftungen für das Namensfeld
• Ändern der Unterbeschriftungen des Adressfelds
• So ändern Sie die Unterbeschriftungen des Passwortfelds
• So ändern Sie das Namensattribut eines versteckten Feldes