Descripción
En wpforms_display_submit_after se activa justo después de que aparezca el botón de envío.
Parámetros
- $form_data
- (array) Ajustes/datos del formulario procesados, preparados para su uso posterior.
- $botón
- (cadena) Tipo de botón, por ejemplo `submit`, `next`.
Fuente
wpforms/src/Frontend/Frontend.php
Más información
El gancho se activa dentro del div contenedor del botón de envío del formulario, después de que se muestre el elemento del botón de envío.
Por ejemplo, puede utilizar este hook para añadir HTML que se muestra después del botón Enviar del formulario.
Como alternativa, puede utilizar wpforms_display_submit_before para mostrar algo antes del botón Enviar.
El wpforms_display_submit_before sólo acepta un parámetro, que es el botón Enviar. Por lo tanto, este gancho en particular sólo estaría vinculado al botón Enviar y no a través de los botones Página siguiente o Página anterior.
Ejemplos
En nuestro fragmento de código de ejemplo, vamos a comprobar primero si el ID del formulario es igual a 5. En caso afirmativo, se mostrará un enlace a un vídeo justo después del formulario de Enviar botón.
Sólo recuerda cambiar el ID del formulario de 5 para que coincida con el ID del formulario específico en el que desea ejecutar el código. Eliminando esa comprobación se ejecutaría para todos los formularios.
Si necesita ayuda para encontrar el ID de su formulario, puede consultar este tutorial.
/**
* 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 );