Istruzione per il Formmailer

Cos’è un form mailer?

Provate a immaginare: state organizzando una manifestazione e vorreste che i vostri ospiti potessero registrarsi da Internet. L’ideale sarebbe poter impostare i dati che gli ospiti devono fornire, ad esempio i nomi, il numero di persone e se portano qualcosa. Con il form mailer potete creare moduli simili in modo facile e veloce, senza essere esperti di programmazione.

Nelle prossime pagine scoprirete come funziona.

Da dove inizio?

Per prima cosa dovete pensare a quali informazioni volete inserire nel modulo.
Per prima cosa, quindi, create un modulo semplice. Fate attenzione che la  /cgi-sys/FormMail.cgi zeigt.

01 <form action="/cgi-sys/FormMail.cgi" method="post">
02 <table>
03     <tr>
04         <td>Il vostro indirizzo e-mail:</td>
05         <td><input type="text" name="email" /></td>
06     </tr>
07     <tr>
08         <td>Cognome:</td>
09         <td><input type="text" name="realname" /></td>
10     </tr>
11     <tr>
12         <td>Un vostro commento:</td>
13         <td><textarea cols="20" rows="5" name="kommentar" ></textarea></td>
14     </tr>
15     <tr>
16         <td><input type="submit" name="submit" value="Invia modulo" /></td>
17     </tr>
18 </table>
19 <div>
20         <input type="hidden" name="recipient" value="Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo." />
21         <input type="hidden" name="subject" value="Modulo di contatto" />
22 </div>
23 </form>

Questo sarà l’aspetto del modulo:

 

Questo sarà all’incirca l’aspetto dell’e-mail che riceverete:

 

FROM: Hans Muster <Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.>
TO: Info <Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.>
SUBJECT: Formular abschicken

recipient: Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.
kommentar: Il vostro commento

Parametri base per il form mailer

Parametri nel sito Web o in un file

I parametri possono essere impostati usando i campi nascosti (ossia i campi del modulo non visibili) o con un file di configurazione. Questa funzione può essere utile quando non volete mostrare il vostro indirizzo e-mail nel modulo.

Nella vostra directory FTP create una cartella denominata "formmail" e una sottocartella denominata "conf" al suo interno. È importante che i nomi delle cartelle siano esattamente quelli indicati. Create ora all’interno un file, ad esempio "mio_modulo". Nel vostro programma FTP dovrebbe apparire così:

Potete collegare il file al vostro modulo con la seguente opzione:

1 <input type="hidden" name="conf" value="mein_formular"/>

Il file è orientato alle righe e presenta il seguente formato:
[nome casella]:[valore]

Nella sezione del valore possono essere inseriti tutti i caratteri, compresi spazi e tabulatori.

Il file può avere il seguente contenuto:

recipient:Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.
subject:Mein Betreff
confirmation:0
sort:alphabetic

A quali indirizzi e-mail voglio inviare il mio modulo?

Potete inviare i moduli solo agli indirizzi e-mail dei domini che appartengono anche al vostro account Hostpoint. Potete spedire i moduli a un indirizzo e-mail e, in aggiunta, anche in copia conoscenza o in copia conoscenza nascosta ad altri indirizzi. Anche questi contatti devono appartenere al vostro account.

Indirizzo e-mail destinatario (To)

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="recipient" value="Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo."/>
Configurazione nel file config:
recipient:Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.

Indirizzo in copia conoscenza (Cc)

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="cc_mail" value="Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo."/>
Configurazione nel file config:
cc_mail:Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.

Indirizzo in copia conoscenza nascosta (Ccn)

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="bcc_mail" value="Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo."/>
Configurazione nel file config:
bcc_mail:Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.

Possono essere inseriti più indirizzi e-mail separati da una virgola.

Altre impostazioni e-mail importanti

E-mail di conferma

La funzione è stata rimossa a causa di un abuso da parte degli spammer.

Oggetto

L’oggetto può essere predefinito oppure si può consentire l’inserimento a chi compila. Se volete permettere la personalizzazione a chi compila, rendetelo visibile, altrimenti nascondetelo.

1 Configurazione nel codice del modulo:
2 <input type="text" name="subject"/>
1 Oggetto predefinito:
2 <input type="hidden" name="subject" value="Il mio oggetto"/>
Configurazione nel file config:
subject:Il mio oggetto

Nome del compilatore

Il nome di chi compila il modulo deve essere inserito nel campo "realname", in modo da essere visualizzato nell’intestazione dell’e-mail.

1 Configurazione nel codice del modulo:
2 <input type="text" name="realname" />

E-mail del compilatore

Impostazione dell’indirizzo e-mail del compilatore come mittente
1 L’e-mail del compilatore deve essere inserita nel campo "email", in modo da essere visualizzata nell’intestazione dell’e-mail.
2 Configurazione nel codice del modulo:
3 <input type="text" name="email" />
Invio dell’indirizzo e-mail del compilatore come testo e impostazione del proprio indirizzo come mittente

Nel primo caso l’indirizzo e-mail del compilatore viene impostato come mittente dell’e-mail. Questa soluzione può risolvere i problemi dovuti agli errori di battitura dell’indirizzo e-mail. Anche tecnologie come SPF possono essere il motivo della mancata ricezione dell’e-mail da parte del titolare del modulo.

Pertanto consigliamo la seguente configurazione:

1 Configurazione nel codice del modulo:
2 <input type="text" name="email_text" />
Configurazione nel file config:
email:Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.

Inserite nel campo "email" un indirizzo e-mail appartenente al vostro hosting. In questo modo riceverete sempre le e-mail. Potete visualizzare l’indirizzo e-mail del compilatore in chiaro come contenuto inviato.

Set di caratteri

Il set di caratteri standard del form mailer è iso-8859-1. Qualora la vostra pagina sia scritta con un altro set di caratteri, dovete configurarli nel form mailer, in modo che i dati dell’e-mail possano essere visualizzati correttamente. Per farlo utilizzate il campo "charset":

1 <input type="hidden" name="charset" value="utf-8" />

Ordinamento dei campi nell’e-mail

Potete ordinare i campi del modulo in ordine alfabetico o in un particolare ordine da voi stabilito. Se non viene definito un ordine, verranno visualizzati in maniera casuale e non nell’ordine in cui sono visualizzati sulla vostra homepage. L’unico modo per ordinare le e-mail nello stesso modo in cui sono visualizzate sulla homepage, quindi, è impostare l’ordinamento tramite il campo "sort".

Ordine alfabetico

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="sort" value="alphabetic"/>
Configurazione nel file config:
sort:alphabetic

Ordine personale

In questo caso nell’e-mail viene riportato prima l’ordine e poi il nome. Eventuali ulteriori campi vengono allegati in calce.

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="sort" value="Bestellung,Name"/>
Configurazione nel file config:
sort:Bestellung,Name

Pagine di conferma e di errore

Per confermare il corretto o il mancato invio di un modulo potete creare e far visualizzare automaticamente una vostra pagina Web.

Nella pagina di errore i campi errati saranno contraddistinti come variabili GET e potranno essere letti con un linguaggio informatico.

Pagina di conferma

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="redirect" value="http://www.il-vostro-dominio.ch/erfolg.html"/>
Configurazione nel file config:
redirect:http://www.il-vostro-dominio.ch/erfolg.html

Pagina di errore

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="missing_fields_redirect" value="http://www.il-vostro-dominio.ch/fehler.html"/>
Configurazione nel file config:
missing_fields_redirect:http://www.il-vostro-dominio.ch/fehler.html

Impostazioni avanzate per il form mailer

Naturalmente le possibilità di configurazione del modulo non sono finite.

Il visitatore può allegare un file al modulo

Il visitatore può inviarvi uno o più file. Per farlo è necessario che il modulo supporti innanzitutto i file. Inserite l’opzione enctype="multipart/form-data":

1 <form action="/cgi-sys/FormMail.cgi" method="post" enctype="multipart/form-data">

Ogni campo che può supportare un file in allegato deve iniziare con file_ e contenere il Type file.

1 <input type="file" name="file_anhang" />

Informazioni sull’indirizzo IP o sul browser

Potete richiedere l’invio delle cosiddette variabili d’ambiente, ossia informazioni sull’ambiente del visitatore quali, ad esempio, l’indirizzo IP, il nome del browser utilizzato e il nome usato in Internet per identificare il computer del visitatore.

Variabili d’ambiente

REMOTE_HOST
Invia il nome utilizzato in Internet per il computer del visitatore 
REMOTE_ADDR
Invia l’indirizzo IP del visitatore 
HTTP_USER_AGENT
Invia il nome del browser e del sistema operativo del visitatore 
1 Configurazione nel codice del modulo:
2 <input type="hidden" name="env_report" value="REMOTE_HOST,REMOTE_ADDR,HTTP_USER_AGENT" />
Configurazione nel file config:
env_report:REMOTE_HOST,REMOTE_ADDR,HTTP_USER_AGENT

Cosa deve essere visualizzato nell’e-mail?

Generalmente vengono inviati tutti i campi dell’e-mail, ma si può scegliere anche di nasconderne alcuni.

Come nascondere i campi

In questo caso i campi "redirect", "sort", "missing_field_redirect" e "bcc_mail" non vengono visualizzati nell’e-mail:

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="print_config" value="redirect,sort,missing_field_redirect,bcc_mail" />
Configurazione nel file config:
print_config:redirect,sort,missing_field_redirect,bcc_mail

Verifica dei dati inseriti nel modulo

Potete verificare semplicemente l’esistenza delle variabili o tramite un’altra variabile.

Campo obbligatorio

Potete utilizzare questa impostazione nel caso, ad esempio, di un modulo in cui sia necessario inserire un indirizzo.

Configurazione nel codice del modulo:

1 <input type="hidden" name="required" value="name,vorname,strasse,hausnummer,plz,ort" />
Configurazione nel file config:
required:name,vorname,strasse,hausnummer,plz,ort

Verifica con espressione regolare

Potete aggiungere un’espressione regolare attraverso `[feld]_regex`. Attenzione: per utilizzare opzione dovete conoscere come funzionano le espressioni regolari.

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="plz_regex" value="^\d+$" />
Configurazione nel file config:
plz_regex:^\d+$

Generazione del log

In aggiunta potete salvare i messaggi che vi vengono inviati in un file. Il log viene salvato nella cartella formmail/log nella stessa directory in cui si trova “public_htlm” o “www”. Con il parametro logfile potete definire le impostazioni del file di log.

 

Per impostare il file come file di log seguire le istruzioni riportate di seguito:

File di log

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="logfile" value="mails.txt" />
Configurazione nel file config:
logfile:mails.txt

Modelli

Potete personalizzare l’aspetto dell’e-mail che riceverete.

Creazione di modelli

Potete stabilire con precisione quale deve essere l’aspetto dell’e-mail che riceverete.

Nella cartella formmail/templates della directory FTP superiore dovete creare un file assegnandogli un nome a vostra scelta. Chiameremo il modello “registrazione.txt”.

 

In questo file potrà scrivere quale deve essere l’aspetto della mail. Basterà sostituire i nomi tra le parentesi quadre con il campo corrispondente.

Esempio

Questo potrebbero essere i dati contenuti nel file registrazione.txt:

Cognome: [name]
Nome: [vorname]
Via: [strasse] [hausnummer]
NPA/Localitä: [PLZ] [ort]

Note:
[kommentar]

Questo potrebbe essere l’aspetto di un’e-mail inviata con i dati del cliente:

Name: Rossi
Vorname: Mario
Strasse: Via Roma 1
PLZ/Ort: 1234 Località esempio

Note:
Vengo con mia moglie e porto una torta.

Uso dei modelli

Per un’e-mail indirizzata a voi potete utilizzare un qualsiasi modello.

Modelli per l’e-mail che riceverete

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="mail_template" value="anmeldung.txt" />
Configurazione nel file config:
mail_template:anmeldung.txt

Realizzazione delle pagine di conferma e di errore

Potete realizzare le pagine di conferma e di errore anche senza una pagina HTML personale. Queste opzioni sono rilevanti solo nel caso in cui non creiate nessuna pagina di conferma o di errore propria.

Sfondo

Immagine di sfondo per la pagina di conferma e di errore

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="background" name="http://il-vostro-dominio.ch/hintergrund.png" />
Configurazione nel file config:
background:http://il-vostro-dominio.ch/hintergrund.png

Colore di sfondo per la pagina di conferma e di errore

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="bgcolor" name="gray" />
Configurazione nel file config:
bgcolor:gray

Immagine di sfondo per la pagina di conferma

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="success_background" name="http://il-vostro-dominio.ch/hintergrund.png" />
Configurazione nel file config:
success_background:http://il-vostro-dominio.ch/hintergrund.png

Colore di sfondo per la pagina di conferma

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="success_bgcolor" name="gray" />
Configurazione nel file config:
success_bgcolor:gray

Immagine di sfondo per la pagina di errore

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="error_background" name="http://il-vostro-dominio.ch/hintergrund.png" />
Configurazione nel file config:
error_background:http://il-vostro-dominio.ch/hintergrund.png

Colore di sfondo per la pagina di errore

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="error_bgcolor" name="gray" />
Configurazione nel file config:
error_bgcolor:gray

Titolo

Di seguito viene illustrato come impostare il titolo delle pagine di conferma e di errore:

Titolo della pagina di conferma

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="success_title" name="Mail inviata correttamente" />
Configurazione nel file config:
success_title:Mail inviata correttamente

Titolo della pagina di errore

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="error_title" name="Campi errati" />
Configurazione nel file config:
error_title:Campi errati

Dettagli per la pagina di errore

Se si sceglie di affidare la generazione della pagina di errore a form mailer, i campi verranno visualizzati così:

[nome casella]:
[valore]

Ad esempio:

email:
Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo.

Il colore di "`[feld]`" può essere cambiato con il parametro error_key_color e quello di "`[wert]`" con error_value_color:

Colore per `[feld]`

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="error_key_color" name="blue" />
Configurazione nel file config:
error_key_color:blue

Colore di sfondo per la pagina di errore

1 Configurazione nel codice del modulo:
2 <input type="hidden" name="error_value_color" name="red" />
Configurazione nel file config:
error_value_color:red

Esempi

Ecco quale potrebbe essere l’aspetto del modulo.

Modulo per la registrazione a una festa

 

01 Il codice che ne risulta avrà questo formato:
02 <form action="/cgi-sys/FormMail.cgi" method="post">
03 <table>
04 <tr>
05 <td>Cognome:</