Description
Filtre l'édition du message de confirmation pour l'ensemble du site.
Paramètres
- $message
- (chaîne) (obligatoire) Message de confirmation, y compris les Smart Tags traités.
- $form_data
- (array) (obligatoire) Paramètres/données du formulaire traités, préparés pour être utilisés ultérieurement.
- $fields
- (tableau) (obligatoire) Données de terrain assainies.
- $entry_id
- (int) (Obligatoire) Identifiant de l'entrée.
Source
wpforms/src/Frontend/Frontend.php
Plus d'informations
Le filtre est appliqué à tous les formulaires qui affichent un message de confirmation. Il peut être utilisé pour modifier ou remplacer le message de confirmation affiché, en remplaçant le contenu du message défini dans le générateur de formulaires.
Exemples
L'exemple ci-dessous permet de saisir le nom de l'utilisateur qui a rempli le formulaire, puis de personnaliser le message de confirmation.
N'oubliez pas de changer l'ID du formulaire de 25 pour qu'il corresponde à l'identifiant spécifique du formulaire sur lequel vous souhaitez exécuter votre code. Si vous supprimez cette vérification, le code sera exécuté pour tous les formulaires.
/**
* 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 );