<html lang="pt-pt" dir="ltr"><head></head><body>### [Como Posicionar a Descrição do Campo Acima do Campo do Formulário](https://wpforms.com/developers/how-to-position-the-field-description-above-the-form-field/)

**Publicado:** 13 de fevereiro de 2020
**Autor:** Equipa Editorial

**Excerto:** Este artigo mostrar-lhe-á como usar PHP para posicionar a descrição do seu campo do formulário acima do campo do formulário. 

**Conteúdo:**

## Visão Geral

Gostaria de posicionar a descrição do campo acima dos seus campos do formulário? Isto pode ser facilmente alcançado com um pequeno trecho de PHP adicionado ao seu site. Este tutorial mostrar-lhe-á como pode alterar a descrição do seu campo para ficar acima dos seus campos do formulário.

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

![Por defeito, a descrição do campo está definida para abaixo do campo do formulário](https://wpforms.com/wp-content/uploads/2019/09/field-description-default-below.jpg)

## Configuração

Para mover estas descrições para cima do campo do formulário, primeiro precisará de copiar este trecho para o seu site. Se precisar de ajuda sobre como e onde adicionar trechos ao seu site, [veja este tutorial](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "Como Adicionar PHP ou JavaScript Personalizado para WPForms").

```

/**
 * Move a descrição do campo para cima do campo do formulário.
 *
 * @link   https://wpforms.com/developers/how-to-position-the-field-description-above-the-form-field/
 */

function wpf_dev_field_properties( $properties, $field, $form_data ) {
    
    // Processa apenas este trecho no ID do formulário 225
    if ( absint( $form_data[ 'id' ] ) !== 225 ) {
        return $properties;
    } 
    
    {
        // Posiciona a descrição do campo acima do campo do formulário
        $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 apenas 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 seu ID de formulário, [reveja este tutorial.](https://wpforms.com/developers/how-to-locate-form-id-and-field-id/ "Como Localizar o ID do Formulário e o ID do Campo")

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

![A posição da descrição do campo está agora acima com o trecho de PHP](https://wpforms.com/wp-content/uploads/2019/09/field-description-after-change-above.jpg)

E é tudo! Moveu agora com sucesso as descrições dos campos no seu formulário para ficarem acima dos campos do formulário. Gostaria também de aprender a limitar o número de caracteres para o campo de texto do seu formulário? Dê uma vista de olhos ao nosso artigo sobre [Como Limitar o Número de Caracteres para um Campo de Texto](https://wpforms.com/developers/how-to-limit-the-number-of-characters-for-a-text-field/ "Como Limitar o Número de Caracteres para um Campo de Texto").

## Relacionado

Referência de Filtro: [wpforms\_field\_properties](https://wpforms.com/developers/wpforms_field_properties/ "Usando o filtro wpforms_field_properties")

## FAQ

#### P: Adicionei o trecho, mas isto ainda não está a funcionar para mim?

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

#### P: Como posso fazer isto para todos os meus formulários em vez de apenas 1?

**R:** Se desejar esta funcionalidade para todos os formulários, basta remover a chamada para o ID do formulário. Abaixo está um exemplo desse trecho.

```

/**
 * Move a descrição do campo para cima do campo do formulário.
 *
 * @link   https://wpforms.com/developers/how-to-position-the-field-description-above-the-form-field/
 */

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

        // Posiciona a descrição do campo acima do campo do formulário
        $properties[ 'description' ][ 'position' ] = 'before';

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

**Categorias:** Snippets

**Tags:** PHP

---</body></html>