How to Include Field Descriptions Inside Email Notifications

Afficher Markdown

Souhaitez-vous inclure les descriptions de champ dans les notifications par e-mail ? Par défaut, {all_fields} inclut tous les champs du formulaire et les étiquettes qui sont remplis à partir du formulaire, à l'exception des descriptions. Cependant, vous pouvez facilement inclure les descriptions dans les notifications par e-mail à l'aide d'un petit extrait de code PHP. Dans ce tutoriel, nous vous guiderons étape par étape pour y parvenir !

Veuillez noter que ces extraits de code ne fonctionneront pas si vous avez sélectionné le modèle d'e-mail Texte brut.

Création de votre formulaire

Tout d'abord, vous devrez créer votre formulaire. Notre formulaire n'aura que quelques champs inclus et un seul champ aura la Description de champ renseignée.

Une fois que vous avez créé votre formulaire, complétez simplement les descriptions de champ que vous souhaitez inclure dans votre notification par e-mail.

Ajoutez vos descriptions de champs à inclure dans vos notifications par e-mail

Si vous avez besoin d'aide pour créer votre formulaire, veuillez consulter cette documentation.

Sélection du modèle d'e-mail

Dans ce tutoriel, vous devrez vous assurer que le modèle d'e-mail Texte brut n'est pas sélectionné. Si vous n'êtes pas sûr du paramètre que vous avez ou de ce qu'est ce paramètre, vous pouvez toujours consulter cette documentation pour voir où modifier cette option.

Dans les paramètres de WPForms, sous l'onglet E-mail, ce tutoriel utilise le paramètre "Modèle d'e-mail HTML"

Inclusion des descriptions de champ dans la notification

Il est maintenant temps d'ajouter l'extrait de code à votre site. Si vous avez besoin d'aide pour ajouter des extraits de code à votre site, veuillez consulter ce tutoriel.

/*
 * 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 );

En ajoutant cet extrait de code, vos descriptions de champ seront incluses dans toutes vos notifications par e-mail.

Désormais, les descriptions de champs seront incluses dans chaque notification

Et voilà ! Vous avez maintenant inclus les descriptions de champ dans vos notifications par e-mail ! Souhaitez-vous également masquer les choix d'images des notifications par e-mail ? Jetez un œil à l'article sur Comment masquer les choix d'images dans les e-mails de notification.

Filtre de référence

wpforms_html_field_value

FAQ

Q : Puis-je styliser les descriptions de champ dans la notification ?

R : Vous pouvez ajouter un style CSS aux descriptions de champ en utilisant cet extrait de code.

/*
 * 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 );

Vous pouvez maintenant ajouter du style aux descriptions de champs avec ce filtre

Q : Puis-je cibler un seul formulaire par son ID ?

R : Absolument ! Si vous souhaitez uniquement le faire pour un seul formulaire, utilisez cet extrait de code.

/*
 * 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 );

Vous devrez remplacer le 780 dans l'extrait de code pour correspondre à votre propre ID de formulaire. Si vous avez besoin d'aide pour trouver votre ID de formulaire, veuillez consulter ce tutoriel.

Q : Comment puis-je ajouter les descriptions de champ aux entrées ?

R : Vous pouvez inclure les descriptions de champ lors de la visualisation des entrées de votre formulaire en ajoutant cet extrait de code à votre 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 );

En utilisant entry-single, nous permettons aux descriptions de champ d'être visualisées lors de la visualisation d'une entrée unique. Les descriptions de champ ne seront pas enregistrées de manière permanente sur toutes les entrées ; l'entrée actuellement visualisée aura les descriptions de champ affichées à l'écran à l'aide de cet extrait de code.

Q : Puis-je ajouter uniquement certaines descriptions de champ au lieu de toutes ?

R : Absolument ! Pour cet exemple, nous allons uniquement inclure les descriptions de champ pour le champ Nom.

/*
 * 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 );

Comment inclure les descriptions de champ dans les notifications par e-mail

Résumé IA