### [wpforms_process_complete](https://wpforms.com/developers/wpforms_process_complete/) **Publié :** 17 juillet 2020 **Auteur :** Équipe éditoriale **Extrait :** L'action wpforms_process_complete se déclenche à la toute fin du traitement (réussi) d'une soumission de formulaire. **Contenu :** ## Description L'action `wpforms_process_complete` se déclenche à la toute fin du traitement (réussi) d'une soumission de formulaire. ## Paramètres $fields*(tableau)* Valeurs/propriétés des champs de la soumission, nettoyées.$entry*(tableau)* Globale $\_POST originale.$form\_data*(tableau)* Données/paramètres du formulaire traités, préparés pour une utilisation ultérieure.$entry\_id*(entier)* ID de la soumission. Retournera 0 si le stockage des soumissions est désactivé ou si WPForms Lite est utilisé.## Source `wpforms/includes/class-process.php` ## Plus d'informations Le hook `wpforms_process_complete` se déclenche à la toute fin du traitement du formulaire. Il ne se déclenche que si la soumission a réussi et n'a pas contenu d'erreurs. La sauvegarde de la soumission dans la base de données et l'envoi des notifications par e-mail sont effectués avant l'exécution de ce hook. Un choix populaire lors de la création d'intégrations API personnalisées ou lorsque vous avez besoin d'effectuer une action après qu'une soumission a été envoyée avec succès (par exemple, envoyer une notification par e-mail personnalisée, créer un article ou un compte utilisateur, etc.). Une version alternative de ce hook est disponible pour limiter facilement par ID de formulaire, `wpforms_process_complete_{$form_id}`. **Note importante :** Si vous effectuez un traitement et que vous devez pouvoir retourner une erreur et empêcher le traitement du formulaire, utilisez plutôt le hook [wpforms\_process](https://wpforms.com/developers/wpforms_process/ "L'action wpforms_process"). ## Exemples Pour un exemple, [voir l'intégration de votre formulaire de contact avec des services externes par Bill Erickson](https://www.billerickson.net/contact-form-integration/ "Intégration de votre formulaire de contact avec des services externes"). N'oubliez pas de changer l'ID de votre formulaire de `5` à l'ID du formulaire que vous ciblez. ``` /** * Ceci se déclenchera à la toute fin d'une soumission de formulaire (réussie). * * @link https://wpforms.com/developers/wpforms_process_complete/ * * @param array $fields Valeurs/propriétés des champs de la soumission, nettoyées. * @param array $entry Globale $_POST originale. * @param array $form_data Données et paramètres du formulaire. * @param int $entry_id ID de la soumission. Retournera 0 si le stockage des soumissions est désactivé ou si WPForms Lite est utilisé. */ function wpf_dev_process_complete( $fields, $entry, $form_data, $entry_id ) { // Facultatif, vous pouvez limiter à des formulaires spécifiques. Ci-dessous, nous limitons la sortie // au formulaire n°5. if ( absint( $form_data[ 'id' ] ) !== 5 ) { return; } // Obtenir l'objet de soumission complet $entry = wpforms()->entry->get( $entry_id ); // Les champs sont en JSON, nous les décodons donc en tableau $entry_fields = json_decode( $entry->fields, true ); // Vérifier si l'utilisateur a sélectionné 'Oui' pour le rappel if($entry_fields[6][ 'value' ] === 'Yes') { // Définir le champ caché sur 'Needs Callback' pour filtrer les soumissions $entry_fields[7][ 'value' ] = 'Needs Callback'; } // Reconvertir en json $entry_fields = json_encode( $entry_fields ); // Enregistrer les modifications wpforms()->entry->update( $entry_id, array( 'fields' => $entry_fields ), '', '', array( 'cap' => false ) ); } add_action( 'wpforms_process_complete', 'wpf_dev_process_complete', 10, 4 ); ``` ## Articles de référence [Comment ajouter une année à la date de soumission WPForms](https://wpforms.com/developers/how-to-add-a-year-to-the-wpforms-entry-date/ "Comment ajouter une année à la date de soumission WPForms") **Catégories :** Hooks d'action **Tags :** Traitement des soumissions, PHP ---