3. Guestbook
L'utente vuole realizzare un guestbook, costituito da una pagina HTML in cui vengono inseriti i commenti inviati dall'utente; vuole inoltre che i commenti gli siano inviati anche per E-mail. Supponiamo che egli abbia inserito nella form un campo denominato nome, contenente il nome del visitatore, e un campo denominato commenti, contenente i commenti. Dovendo effettuare due azioni, sarà necessario usare due file di configurazione; scegliamo ad esempio di far spedire il risultato dal primo file e di far aggiornare la pagina HTML dal secondo.
Il primo file di configurazione, indicato dal campo config della form, potrebbe allora essere:
$param{'azione'} = 'spedisci';
# supponiamo che il login dell'utente sia s76786
$param{'schema'} = '/utenti/s76786/HTML/schema.mail.txt';
# va specificato il secondo file di configurazione
$param{'config'} = '/utenti/s76786/form/guest2.cfg';
e lo schema per la mail, nel file /utenti/s76786/HTML/schema.mail.txt:
From: %indirizzo%
To: s76786@studenti.to.it
Subject: Inserimento nel guestbook
Il giorno %data% alle %ora%, %nome% ha scritto che: %commenti%
Il secondo file di configurazione potrebbe invece essere:
$param{'azione'} = 'inserisci';
# supponiamo che il login dell'utente sia s76786
$param{'schema'} = '/utenti/s76786/HTML/schema.html';
# questo e' il file in cui saranno inseriti i dati
$param{'file'} = '/utenti/s76786/HTML/guestbook.htm';
# va indicato il marcatore
$param{'marcatore'} = '<!-- INSERISCI QUI -->';
# il file seguente sarà spedito al browser del visitatore
$param{'output'} = '/utenti/s76786/HTML/guest-risposta.htm';
Il file /utenti/s76786/HTML/schema.html conterrà il blocco di HTML che deve essere inserito nel guestbook ad ogni invio della form, come ad esempio:
<SMALL><I>Il giorno %data% alle ore %ora%, il signor %nome% ha scritto:</I></SMALL><BR>
<B>%commenti%</B>
<HR>
Nel file di destinazione, invece, occorre predisporre tutto affinchè l'inserimento possa avvenire; in particolare, il file deve essere aperto in scrittura a tutti, e deve contenere il marcatore indicato; anche la directory in cui è posto il file deve essere aperta in scrittura a tutti. Ad esempio:
<HTML><HEAD>
<TITLE>I miei visitatori</TITLE>
</HEAD>
<BODY>
Questi sono i commenti dei miei visitatori:<P>
<!-- INSERISCI QUI -->
Grazie per aver partecipato!
</BODY></HTML>
Ogni volta che qualcuno invierà la form, nel punto indicato dal marcatore saranno inseriti i dati forniti dall'utente, formattati secondo lo schema indicato. A seconda del valore del parametro posizione, i dati forniti saranno ordinati in modo che i più recenti si trovino in basso (come in questo caso, dove non si è indicato nulla) o in alto (assegnando al parametro il valore prima).
Esistono comunque alcune restrizioni dovute a motivi di sicurezza. In particolare, non è possibile inserire delle variabili contemporaneamente nei campi From: e To:; almeno uno dei due deve essere fisso e determinato nello schema. Difatti, qualche utente particolarmente ingenuo aveva preparato un modulo di questo tipo, che è stato puntualmente utilizzato per spedire messaggi anonimi di dubbio gusto a mezzo mondo. Comunque, oltre alle vostre righe di intestazione, il programma inserirà tre righe proprie, che segnalano che l'invio è avvenuto tramite il processore di moduli e contengono le informazioni necessarie per risalire al modulo da cui è stato generato il messaggio (e quindi all'utente che lo ha realizzato).