Souhaitez-vous inclure des descriptions de champs dans les notifications par courrier électronique ? Par défaut, {all_fields} inclut tous les champs et étiquettes du formulaire, à l'exception des descriptions. Cependant, vous pouvez facilement inclure des descriptions dans les notifications par courriel à l'aide d'un petit extrait de code PHP. Dans ce tutoriel, nous allons vous guider à travers chaque étape pour y parvenir !
Veuillez noter que ces extraits ne fonctionneront pas si vous avez sélectionné le modèle de courrier électronique en texte brut.
Création du formulaire
Tout d'abord, vous devez créer votre formulaire. Notre formulaire ne comportera que quelques champs, dont un seul aura une description.
Une fois que vous avez créé votre formulaire, il vous suffit de compléter les descriptions des champs que vous souhaitez inclure dans votre notification par courrier électronique.
Si vous avez besoin d'aide pour créer votre formulaire, veuillez consulter cette documentation.
Sélection du modèle de courrier électronique
Dans ce tutoriel, vous devez vous assurer que vous n'avez pas sélectionné le modèle d'e-mail Texte brut. Si vous n'êtes pas sûr de votre réglage ou de sa nature, vous pouvez toujours consulter cette documentation pour savoir où modifier cette option.
Inclure la description des champs dans la notification
Il est maintenant temps d'ajouter l'extrait à votre site. Si vous avez besoin d'aide pour ajouter des snippets à 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 ce snippet, vos descriptions de champs seront incluses dans toutes vos notifications par courrier électronique.
Et c'est tout ! Vous avez maintenant inclus les descriptions des champs dans vos notifications par courrier électronique ! Vous souhaitez également masquer les choix d'images dans les notifications par courrier électronique ? Consultez l'article intitulé Comment masquer les choix d'images dans les courriels de notification.
Filtre de référence
FAQ
Q : Puis-je modifier la description des champs dans la notification ?
R :Vous pouvez ajouter un style CSS aux descriptions des champs en utilisant cet extrait.
/*
* 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 );
Q : Puis-je cibler un seul formulaire par son numéro d'identification ?
R : Absolument ! Si vous souhaitez le faire pour un seul formulaire, utilisez cet extrait.
/*
* 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 pour qu'il corresponde à l'ID de votre propre formulaire. Si vous avez besoin d'aide pour trouver l'identifiant de votre formulaire, veuillez consulter ce tutoriel.
Q : Comment puis-je ajouter les descriptions des champs aux entrées ?
R : Vous pouvez inclure des descriptions de champs lors de l'affichage des entrées de votre formulaire en ajoutant cet extrait à 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 le entry-single nous permettons aux descriptions des champs d'être affichées lors de la consultation d'une seule entrée. Les descriptions des champs ne seront pas sauvegardées de manière permanente pour toutes les entrées. En utilisant ce snippet sur l'entrée en cours de visualisation, les descriptions des champs s'afficheront à l'écran.
Q : Puis-je ajouter uniquement certaines descriptions de champs au lieu de toutes ?
R :Absolument ! Pour cet exemple, nous n'inclurons que 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 );