Achtung!

Dieser Artikel enthält PHP-Code und richtet sich an Entwickler. Wir stellen diesen Code als Service zur Verfügung, bieten jedoch keine Unterstützung für Codeanpassungen oder die Entwicklung durch Dritte.

Für zusätzliche Hilfe siehe das Tutorial von WPBeginner zum Hinzufügen von benutzerdefiniertem Code.

Schließen

Beschreibung

Filter-Bestätigungsnachrichtenausgabe seitenweit.

Parameter

$message
(string) (Erforderlich) Bestätigungsnachricht, einschließlich verarbeiteter Smart Tags.
$form_data
(array) (Erforderlich) Verarbeitete Formulareinstellungen/-daten, die zur späteren Verwendung vorbereitet sind.
$fields
(array) (Erforderlich) Bereinigte Feld-Daten.
$entry_id
(int) (Erforderlich) Eintrag-ID.

Quelle

wpforms/src/Frontend/Frontend.php

Weitere Informationen

Der Filter wird auf alle Formulare angewendet, die so eingestellt sind, dass sie eine Bestätigungsnachricht anzeigen. Er kann verwendet werden, um den Inhalt der Bestätigungsnachricht zu ändern oder zu ersetzen, wobei die im Formular-Builder festgelegten Nachrichten überschrieben werden.

Beispiele

Das unten gezeigte Beispiel erfasst den Benutzernamen, der das Formular ausgefüllt hat, und gibt dann eine persönlichere Nachricht für die Bestätigungsnachricht aus.

Denken Sie daran, die Formular-ID von 25 zu ändern, damit sie mit der spezifischen Formular-ID übereinstimmt, auf die Sie Ihren Code anwenden möchten. Wenn Sie diese Prüfung entfernen, würde sie für alle Formulare ausgeführt werden.

/**
 * Filters confirmation message output site-wide.
 *
 * @link   https://wpforms.com/developers/wpforms_frontend_confirmation_message/
 * 
 * @param  string   $message     Confirmation message including Smart Tags.
 * @param  array    $form_data   Form data and settings.
 * @param  array    $fields      Sanitized field data.
 * @param  int      $entry_id    Entry ID.
 *
 * @return string
 */

function wpf_dev_frontend_confirmation_message( $message, $form_data, $fields, $entry_id ) {
    
    // Only run on my form with ID = 25
    if ( absint( $form_data[ 'id' ] ) !== 25 ) {
            return $message;
        } 

    // also it is possible to access the first, middle, and the last name as follows inplace of [ 'value' ]
    //  $contact_name = $fields[ '0' ][ 'first' ]; - this will pass in the first name
    //  $contact_name = $fields[ '0' ][ 'last' ]; - this will pass in the last name
    //  $contact_name = $fields[ '0' ][ 'middle' ]; - this will pass in the middle name in the format First Middle Last
         
    // Get the name field ID '0' to set the name for the message
    $contact_name = $fields[ '0' ][ 'value' ];
    
    // Add the name to the message
    $message = __('Thanks ' . $contact_name .  ' we will be in touch!', 'plugin-domain');
    return $message;
     
}
add_filter( 'wpforms_frontend_confirmation_message', 'wpf_dev_frontend_confirmation_message', 10, 4 );

Referenzartikel