Résumé IA
Description
Message de confirmation des filtres appliqué sur l'ensemble du site.
Paramètres
- $message
- (string) (Requis) Message de confirmation, y compris les balises intelligentes traitées.
- $form_data
- (array) (Requis) Paramètres/données du formulaire traités, préparés pour une utilisation ultérieure.
- $fields
- (array) (Requis) Données de champ nettoyées.
- $entry_id
- (int) (Requis) ID de l'entrée.
Source
wpforms/src/Frontend/Frontend.php
Plus d'informations
Le filtre est appliqué à tous les formulaires configurés pour afficher 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 constructeur de formulaires.
Exemples
L'exemple ci-dessous capture le nom de l'utilisateur qui a rempli le formulaire, puis donne un message plus personnalisé pour le message de confirmation.
N'oubliez pas de changer l'ID du formulaire de 25 pour qu'il corresponde à l'ID spécifique du formulaire sur lequel vous souhaitez exécuter votre code. La suppression de cette vérification s'appliquerait à 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 );