do_action( 'wpforms_frontend_output_before', array $form_data,  WP_Post $form )

Descrição

The wpforms_frontend_output_before action fires before a form is displayed on the site’s front end, only if the form exists and contains fields.

Parâmetros

$form_data

(array) Configurações/dados do formulário processados, preparados para uso posterior.

$form

(WP_Post) Form post type object.

Fonte

wpforms/src/Frontend/Frontend.php

Mais Informações

While wpforms_frontend_output_before only fires for valid non-empty forms, it executes early on in the output rendering process.

In some cases, the action may fire but the form will not display, such as displaying a form confirmation message or triggering the wpforms_frontend_load filter.

An alternate action to consider is wpforms_frontend_output_after, as it functions similarly, except only fires after the form is displayed.

Exemplos

In our example code snippet, you’ll see below, we are going to be checking first to see if the form ID is equal to 5. If it is, we’ll echo out a link to download the digital catalog.

Just remember to change the form ID from 5 to match the specific form ID you’re wanting to run your code on. Removing that check would run for all forms.

/**
 * Output something before your form(s).
 * 
 * @link  https://wpforms.com/developers/wpforms_frontend_output_before/
 *
 * @param array  $form_data Form data and settings.
 * @param object $form      Form post type object.
 */

function wpf_dev_frontend_output_before( $form_data, $form ) {
    
    // Optional, you can limit to specific forms. Below, we restrict output to
    // form #5.
    if ( absint( $form_data[ 'id' ] ) !== 5 ) {
        return;
    } 

    // Run code or see the example echo statement below.
    _e( '<p>If you would like to download our digital catalog, <a href="http://yourlinkurl.com/" target="_blank">click here</a>.</p>', 'plugin-domain' );

}

add_action( 'wpforms_frontend_output_before', 'wpf_dev_frontend_output_before', 10, 2 );

Artigos de Referência

Como Adicionar um Vídeo Antes do Seu Formulário