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

Como Posicionar a Descrição do Campo Acima do Campo do Formulário

Visão geral

Gostaria de posicionar a descrição do campo acima dos campos do seu formulário? Isso pode ser facilmente alcançado com um pequeno trecho de PHP adicionado ao seu site. Este tutorial mostrará como você pode alterar a descrição do seu campo para que ela fique acima dos campos do seu formulário.

Por padrão, o WPForms colocará todas as descrições de campo diretamente abaixo da entrada do campo do formulário.

Por padrão, a descrição do campo é definida para ficar abaixo do campo do formulário

Configuração

Para mover essas descrições para cima do campo do formulário, você precisará primeiro copiar este trecho para o seu site. Se precisar de ajuda sobre como e onde adicionar trechos ao seu site, confira este tutorial.

/**
 * Move the field description above the form field.
 *
 * @link   https://wpforms.com/developers/how-to-position-the-field-description-above-the-form-field/
 */

function wpf_dev_field_properties( $properties, $field, $form_data ) {
    
    // Only process this snippet on form ID 225
    if ( absint( $form_data[ 'id' ] ) !== 225 ) {
        return $properties;
    } 
    
    {
        // Position the field description above the form field
        $properties[ 'description' ][ 'position' ] = 'before';
    }

    return $properties;
}
add_filter( 'wpforms_field_properties', 'wpf_dev_field_properties', 10, 3 );

O código mostrado acima moverá as descrições para cima dos campos do formulário, mas apenas se o ID do formulário for 225. Lembre-se de alterar o ID do formulário de 225 para corresponder ao seu próprio ID de formulário. Se precisar de ajuda para encontrar o ID do seu formulário, revise este tutorial.

Depois de adicionar este trecho de código, você verá que as descrições agora aparecerão acima dos campos do formulário.

A posição da descrição do campo agora está acima com o trecho de PHP

E é isso! Você agora moveu com sucesso as descrições de campo do seu formulário para ficarem acima dos campos do formulário. Gostaria também de aprender como limitar o número de caracteres para o campo de texto do seu formulário? Dê uma olhada em nosso artigo sobre Como Limitar o Número de Caracteres para um Campo de Texto.

Referência de Filtro: wpforms_field_properties

Perguntas Frequentes

P: Adicionei o trecho, mas ainda não está funcionando para mim?

R: Se você adicionou o trecho, mas não consegue ver a alteração, limpe todo o cache do site e confirme também que você atualizou o trecho acima para refletir o ID do formulário no seu formulário.

P: Como posso fazer isso para todos os meus formulários em vez de apenas um?

R: Se você deseja essa funcionalidade para todos os formulários, basta remover a chamada para o ID do formulário. Abaixo está um exemplo desse trecho.

/**
 * Move the field description above the form field.
 *
 * @link   https://wpforms.com/developers/how-to-position-the-field-description-above-the-form-field/
 */

function wpf_dev_field_properties( $properties, $field, $form_data ) {

        // Position the field description above the form field
        $properties[ 'description' ][ 'position' ] = 'before';

    return $properties;
}
add_filter( 'wpforms_field_properties', 'wpf_dev_field_properties', 10, 3 );