Résumé IA
Description
L'action wpforms_display_submit_after se déclenche juste après l'affichage de l'élément du bouton de soumission.
Paramètres
- $form_data
- (array) Paramètres/données du formulaire traités, préparés pour une utilisation ultérieure.
- $bouton
- (string) Type de bouton, par exemple `submit`, `next`.
Source
wpforms/src/Frontend/Frontend.php
Plus d'informations
Le hook se déclenche dans la div conteneur du bouton de soumission du formulaire, après l'affichage de l'élément du bouton de soumission.
À titre d'exemple, vous pouvez utiliser ce hook pour ajouter du HTML qui est généré après le bouton Soumettre sur le formulaire.
Alternativement, vous pourriez utiliser wpforms_display_submit_before pour afficher quelque chose avant le bouton Soumettre.
Le wpforms_display_submit_before n'accepte qu'un seul paramètre, qui est le bouton Soumettre. Par conséquent, ce hook particulier serait uniquement lié au bouton Soumettre et non aux boutons de page Suivant ou Précédent.
Exemples
Dans notre exemple de code, nous allons d'abord vérifier si l'ID du formulaire est égal à 5. Si c'est le cas, un lien vers une vidéo s'affichera juste après le bouton Soumettre du formulaire.
N'oubliez pas de changer l'ID du formulaire de 5 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.
Si vous avez besoin d'aide pour trouver l'ID de votre formulaire, vous pouvez consulter ce tutoriel.
/**
* Action that fires just after the submit button element is displayed.
*
* @link https://wpforms.com/developers/wpforms_display_submit_after/
*
* @param array $form_data Form data and settings.
* @param string $button Button type, e.g. `submit`, `next`.
*/
function wpf_dev_display_submit_after( $form_data, $button ) {
if ( $button !== 'submit' ) {
return;
}
// Only run on my form with ID = 5
if ( absint( $form_data['id'] ) !== 1145 ) {
return;
}
// Display a link to a YouTube video after the submit button.
_e( '<div class="track-click"> <a href="https://www.youtube.com/watch?v=eiQ3viAGung" data-rel="lightbox">Click here for a special video announcement!</a>.</div>', 'plugin-domain' );
}
add_action( 'wpforms_display_submit_after', 'wpf_dev_display_submit_after', 10, 2 );