Descrição

O wpforms_display_field_after é acionada antes de o formulário ser exibido para determinar a posição de determinados elementos do formulário, como rótulos.

Parâmetros

$campos
(array) Valores/propriedades do campo de entrada higienizados.
$form_data
(array) Configurações/dados do formulário.

Fonte

wpforms/src/Frontend/Frontend.php

Mais informações

A ação é acionada antes de o formulário ser exibido. Essa ação pode ser usada para mover atributos do formulário, como rótulos de campos de formulário.

Exemplos

É importante observar que, ao usar essa ação para reposicionar o rótulo do campo abaixo do campo do formulário, você deve primeiro usar também a ação wpforms_display_field_before para remover primeiro a exibição do rótulo antes do campo de formulário, de modo que você possa chamar a ação para reposicionar o rótulo após o campo de formulário.

/**
 * Action fires before the form is displayed to determine position of certain form elements such as labels.
 *
 * @link   https://wpforms.com/developers/wpforms_display_field_after/
 * 
 * @param  array    $fields      Sanitized entry field values/properties.
 * @param  array    $form_data   Form settings/data.
 * @return array
 */


/* First remove the label from appearing above the form field for form 1289 */

function wpf_dev_display_field_before( $field, $form_data ) {
 
    if ( absint( $form_data[ 'id' ] ) !== 1289 ) {
        return;
    }

    remove_action( 'wpforms_display_field_before', array( wpforms()->frontend, 'field_label' ), 15 );
}
 
add_action( 'wpforms_display_field_before', 'wpf_dev_display_field_before', 10, 2 );



/* Now position the label to appear below the form field for form 1289 */

function wpf_dev_display_field_after( $field, $form_data ) {

    if ( absint( $form_data[ 'id' ] ) !== 1289 ) {
        return;
    }
 
    wpforms()->frontend->field_label( $field, $form_data );
}
 
add_action( 'wpforms_display_field_after', 'wpf_dev_display_field_after', 1, 2 );


Artigos de referência

Ação de referência

wpforms_display_field_before