Special Mail Tags: I Campi Nascosti di Contact Form 7

Contact Form 7 è uno dei plugin più usati su WordPress per creare moduli di contatto. Il funzionamento è molto semplice: basta creare i campi da richiedere all’utente (tipo Nome, Email, Telefono, ecc) e una volta compilato il modulo, verranno inviati su un indirizzo email impostato in precedenza. Tuttavia, alcune volte può essere necessario sapere alcuni dati particolari come l’indirizzo IP, la user id, l’url, ecc.

Prendiamo ad esempio l’ipotesi in cui il nostro modulo viene replicato su più pagine e vogliamo sapere su quale pagina è stato compilato. Potremmo creare un campo testo chiamato “url pagina”, ma non possiamo pretendere che l’utente lo compili. Per questo ci vengono in aiuto gli Special Mail-tags.

Special Mail-tags

Ovviamente questi tag speciali devono essere inseriti nel messaggio che verrà inviato all’amministratore. Quindi una volta aperto il tuo modulo di contatto, dovrai posizionarti nelle scheda Mail

e inserire i Tag all’interno dei campi opportuni.

Ecco un elenco completo di tutti gli special tag messi a disposizione dal plugin raggruppati per categorie.

Special Mail Tags generici

• [_remote_ip] – per ottenere l’indirizzo IP di chi compila il modulo.
• [_user_agent] – per ottenere l’user agent.
• [_url] – per ottenere l’indirizzo url della pagina che contiene il modulo.
• [_date] – per ottenere la data di compilazione.
• [_time] – per ottenere l’orario di compilazione.
• [_invalid_fields] – per ottenere il numero di campi con valori non validi.
• [_serial_number] – per ottenere il numero seriale della compilazione. Sitratta di un codice univoco assegnato a ogni compilazione del modulo. Richiede il plugin Flamingo.

Special Mail Tags relativi al Post

Funzionano solamente se il modulo di contatto viene inserito all’interno di un contenuto di tipo “post” – gli articoli per intenderci – e servono per darci nformazioni relative al post.

• [_post_id] – per ottenere l’ID del post.
• [_post_name] – per ottenere lo slug del post.
• [_post_title] – per ottenere il titolo del post.
• [_post_url] – per ottenere il permalink del post.
• [_post_author] – per ottenere l’autore del post.
• [_post_author_email] – per ottenere l’email dell’autore.

Special Mail Tags relativi al Sito web

Questi special tag forniscono informazioni globali sul sito web. Sono paticolarmente utili quando utilizziamo gli stessi moduli di contatto su siti web diversi.

• [_site_title] – per ottenere il titolo del sito.
• [_site_description] – per ottenere la descrizione del sito.
• [_site_url] – per ottenere la home url del sito.
• [_site_admin_email] – per ottenere l’email dell’amministratore primario.

Special Mail Tags relativi agli Utenti

Nel caso in cui il modulo venga compilato da utenti registrati possiamo ottenere informazioni grazie a questi special tags.

• [_user_login] – per ottenere il nome login dell’utente.
• [_user_email] – per ottenere l’indirizzo email dell’utente.
• [_user_url] – per ottenere l’url del sito dell’utente.
• [_user_first_name] – per ottenere il nome dell’utente.
• [_user_last_name] – per ottenere il cognome dell’utente.
• [_user_nickname] – per ottenere il nickname dell’utente.
• [_user_display_name] – per ottenere il nome pubblico dell’utente.

Per ulteriori informazioni puoi consultare il sito ufficiale.