Resumo de IA
Gostaria de incluir as descrições dos campos nas notificações por e-mail? Por defeito, o {all_fields} inclui todos os campos do formulário e os rótulos que são preenchidos a partir do formulário, com exceção das descrições. No entanto, pode facilmente incluir descrições nas notificações por e-mail utilizando um pequeno trecho de código PHP. Neste tutorial, vamos guiá-lo passo a passo sobre como conseguir isto!
Por favor, saiba que estes trechos de código não funcionarão se tiver selecionado o modelo de e-mail Texto Simples.
Criar o 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 ter criado o seu formulário, basta preencher as descrições dos campos que pretende incluir na sua notificação por e-mail.
Se precisar de alguma ajuda na criação do seu formulário, por favor visite esta documentação.
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.
Incluir as descrições dos campos na notificação
Agora é hora de adicionar o trecho de código ao seu site. Se precisar de ajuda para adicionar trechos de código ao seu site, por favor 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 de código, as suas descrições de campo 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 as escolhas de imagem das notificações por e-mail? Dê uma vista de olhos ao artigo sobre Como Ocultar Escolhas de Imagem em E-mails de Notificação.
Filtro de Referência
FAQ
P: Posso estilizar as descrições dos campos na notificação?
R: Pode adicionar algum estilo CSS às descrições dos campos utilizando este trecho de código.
/*
* 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: Absolutamente! Se desejar fazer isto apenas para um formulário, utilize este trecho de código.
/*
* 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 );
Terá de substituir o 780 no trecho de código para corresponder ao seu próprio ID de formulário. Se precisar de ajuda para encontrar o seu ID de formulário, por favor reveja este tutorial.
P: Como posso adicionar as descrições dos campos às entradas?
R: Pode incluir descrições de campos ao visualizar as suas entradas de formulário adicionando este trecho de código 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 a permitir que as descrições dos campos sejam visualizadas ao ver uma única entrada. As descrições dos campos não serão guardadas permanentemente em todas as entradas; utilizando este trecho de código na entrada atual que está a ser visualizada, as descrições dos campos serão exibidas no ecrã.
P: Posso adicionar apenas descrições de campos específicas em vez de todas?
R: Absolutamente! 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 );