|
EmailGateway 1.1 EmailGateway 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. Esistono due possibilità:
In effetti la path può essere arbitraria purché contenuta nel prorpio spazio web, bisogna però considerare che il file form.db viene posto di default nelle 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:
Si possono 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:
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.
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 stare 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 /customer/ nel seguente modo:
|