Pagina aggiornata il: 13/01/2005 06:40

Settaggio opzioni

Come detto nella pagina principale questo script si caratterizza anche perchè la stragrande maggioranza dei settaggi viene effettuato sulla pagina html, invece che nel corpo dello script. Inoltre le opzioni sono molte.

Si raccomanda di non cambiare il nome dei campi specificati di seguito. Infatti lo script riconosce quei nomi e riversa i "value" in un hash che consente tutte le elaborazioni successive, compresi i controlli di sicurezza. Volendo è possibile però aggiungere nuovi campi, tenendo presente che gli stessi, ad esempio, non verranno controllati, ne potranno essere dichiarati "obbligatori".

Il settaggio avviene tramite inserimento di campi form di tipo "hidden" ovvero "invisibili o di campi "text" dei quali si andrà a spiegare la funzione e la sintassi.

recipient

Questo è l'unico campo il cui inserimento è assolutamente obbligatorio. Infatti si tratta dell'indirizzo di posta email a cui devono pervenire lelettere inviate con il form, e che devi inserire in "value". Dalla versione 1.8 in poi puoi inserire pi di un indirizzo di destinatario separati da una virgola.
Sintassi

<input type="hidden" name="recipient" 
value="nome@tuo_server.com,altro_nome@mail.it">

Attenzione !!! Come detto nella pagina principale di questo tutorial il contenuto di questo tag va coordinato con quello dell'array @recipients.

subject

Si tratta del testo dell'oggetto della mail che arriverà all'indirizzo "recipient". Se lo ometti lo script inserirà automaticamente il testo "WWW Form Submission". Se invece decidi di inserirlo hai due possibilità
Prima possibilità
Sintassi

<input type="hidden" name="subject" 
value="testo che preferisci">

In questo caso l'oggetto della mail lo deciderai tu.

Seconda possiibilità

<input type="text" name="subject">

In questo modo consenti al visitatore di inserire il testo d'oggetto che preferisce.

email

Questo campo consente al visitatore di inserire l'indirizzo della propria mail. Si tratta di un campo importante che ti consente di rispondere a chi ti ha scritto e quindi di mantenere un rapporto. Se lo dichiari "obbligatorio" (vedi required) lo script effettua un controllo sulla validità formale dell'indirizzo inserito.
Sintassi

<input type="text" name="email">

realname

Questo campo consente l'inserimento del nome del visitatore, che viene aggiunto nell'indirizzo del mittente.
Sintassi

<input type="text" name="realname">

redirect

In riferimento a questa funzione sono possibili tre opzioni:

Non inserire questo campo. In tal caso al visitatore, se l'invio della mail va a buon fine, viene presentata una pagina di ringraziamento generata dallo script, in cui è riportato il messaggio con tutti i dati inseriti. Si tratta di un'opzione molto valida e professionale, che consente al visitatore di conservare copia di quanto ha scritto. Inoltre come si vedrà in seguito la pagina è personalizzabile.
Reinviare il visitatore ad una pagina propria. In tal caso bisognerà inserire il seguente campo "hidden"
Sintassi
```
<input type="hidden" name="redirect" 
value="http://www.tuosito.com/pagina.html">

			   
```
Inserire un campo "text" che consenta al visitatore di decidere dove essere reindirizzato dopo l'invio della mail.
Sintassi
```
<input type="text" name="redirect">
			
```

required

Tramite un campo "hidden" puoi dichiarare alcuni campi obbligatori, per cui se verranno lasciati vuoti il messaggio non sarà inviato. E' sufficiente inserire il nome dei campi separati da una ",". Nel caso del campo email verà effettuato anche un controllo sulla validità formale dell'indirizzo. In caso di errore lo script genererà una pagina di avviso che avviserà il visitatore indicandogli i campi da riempire. Tramite l'opzione "missing_fields_redirect" puoi, invece, indirizzare il visitatore ad una pagina predisposta. Credo che sia da preferire la prima soluzione in quanto più interattiva.
Sintassi

<input type="hidden" 
name="required" value="email,realname,subject">

env_report

Tramite questa opzione è possibile ricevere insieme all'email delle informazioni aggiuntive sul mittente. In pratica lo script estrae delle variabili d'ambiente che posso essere utili o a fini statistici o per evitare usi indebiti del form.
I dati ricavabili sono:

REMOTE_HOST - IP o indirizzo del provider che fornisce la linea.
REMOTE_ADDR - IP assegnato al visitatore.
REMOTE_USER - Se il server supporta l'autenticazione e gli script sono protetti questo è l'username del possesore dell'autenticatore. (questa funzione in genere non è supportata dai server).
HTTP_USER_AGENT - Indica il browser e il sistema operativo del visitatore.

Chi volesse approfondire il discorso delle variabili d'ambiente può andare qui.
Sintassi

<input type="hidden" name="env_report" 
value="REMOTE_HOST, HTTP_USER_AGENT,REMOTE_ADDR">

sort

Tramite questa opzione puoi decidere in che ordine fare comparire nella mail il contenuto dei vari campi. Se non inserisci nulla per questa opzione i campi compariranno nello ordine del form. Altrimenti li puoi ordinare alfabeticamente o infine, nell'ordine che preferisci.
Sintassi

ordine alfabetico:

<input type="hidden" name="sort" 
value="alphabetic">

ordine personale:

<input type="hidden" name="sort" 
value="order:nome_del_campo_1,nome_del_campo_2">

print_config

Tramite questa opzione puoi fare scrivere nel corpo del messaggio anche i dati che in genere fanno parte solo dell'oggetto o dell'indirizzo, come l'email del mittente, il nome, l'oggetto,ecc.
Sintassi

<input type="hidden" name="print_config" 
value="email,realname,subject">

print_blank_fields

Se setti ad 1 questa opzione nel corpo del messaggio verranno elencati i campi non dichiarati necessarie lasciati vuoti.
Sintassi

<input type="hidden" name="print_blank_fields" 
value="1">

missing_fields_redirect

Tramite questa opzione puoi indirizzare il visitatore ad una pagina fatta da te in caso di mancata compilazione di un campo necessario. Ti consiglio di non inserire questa opzione, cosicchè la pagina di errore verrà generata dallo script, con il vantaggio che lo stesso indicherà al visitatore esattamente i campi rimasti incompleti.
Sintassi

<input type="hidden" name="missing_fields_redirect" 
value="http://www.tuosito.com/error.html">

Le opzioni seguenti valgono solo per chi non ha scelto di reindirizzare il visitatore ad una pagina personale, e quindi non ha settato l'opzione "redirect". Esse consentono di ersonalizzare notevolmente la pagina di ringraziamento generata dallo script.

title

Tramite questa opzione puoi settare il testo del titolo e dell'header della pagina di ringraziamento generata dallo script.
Sintassi

<input type="hidden" name="title" 
value="Titolo che preferisci">

return_link_url

Tramite questa opzione puoi inserire nella pagina di ringraziamento un link ad un'altra pagina, in genere, ma non necessariamente la home.
Sintassi

<:input type="hidden" name="return_link_url" 
value="http://www.tuosito.com/pagina.html">

return_link_title

Questa opzione è complementare alla precedente, infatti consente di scegliere il testo su cui verrà realizzato il link suddetto.
Sintassi

<<nput type="hidden" name="return_link_title" 
value="Torna alla homepage">

background

Tramite questa opzione puoi inserire uno sfondo nella tua pagina di risposta intervenendo sul tag "body". In pratica devi fornire allo script l'URL assoluto dell'immagine scelta.
Sintassi

<input type="hidden" name="background" 
value="http://www.tuosito.com/immagini/sfondo.gif">

bgcolor

Tramite questa opzione puoi inserire un colore di sfondo nella tua pagina di risposta intervenendo sul tag "body". Puoi inserire il parametro tramite la notazione esadecimale (ad es.: #ffffff) oppure tramite la notazione letterale (ad es.: white).
Sintassi

<input type="hidden" name="bgcolor" value="parametro">

text_color link_color vlink_color alink_color

Tramite queste opzioni puoi regolare la colorazione del testo e dei links, secondo le regole ordinarie dell'html. Puoi inserire il parametro tramite la notazione esadecimale (ad es.: #ffffff) oppure tramite la notazione letterale (ad es.: white).
Sintassi

<input type="hidden" name="text_color" 
value="parametro">
<input type="hidden" name="link_color" 
value="parametro">
<input type="hidden" name="vlink_color" 
value="parametro">
<input type="hidden" name="alink_color" 
value="parametro">

A questo punto abbiamo fatto tutti i settaggi possibili senza intevenire con modifiche strutturali sullo script.

Torna Su

Indice del sito

Torna Su