Il programma CGI che permette di attivare questo servizio gira nei server di FREEPASS e si chiama FormMail. Esso è in grado di interpretare le istruzioni inviate attraverso la form creata dall'utente e opportunamente configurato, per manipolare i dati trasmessi al server attraverso la form e spedirli ad un indirizzo e-mail definito nell'HTML della form.
Se desideri creare una form personalizzata secondo le tue esigenze sarà sufficiente che tu segua le istruzioni sottostanti e che inserisca nell'HTML della tua pagina i tag opportuni.

Descrizione; l'action della form deve puntare al file FormMail.cgi, il metodo deve essere POST.
Sintassi:
<form action="http://web.freepass.it/cgi-bin/FormMail.cgi" method=POST>

FormMail offre molti modi di codificare la form per personalizzare la pagina html risultante ed il modo in cui il cgi agisce.
Segue una lista dei campi della form che è possibile utilizzare ed il modo di adoperarli.

C'è solo un campo della form che deve essere obbligatoriamente presente per il corretto funzionamento di FormMail.

• Campo "recipient".
  Descrizione; il campo recipient viene adoperato per specificare a chi devono essere spediti i risultati della compilazione della form. Probabilmente vorrete configurare questa opzione come un campo hidden con un valore uguale a quello del vostro indirizzo e-mail.
  Sintassi:
  <input type=hidden name="recipient" value="email@tuo.indirizzo.it">

• Campo "subject"
  Descrizione; questo campo permette di specificare il subject che si desidera appaia nell'e-mail che viene spedito dopo che la form è stato compilato. Se questa opzione non viene attivata, FormMail invierà per default come subject del messaggio: WWW form Submission.
  Sintassi: se si desidera scegliere il subject
  <input type=hidden name="subject" value="Your Subject">
  per permettere all'utente di scegliere il subject
  <input type=text name="subject">
  

• Campo "email"
  Descrizione; questo campo permette all'utente di specificare il suo indirizzo email. Se si desidera inviare ai propri utenti una email di risposta, si raccomanda vivamente di inserire questo campo e di permetterne la compilazione. L'email dell'utente figurerà nel campo From: del messaggio ricevuto.
  Sintassi:
  <input type=text name="email">

• Campo "realname"
  Descrizione; questo campo consente all'utente di inserire il suo realname. Consente quindi di identificare il mittente e apparirà nella riga From: dell'header del messaggio ricevuto.
  Sintassi:
  <input type=text name="realname">

• Campo "redirect"
  Descrizione; dopo che l'utente ha compilato la form, piuttosto che presentargli la risposta di default, è possibile utilizzare questa variabile nascosta per reindirizzarlo ad una pagina specifica.
  Sintassi: per scegliere l'URL dove l'utente verrà reindirizzato dopo la compilazione della form
  <input type=hidden name="redirect" value="http://web.protec.it/nome_file.html">;
  per permettere all'utente di specificare l'URL dove desidera essere reindirizzato dopo la compilazione della form
  <input type=text name="redirect">

• Campo "required"
  Descrizione; è possibile esigere che certi campi della form vengano compilati obbligatoriamente prima che l'utente possa inviarlo. Occorre semplicemente trascrivere in questo campo tutti i nomi dei campi che si desidera vengano obbligatoriamente compilati dall'utente. Se i campi elencati non vengono riempiti, all'utente verrà notificato che è necessario farlo e verrà visualizzato un link alla form che deve essere completato.
  Sintassi: se si vuole fare in modo che ad esempio i campi email e telefono vengano obbligatoriamente compilati in modo da poter contattare l'utente dopo aver ricevuto l'email, utilizzare la seguente sintassi
  <input type=hidden name="required" value="email,telefono">

• Campo "env_report"
  Descrizione; consente di includere le variabili ambiente nell'email che viene ricevuto dopo che l'utente ha inviato la form. E' utile se si desidera sapere che browser è stato utilizzato, il dominio di provenienza o qualunque altro attributo associato alle variabili ambiente. Segue una breve lista di valide variabili ambiente che possono risultare utili.
  

  • REMOTE_HOST - identifica il nome dell'host remoto con il quale viene inviata la richiesta;
  • REMOTE_ADDR - identifica l'indirizzo IP dell'host remoto con il quale viene inviata la richiesta;
  • REMOTE_USER - se il server supporta l'autenticazione dell'utente e l'area è protetta da userID e password, identifica la userID utilizzata dall'utente per accedere all'area;
  • REMOTE_IDENT - se l'HTTP server supporta l'identificazione RFC 931, questa variabile assumerà il valore della userID remota identificata dal server;
  • HTTP_USER_AGENT - identifica il browser che l'utente sta utilizzando per inviare la richiesta. In genere il formato è : software/version library/version;
  Ci sono altre variabili ambiente ma quelle sopra elencate sono alcune delle più utili.
  Sintassi: se si vuole identificare l'host remoto ed il browser attraverso i quali viene inviata la richiesta, occorrerà inserire nella form la stringa seguente
  <input type=hidden name="env_report" value="REMOTE_HOST,HTTP_USER_AGENT">

• Campo "sort"
  Descrizione; questo campo consente di scegliere l'ordine in cui le variabili appaiono nell'email che viene generato da FormMail. E' possibile scegliere di ordinare i campi della form alfabeticamente o specificare l'ordine in cui si vuole che i campi appaiano nell'email. Se questo campo non viene inserito, l'ordine di default dei campi sarà semplicemente quello con cui il browser invia le informazioni allo script (che non è sempre esattamente lo stesso ordine con cui i campi appaiono nella form). Per ordinare i campi secondo un elenco prefissato, occorre includere il termine "order:" come prima parte del value del campo sort, e quindi di seguito, separati da virgole, i nomi dei campi che si vogliono elencare nell'email.
  Sintassi: per ordinare alfabeticamente
  <input type=hidden name="sort" value="alphabetic">
  per ordinare con un criterio predefinito
  <input type=hidden name="sort" value="order:name1,name2,etc...">

• Campo "print_config"
  Descrizione; consente di specificare quali variabili di configurazione si vogliono includere nell'email. Per default, nessun campo di configurazione viene incluso nell'email. Questo perchè i campi importanti della form, come email, subject, ecc. , vengono inclusi nell'header del messaggio. Comunque questa opzione consente di includere questi campi nel corpo del messaggio. I campi di configurazione che si desidera includere devono essere posti nell'attributo value del tag input separati da virgole.
  Sintassi: per includere i campi email e subject nel corpo del messaggio, si dovrà inserire il seguente tag
  <input type=hidden name="print_config" value="email,subject">

• Campo "title"
  Descrizione; consente di specificare il title e l'header che appariranno nella pagina di risposta all'invio della form qualora non venga specificata una URL di reindirizzamento.
  Sintassi: se si vuole come title 'Pagina Di Ringraziamento'
  <input type=hidden name="title" value="Pagina Di Ringraziamento">

• Campo "return_link_url"
  Descrizione; consente di specificare l'URL di reindirizzamento che apparirà sulla pagina di risposta all'invio della form. Questo campo non sarà utilizzato se é stato inserito il campo redirect, ma è utile se si vuole inviare all'utente una pagina di risposta che contenga un link alla pagina principale.
  Sintassi:
  <input type=hidden name="return_link_url" value="http://web.protec.it/nome_file.html">

• Campo "return_link_title"
  Descrizione; è il titolo che sarà utilizzato per il link alla pagina specificata con return_link_url nella pagina di risposta. I due campi appariranno nella pagina di risposta nel modo seguente:
  <ul>
  <li><a href="return_link_url">return_link_title</a>
  </ul>
  Sintassi:
  <input type=hidden name="return_link_title" value="Torna Alla Pagina Principale">

• Campo "background"
  Descrizione; permette di specificare un'immagine che apparirà come background nella pagina di risposta della form se non è stato adoperato il campo redirect.
  Sintassi:
  <input type=hidden name="background" value="http://web.protec.it/nome_image.gif">

• Campo "bgcolor"
  Descrizione; consente di definire un colore di background per la pagina di risposta della form similmente a quanto fatto per specificare l'immagine di background. Questo campo non deve essere inserito se è già presente il campo redirect.
  Sintassi: per avere un colore di background bianco
  <input type=hidden name="bgcolor" value="#FFFFFF">

• Campo "text_color"
  Descrizione; funziona in maniera analoga a quanto descritto per bgcolor, eccetto per il fatto che è il colore del testo che viene cambiato.
  Sintassi: per ottenere un colore del testo nero
  <input type=hidden name="text_color" value="#000000">

• Campo "link_color"
  Descrizione; consente di variare il colore dei links nella pagina di risposta. Funziona in maniera analoga a quanto descritto per text_color. Non deve essere definito insieme a redirect.
  Sintassi: per avere i link di colore rosso
  <input type=hidden name="link_color" value="#FF0000">

• Campo "vlink_color"
  Descrizione; mediante questo campo è possibile variare il colore dei link visitati nella pagina di risposta della form. Funziona esattamente come link_color. Non deve essere definito insieme a redirect.
  Sintassi: per ottenere link visitati di colore blu
  <input type=hidden name="vlink_color" value="#0000FF">

• Campo "alink_color"
  Descrizione; consente di variare il colore dei link attivi nella pagina di risposta della form. Funziona esattamente come link_color. Non deve essere definito insieme a redirect.
  Sintassi: per un link attivo di colore blu
  <input type=hidden name="alink_color" value="#0000FF">

Qualunque altro campo presente nella form sarà inviato nella email e sarà mostrato all'utente che ha compilato la form nella pagina di risposta se nella form non è stato inserito il campo redirect. Non vi è limite al numero di campi che si possono inserire nella form, se non per i limiti imposti dai browser e dai server.

Il programma FormMail Version 1.5 di cui sono riportate le istruzioni è stato creato da Matt Wright.
Tutti i diritti sono riservati.