KI-Zusammenfassung
Beschreibung
Der wpforms_html_field_value Filter wird an verschiedenen Stellen auf die Werte von Formularfeldern angewendet. Er wird verwendet, um den Feldwert beim Anzeigen des Eintrags visueller zu gestalten.
Parameter
- $value
- (string) Der Wert.
- $field
- (array) Das Feld.
- $form_data
- (array) Verarbeitete Formulareinstellungen/Daten, die zur späteren Verwendung vorbereitet sind.
- $context
- (string) Kontextnutzung.
Quelle
wpforms/pro/includes/admin/entries/class-entries-single.php
Weitere Informationen
Der Filter wird verwendet, um in der Eintragsliste eine visuell ansprechendere Darstellung anstelle des reinen HTML-Werts, der in der Datenbank gespeichert ist, anzuzeigen.
Beispiele
In diesem Beispiel möchten wir Feld-Beschreibungen in die Einträge aufnehmen.
/**
* Filter used to convert a given entry value to a more robust visual format.
*
* In this example, if a hex color code is given in a text value, it's converted
* to a link to view more details about the color.
*
* @link https://wpforms.com/developers/wpforms_html_field_value/
*
* @param string $value The value.
* @param array $field The field.
* @param array $form_data Processed form settings/data, prepared to be used later.
* @param string $context Context usage.
*
* @return string
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( $field['type'] !== 'name' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][$field[ 'id' ]] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][$field[ 'id' ]];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '<br><br>' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
