### [Como Incluir Descrições de Campos em Notificações por E-mail](https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/)
**Publicado:** 10 de abril de 2020
**Autor:** Equipe Editorial
**Resumo:** Este tutorial mostrar-lhe-á como usar PHP para garantir que as descrições dos seus campos sejam incluídas nas suas notificações por e-mail.
**Conteúdo:**
Gostaria de incluir descrições de campos em notificações por e-mail? Por defeito, o **{all\_fields}** inclui todos os campos do formulário e rótulos que são preenchidos a partir do formulário, com exceção das descrições. No entanto, pode facilmente incluir descrições em notificações por e-mail usando um pequeno trecho de PHP. Neste tutorial, vamos guiá-lo através de cada passo sobre como conseguir isto!
Por favor, saiba que estes trechos não funcionarão se tiver selecionado o modelo de e-mail **Texto Simples**.
## Criação do seu formulário
Primeiro, terá de criar o seu formulário. O nosso formulário terá apenas alguns campos incluídos e apenas um campo terá a **Descrição do Campo** inserida.
Depois de criar o seu formulário, basta preencher as descrições dos campos que deseja incluir na sua notificação por e-mail.
Se precisar de alguma assistência na criação do seu formulário, [visite esta documentação](https://wpforms.com/docs/creating-first-form/ "Criar o seu primeiro formulário").
## Seleção do Modelo de E-mail
Neste tutorial, terá de garantir que não tem o modelo de e-mail **Texto Simples** selecionado. Se não tiver a certeza de qual configuração tem ou o que é esta configuração, [pode sempre rever esta documentação para ver onde alterar esta opção](https://wpforms.com/docs/a-complete-guide-to-wpforms-settings/#email "Um Guia Completo para as Configurações do WPForms").
## Inclusão das descrições de campos na notificação
Agora é hora de adicionar o trecho ao seu site. Se precisar de ajuda para adicionar trechos ao seu site, [consulte este tutorial](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "Como Adicionar PHP ou JavaScript Personalizado para WPForms").
```
/*
* Incluir descrições de campos em notificações por e-mail.
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ] . '';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
Ao adicionar este trecho, as suas descrições de campos serão incluídas em todas as suas notificações por e-mail.
E é tudo! Agora incluiu as descrições dos campos nas suas notificações por e-mail! Gostaria também de ocultar imagens de opções das notificações por e-mail? Dê uma vista de olhos ao artigo sobre [Como Ocultar Imagens de Opções em E-mails de Notificação](https://wpforms.com/developers/how-to-hide-image-choices-in-notification-emails/ "Como Ocultar Imagens de Opções em E-mails de Notificação").
## Filtro de Referência
[wpforms\_html\_field\_value](https://wpforms.com/developers/wpforms_html_field_value/ "Usando o filtro wpforms_html_field_value")
## FAQ
#### Q: Posso estilizar as descrições dos campos na notificação?
**R:** Pode adicionar algum estilo CSS às descrições dos campos usando este trecho.
```
/*
* Incluir descrições de campos em notificações por e-mail.
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ] . '';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
#### Q: Posso direcionar apenas 1 formulário pelo ID do formulário?
**R:** Absolutamente! Se quiser fazer isto apenas para um formulário, use este trecho.
```
/*
* Incluir descrições de campos em notificações por e-mail.
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
// Processar apenas neste ID de formulário 780
if ( $form_data[ 'id' ] !== '780' ) {
return $field_val;
}
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ] . '';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
Terá de substituir o **780** no trecho 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").
#### Q: Como posso adicionar as descrições dos campos às entradas?
**R:** Pode incluir descrições de campos ao visualizar as entradas do seu formulário adicionando este trecho ao seu site.
```
/*
* Incluir descrições de campos em entradas de formulário.
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'entry-single' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][ $field[ 'id' ] ] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][ $field[ 'id' ] ];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
Ao usar o `entry-single`, estamos a permitir que as descrições dos campos sejam visualizadas ao visualizar uma entrada única. As descrições dos campos não serão guardadas permanentemente em todas as entradas; usar este trecho na entrada atual que está a ser visualizada terá as descrições dos campos a serem exibidas no ecrã.
#### Q: Posso adicionar apenas descrições de campos específicas em vez de todas?
**R:** Absolutamente! Para este exemplo, incluiremos apenas as descrições dos campos para o campo **Nome**.
```
/*
* Incluir descrições de campos em entradas de formulário.
*
* @link https://wpforms.com/developers/how-to-include-field-descriptions-inside-email-notifications/
*/
function wpf_dev_html_field_value( $field_val, $field, $form_data, $context ) {
if ( $context !== 'email-html' ) {
return $field_val;
}
if ( $field['type'] !== 'name' ) {
return $field_val;
}
if ( empty( $form_data[ 'fields' ][$field[ 'id' ]] ) ) {
return $field_val;
}
$field_data = $form_data[ 'fields' ][$field[ 'id' ]];
if ( empty( $field_data[ 'description' ] ) ) {
return $field_val;
}
return $field_val . '' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
```
**Categorias:** Notificações
**Tags:** PHP
---