Attenzione!

Questo articolo contiene codice PHP ed è destinato agli sviluppatori. Offriamo questo codice come cortesia, ma non forniamo supporto per personalizzazioni del codice o sviluppo di terze parti.

Per ulteriore assistenza, consulta il tutorial di WPBeginner su come aggiungere codice personalizzato.

Chiudi

Come includere le descrizioni dei campi nelle notifiche email

Vuoi includere le descrizioni dei campi nelle notifiche email? Per impostazione predefinita, {all_fields} include tutti i campi del modulo e le etichette che vengono compilati dal modulo, ad eccezione delle descrizioni. Tuttavia, puoi facilmente includere le descrizioni nelle notifiche email utilizzando un piccolo snippet PHP. In questo tutorial, ti guideremo passo dopo passo su come ottenere questo risultato!

Tieni presente che questi snippet non funzioneranno se hai selezionato il modello email Testo Semplice.

Creazione del tuo modulo

Innanzitutto, dovrai creare il tuo modulo. Il nostro modulo avrà solo pochi campi inclusi e solo un campo avrà inserita la Descrizione Campo.

Una volta creato il tuo modulo, completa le descrizioni dei campi che desideri includere nella notifica email.

Aggiungi le descrizioni dei tuoi campi da includere nelle notifiche email

Se hai bisogno di assistenza nella creazione del tuo modulo, visita questa documentazione.

Selezione del modello email

In questo tutorial, dovrai assicurarti di non avere selezionato il modello email Testo Semplice. Se non sei sicuro di quale impostazione hai o di cosa si tratta, puoi sempre consultare questa documentazione per vedere dove modificare questa opzione.

Nelle impostazioni di WPForms, nella scheda Email, questo tutorial utilizza l'impostazione Modello email HTML

Inclusione delle descrizioni dei campi nella notifica

Ora è il momento di aggiungere lo snippet al tuo sito. Se hai bisogno di aiuto per aggiungere snippet al tuo sito, consulta questo 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 );

Aggiungendo questo snippet, le descrizioni dei tuoi campi saranno incluse in tutte le tue notifiche email.

Ora le descrizioni dei campi saranno incluse in ogni notifica

E questo è tutto! Ora hai incluso le descrizioni dei campi nelle tue notifiche email! Vuoi anche nascondere le scelte di immagini dalle notifiche email? Dai un'occhiata all'articolo su Come nascondere le scelte di immagini nelle email di notifica.

Filtro di Riferimento

wpforms_html_field_value

FAQ

D: Posso stilizzare le descrizioni dei campi nella notifica?

R:Puoi aggiungere uno stile CSS alle descrizioni dei campi utilizzando questo snippet.

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

Ora puoi aggiungere stili alle descrizioni dei campi con questo filtro

D: Posso indirizzare solo 1 modulo tramite l'ID del modulo?

R: Assolutamente! Se desideri farlo solo per un modulo, usa questo snippet.

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

Dovrai sostituire il 780 nello snippet per corrispondere al tuo ID modulo. Se hai bisogno di aiuto per trovare il tuo ID modulo, consulta questo tutorial.

D: Come posso aggiungere le descrizioni dei campi alle voci?

R: Puoi includere le descrizioni dei campi quando visualizzi le voci del tuo modulo aggiungendo questo snippet al tuo sito.

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

Utilizzando entry-single consentiamo la visualizzazione delle descrizioni dei campi quando si visualizza una singola voce. Le descrizioni dei campi non verranno salvate in modo permanente su tutte le voci; utilizzando questo snippet sulla voce corrente visualizzata, le descrizioni dei campi verranno visualizzate sullo schermo.

D: Posso aggiungere solo determinate descrizioni dei campi invece di tutte?

R: Assolutamente! Per questo esempio, includeremo solo le descrizioni dei campi per il 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 );