Resumo de IA
Gostaria de incluir descrições de campos nas notificações por e-mail? Por padrão, 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, você pode facilmente incluir descrições nas notificações por e-mail usando um pequeno trecho de PHP. Neste tutorial, vamos guiá-lo passo a passo sobre como conseguir isso!
Saiba que esses trechos não funcionarão se você selecionou o modelo de e-mail Texto Simples.
Criando seu formulário
Primeiro, você precisará criar seu formulário. Nosso formulário terá apenas alguns campos incluídos e apenas um campo terá a Descrição do Campo inserida.
Depois de criar seu formulário, basta preencher as descrições dos campos que deseja incluir na sua notificação por e-mail.
Se precisar de ajuda para criar seu formulário, visite esta documentação.
Seleção do Modelo de E-mail
Neste tutorial, você precisará garantir que não tenha o modelo de e-mail Texto Simples selecionado. Se você não tem certeza de qual configuração tem ou o que é essa configuração, você sempre pode revisar esta documentação para ver onde alterar essa opção.
Incluindo as descrições dos campos na notificação
Agora é hora de adicionar o trecho ao seu site. Se precisar de ajuda para adicionar trechos ao seu site, veja este tutorial.
/*
* Include field descriptions inside email notifications.
*
* @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 . '<p>' . $field_data[ 'description' ] . '</p>';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
Ao adicionar este trecho, suas descrições de campo serão incluídas em todas as suas notificações por e-mail.
E é isso! Você incluiu as descrições dos campos em suas notificações por e-mail! Gostaria também de ocultar escolhas de imagem das notificações por e-mail? Dê uma olhada no artigo sobre Como Ocultar Escolhas de Imagem em E-mails de Notificação.
Filtro de Referência
Perguntas Frequentes
P: Posso estilizar as descrições dos campos na notificação?
R:Você pode adicionar alguma estilização CSS às descrições dos campos usando este trecho.
/*
* Include field descriptions inside email notifications.
*
* @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 . '<p style="padding:10px;background-color:#f6f6f6; color: #333333;"><i>' . $field_data[ 'description' ] . '</i></p>';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
P: Posso direcionar apenas 1 formulário pelo ID do formulário?
R:Com certeza! Se você quiser fazer isso apenas para um formulário, use este trecho.
/*
* Include field descriptions inside email notifications.
*
* @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 ) {
// Only process this on form ID 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 . '<p>' . $field_data[ 'description' ] . '</p>';
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
Você precisará substituir o 780 no trecho para corresponder ao seu próprio ID de formulário. Se precisar de ajuda para encontrar seu ID de formulário, revise este tutorial.
P: Como posso adicionar as descrições dos campos às entradas?
R:Você pode incluir descrições de campos ao visualizar as entradas do seu formulário adicionando este trecho ao seu site.
/*
* Include field descriptions inside form entries.
*
* @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 . '<br><br>' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );
Ao usar o entry-single, estamos permitindo que as descrições dos campos sejam visualizadas ao visualizar uma única entrada. As descrições dos campos não serão salvas permanentemente em todas as entradas; usar este trecho na entrada atual que está sendo visualizada terá as descrições dos campos exibidas na tela.
P: Posso adicionar apenas descrições de campos específicas em vez de todas?
R:Com certeza! Para este exemplo, incluiremos apenas as descrições do campo para o campo Nome.
/*
* Include field descriptions inside form entries.
*
* @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 . '<br><br>' . $field_data[ 'description' ];
}
add_filter( 'wpforms_html_field_value', 'wpf_dev_html_field_value', 20, 4 );