Consente di raccogliere dati da una form e di spedirli automaticamente al vostro indirizzo di email oppure di memorizzarli in un file di database opportunamente predisposto. 

Individuazione del path 

EmailGateway ha bisogno di conoscere la path di default su cui operare; serve sia per sapere dove sono collocati gli eventuali file frheader.html e frfooter.html per personalizzare le risposte, sia per sapere dove è posizionato il file di database form.db necessario a memorizzare i dati. Essendo utenti di un virtual server del tipo http://www.company.com; in tal caso la path è almeno pari a / ovvero la directory principale del vostro sito 

In effetti la path può essere arbitraria purché contenuta nel proprio spazio web, bisogna però considerare che il file form.db viene posto di default nella path indicate sopra. 

Predisposizione della form 

Faremo un semplice esempio di come predisporre una form per collezionare dati su uno spazio web di un ipotetico utente http://www.miosito.com. 

Per quanto detto la path vale in questo caso: /. La form contiene una serie di nomi di variabili, codificate in una maniera apparentemente complessa: le variabili con prefisso XX- sono di tipo nascosto e non verranno ne' inviate via email ne' aggiunte al database, servono solo al controllo ed al funzionamento del gateway: 

XX-mailto che rappresenta il destinatario della mail 
XX-target che indica se mandare il contenuto per email (MAIL), memorizzarlo sul file di database (FILE) o intraprendere entrambi le azioni (FILEMAIL) 
XX-action che rappresenta la pressione del tasto "SUBMIT" 
XX-sep e' il carattere usato come separatore di campo nel file form.db, esempio XX-sep="|", se viene omesso viene utilizzato il separatore di deafault ':'. 
 

Si può poi inserire un numero arbitrario di campi di tipo qualunque; occorre numerarli per far sì che possano poi essere correttamente inseriti nel database. Consigliamo nn-nome dove nn è un numero sequenziale che ordina i campi e nome è una parola qualunque, per esempio 01-nome, 02-citta ecc... e' importante che sia la numerazione sia i nomi siano univoci nell'ambito di un'unica form. 
Se è previsto un campo che raccolga l'indirizzo email è obbligatorio che si chiami nn-email in modo che possa essere automaticamente inserito nel campo mittente della email inoltrata. 

Qualsiasi campo puo' essere dichiarato obbligatorio basta aggiungere la lettere M dopo il numero sequenziale del campo, esempio: 

01-nome  e' un campo che puo' essere omesso 
01M-nome e' un campo che deve essere necessariamente riempito

Presentiamo un possibile codice da inserire nella pagina; per completezza sono stati inclusi molti campi ma in effetti quelli obbligatori sono sono quelli elencati in precenza. Le righe di commento sono state messe per meglio comprendere la costruzione della form e possono essere eliminate. Vista la complessità, per evitare errori, consigliamo almeno inizialmente di ricopiare tutto il codice con cut&paste e modificarlo solo in un secondo tempo. 

<!--riga obbligatoria: inserire la path come descritto in precedenza-->   <FORM METHOD=GET ACTION="/cgi-bin/emailgw.pl.cgi/">   <!--riga obbligatoria: indica il destinatario della mail generata dal server-->   <INPUT TYPE="hidden" NAME="XX-mailto" VALUE="pippo@company.com">   <!--indica se fare solo mail, solo file o entrambi-->   <INPUT TYPE="hidden" NAME="XX-target" VALUE="MAIL">   <!--questi sono tutti campi generici di testo; se ne possono inserire o togliere a piacimento e occorre numerarli in base all'ordine voluto dei campi (max 99)-->   <INPUT TYPE="text" SIZE=40 MAXLENGTH=256 NAME="01M-nome"> Nome e Cognome<BR>   <!--Notare che questo campo e' stato definito obbligatorio-->     <INPUT TYPE="text" SIZE=40 MAXLENGTH=256 NAME="02-indirizzo"> Indirizzo<BR>   <INPUT TYPE="text" SIZE=6 MAXLENGTH=6 NAME="03-cap"> Cap<BR>   <INPUT TYPE="text" SIZE=40 MAXLENGTH=256 NAME="04-luogo"> Località<BR>   <INPUT TYPE="text" SIZE=4 MAXLENGTH=2 NAME="05-provincia"> Provincia<BR>   <INPUT TYPE="text" SIZE=20 MAXLENGTH=20 NAME="06-telefono"> Numero Telefono<BR>   <INPUT TYPE="text" SIZE=20 MAXLENGTH=20 NAME="07-fax"> Numero Fax<BR>   <!--questo è l'indirizzo del mittente; deve avere nome xx-email-->   <INPUT TYPE="text" SIZE=20 MAXLENGTH=256 NAME="08-email"> Indirizzo E-Mail<BR>   <!--questa è una finestra a scelta multipla-->   Tipo di attività svolta:   <SELECT NAME="09-Azienda">   <OPTION SELECTED>Informatica Software   <OPTION>Informatica Hardware   <OPTION>Elaborazione dati   <OPTION>Libero professionista   <OPTION>Altro   </SELECT><BR>   <HR SIZE=1>   Scegliere il Browser utilizzato<BR>   <!--questi sono dei radio button esclusivi; devono avere tutti lo stesso nome-->   <INPUT TYPE="radio" NAME="10-Browser" VALUE="Netscape" CHECKED> Netscape   <INPUT TYPE="radio" NAME="10-Browser" VALUE="Microsoft"> Microsoft   <INPUT TYPE="radio" NAME="10-Browser" VALUE="Lynx"> Lynx   <INPUT TYPE="radio" NAME="10-Browser" VALUE="Altro"> Nessuno di questi<BR>   <HR SIZE=1>   Inserite qui un messaggio di richiesta informazioni:<BR>   <!--questa è un'area in cui inserire testo libero-->   <TEXTAREA NAME="11-Testo" ROWS=10 COLS=40 WRAP="HARD">   </TEXTAREA><BR>   <!--pulsanti per il reset e per l'immissione; il nome XX-action è obbligatorio-->   <INPUT TYPE="submit" NAME="XX-action" VALUE="Invia Messaggio">   <INPUT TYPE="reset" NAME="Pulisci" VALUE="Pulisci Video">   </FORM>

Il risultato che otterremo è simile al seguente; il vostro visitatore riempirà i vari campi e premendo il tasto "Invia Messaggio" verrà inviata una mail al vostro indirizzo contenente tutte le informazioni che il visitatore ha fornito. 

Uso del file di database 

Se viene utilizzata la variabile XX-target=FILE o XX-target=FILEMAIL è attiva la gestione del file form.db, collocato nella path di default. 

Il file può essere scaricato via FTP e agevolmente convertito in qualsiasi formato esistente di database. Il file può essere cancellato ripetendo poi la citata procedura di creazione e di attivazione. 

La dimensione del file form.db viene conteggiata come se si trattasse di normale spazio web occupato e quindi contribuisce al raggiungimento della quota acquistata. 

Personalizzazione del feedback 

Dopo l'uso di una form di EmailGateway viene restituito dal server un messaggio che verrà mostrato a chi sta usando la form. E' possibile personalizzare tale messaggio mediante la predisposizione di due pagine particolari: frheader.html, frfooter.html. 

frheader.html contiene l'inizio (dal tag <BODY> in poi) desiderato, mentre frfooter.html contiene la fine prima del tag </BODY>. Con questo meccanismo si possono personalizzare i colori delle pagine e prevedere altre informazioni nelle pagine stesse. 

I file frheader.html e frfooter.html devono risiedere nella path di default indicata nella chiamata al cgi; quindi ne possono esistere diversi a seconda della path indicata. Per l'esempio che abbiamo fatto possiamo predisporre due file nella directory / nel seguente modo: 

File frheader.html

<HTML>  <BODY BGCOLOR=#FFFFFF LINK=#FF0000>  Esempio di un file frheader.html, può contenere qualsiasi cosa.  <H2><A HREF="index.html">HOME</A></H2>

File frfooter.html

Esempio di un file frfooter.html, può contenere qualsiasi cosa.  <CENTER>  <IMG SRC="una_immagine.gif"></IMG>  </CENTER>  </BODY>  </HTML>