Atenção!

Este artigo contém código PHP e destina-se a desenvolvedores. Oferecemos este código como uma cortesia, mas não fornecemos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação extra, consulte o tutorial do WPBeginner sobre como adicionar código personalizado.

Dispensar

Descrição

A ação wpforms_display_field_after é executada antes que o formulário seja exibido para determinar a posição de certos elementos do formulário, como rótulos.

Parâmetros

$fields
(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 é executada antes que o formulário seja exibido. Esta ação pode ser usada para mover atributos do formulário, como os rótulos dos campos do formulário.

Exemplos

É importante notar que, ao usar esta ação para reposicionar o rótulo do campo abaixo do campo do formulário, você deve primeiro usar a ação wpforms_display_field_before para remover o rótulo da exibição antes do campo do formulário, para que você possa chamar a ação para reposicionar o rótulo após o campo do 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