Descrizione
Filtra l'output del messaggio di conferma in tutto il sito.
Parametri
- $messaggio
- (stringa) (Obbligatorio) Messaggio di conferma, compresi gli Smart Tag elaborati.
- $form_data
- (array) (Obbligatorio) Impostazioni/dati del modulo elaborati, preparati per essere utilizzati in seguito.
- $campi
- (array) (obbligatorio) Dati di campo sanificati.
- $entry_id
- (int) (Richiesto) Id della voce.
Fonte
wpforms/src/Frontend/Frontend.php
Ulteriori informazioni
Il filtro viene applicato a tutti i moduli impostati per visualizzare un messaggio di conferma. Può essere utilizzato per modificare o sostituire il messaggio di conferma visualizzato, sovrascrivendo il contenuto del messaggio impostato nel costruttore del modulo.
Esempi
L'esempio mostrato di seguito cattura il nome dell'utente che ha compilato il modulo e poi fornisce un messaggio più personalizzato per il messaggio di conferma.
Ricordarsi di cambiare l'ID del modulo da 25 per far corrispondere l'ID del modulo specifico su cui si vuole eseguire il codice. Rimuovendo questo controllo, il codice verrà eseguito per tutti i moduli.
/**
* 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 );