Come configurare FormMail?

ATTENZIONE!: questa funzionalità è stata disattivata poiché obsoleta al giorno d'oggi. In sua vece, si potrà usare qualsiasi strumento esterno di invio e-mail tramite modulo, come per esempio MailThisTo, FormsPark o MailSlurp

Configurazione del Modulo:

L'azione del tuo modulo deve puntare verso questo script, e il metodo dovrebbe essere POST o GET in lettere maiuscole. La versione 1.5 di FormMail offre molti nuovi modi per codificare il tuo modulo per adattare la pagina HTML risultante e il modo in cui agiscono gli script. Di seguito c'è una lista di campi di modulo che puoi utilizzare e il modo di implementarli.

Indirizzo al CGI FormMail: /cgi-sys/form-mail.cgi

Campi di modulo necessari:

C'è solo un campo che devi avere nel tuo modulo perché FormMail funzioni correttamente. Questo è il campo recipient.

Campo: recipient

• Descrizione: Questo campo di modulo ti permette di specificare a chi vuoi che siano inviati via e-mail i risultati del tuo modulo. Probabilmente desideri configurare questa opzione come un campo di modulo nascosto con un valore uguale al tuo indirizzo e-mail.
• Sintassi: <input type=hidden name="recipient" value="email@your.host.com" />

Campi di modulo opzionali:

Campo: subject

• Descrizione: Il campo subject ti permetterà di specificare l'oggetto che desideri appaia nell'e-mail che ti viene inviata quando qualcuno compila il modulo. Se non desideri avere questa opzione attivata, lo script invierà il messaggio con un oggetto di default: WWW Form Submission.
• Sintassi: Se desideri indicare l'oggetto: <input type=hidden name="subject" value="Your Subject" />
  Per permettere all'utente di scegliere l'oggetto: <input type=text name="subject" />

Campo: email

• Descrizione: Questo campo di modulo permetterà all'utente di specificare il suo indirizzo e-mail. Se desideri poter inviare risposte via e-mail all'utente, è molto raccomandabile includere questo campo di modulo e permettere che venga riempito. Questo campo sarà indicato nel campo From: del messaggio che ricevi. Se desideri controllare la Sintassi dell'indirizzo e-mail per obbligare che sia valido, si deve aggiungere questo nome di campo ai campi '''required'''.
• Sintassi: <input type=text name="email" />

Campo: realname

• Descrizione: Il campo di modulo realname permetterà all'utente di inserire il suo nome reale. Questo campo è utile per scopi di identificazione e sarà anche incluso nella linea From: dell'intestazione del tuo messaggio.
• Sintassi: <input type=text name="realname" />

Campo: redirect

• Descrizione: Se desideri reindirizzare l'utente a un URL diverso, invece di lasciarlo vedere la risposta di default del modulo compilato, puoi utilizzare questa variabile nascosta per inviarlo a una pagina HTML precedentemente creata.
• Sintassi: Per scegliere l'indirizzo URL a cui saranno reindirizzati: <input type=hidden name="redirect" value="http://your.host.com/to/file.html" />
  Per permettere di specificare un URL a cui accedere una volta che il modulo è compilato: <input type=text name="redirect" />

Campo: required

• Versione: 1.3 & superiori
• Descrizione: Puoi esigere che certi campi del modulo siano riempiti prima che l'utente possa inviare il modulo con successo. Devi semplicemente indicare all'interno di questo campo, tutti quei campi che desideri che siano obbligatori. Se i campi obbligatori non vengono riempiti, verrà notificato all'utente che deve riempirli, e un link lo riporterà al modulo che stava compilando. Per utilizzare una pagina di errore personalizzata, vedi missing_fields_redirect
• Sintassi: Se desideri che i campi email e telefono siano obbligatori, in modo da poter contattare qualcuno quando ricevi l'e-mail, utilizza una Sintassi come: <input type=hidden name="required" value="email,phone" />

Campo: env_report

• Versione: 1.3 & superiori
• Descrizione: Ti permette di avere variabili di Environment incluse nel messaggio e-mail che ricevi dopo che un utente ha compilato il modulo. È utile se desideri conoscere il browser che stanno usando, da quale dominio hanno acceduto o qualsiasi altro attributo associato alle variabili di ambiente. La seguente è una breve lista di variabili di ambiente valide e che possono essere utili: - REMOTE_HOST Invia l'hostname facendo una domanda. - REMOTE_ADDR Invia l'indirizzo IP del host remoto facendo una domanda. - REMOTE_USER Se il server utilizza l'autenticazione e lo script è protetto, questo è il nome utente con cui si sono autenticati. Normalmente non viene mostrato. - HTTP_USER_AGENT Il browser che il cliente utilizza per inviare il modulo. ce ne sono altri, ma questi sono alcuni dei più utili. Per maggiori informazioni sulle variabili di ambiente, vedere: Environment_Variables
• Sintassi: Se vuoi trovare il remote host e il browser che inviano il modulo, devi indicare quanto segue: <input type=hidden name="env_report" value="REMOTE_HOST, HTTP_USER_AGENT" />

Campo: sort

• Versione: 1.4 & superiori
• Descrizione: Questo campo ti permette di scegliere l'ordine in cui desideri che le tue variabili appaiano nell'e-mail che genera il FormMail. Puoi ottenere i campi ordinati alfabeticamente o stabilire l'ordine in cui desideri che appaiano i campi nel tuo messaggio e-mail. Lasciando vuoto questo campo, l'ordine sarà semplicemente quello in cui per default i browser inviano le informazioni allo script (solitamente è lo stesso ordine in cui appaiono nel modulo.) Per stabilire un ordine dei campi, si deve includere la frase "order:" come la prima parte del valore del campo scelto, e poi continuare con i nomi dei campi che vuoi che siano elencati nel messaggio e-mail, separati da virgole. La versione 1.6 permette un po' più di flessibilità nell'elencare i campi da ordinare, in modo che permetta di includere spazi e interruzioni di linea nel campo senza che questi interferiscano nell'ordine. Questo è utile quando ci sono molti campi di modulo e bisogna inserire una linea di separazione.
• Sintassi: Per ordinare alfabeticamente: <input type=hidden name="sort" value="alphabetic" /> Per ordinare per un insieme di campi: <input type=hidden name="sort" value="order:name1,name2, name3,etc..." />

Campo: print_config

• Versione: 1.5 & superiori
• Descrizione: print_config ti permette di specificare le config variables che desideri siano stampate nel tuo messaggio e-mail. Di default, nessun campo config viene stampato nell'e-mail. Questo perché i campi di modulo importanti, come email, subject, ecc. sono inclusi nell'intestazione del messaggio. Comunque, alcuni utenti hanno richiesto questa opzione, in modo che possano avere questi campi stampati nel corpo del messaggio. I campi config che puoi avere stampati saranno nell'attributo value del tag di input, separati da virgole.
• Sintassi: Se desideri stampare i campi email e subject nel corpo del messaggio, devi mettere il seguente tag di modulo: <input type=hidden name="print_config" value="email,subject" />

Campo: print_blank_fields

• Versione: 1.6
• Descrizione: print_blank_fields ti permette di assicurare che tutti i campi di modulo siano stampati nell'HTML di ritorno, a meno che non siano stati riempiti. Di default, FormMail lascia questa proprietà disattivata, in modo che i campi di modulo non usati non vengano inviati.
• Sintassi: Se desideri stampare tutti i campi in bianco: <input type=hidden name="print_blank_fields" value="1" />

Campo: title

• Versione: 1.3 & superiori
• Descrizione: Questo campo di modulo ti permette di specificare il titolo e l'intestazione che apparirà nella pagina di risultato se non specifichi un indirizzo URL nel campo redirect.
• Sintassi: Se desideri un titolo di '''Feedback Form Results''': <input type=hidden name="title" value="Feedback Form Results" />

Campo: return_link_url

• Versione: 1.3 & superiori
• Descrizione: Questo campo ti permette di specificare una URL che apparirà, come return_link_title, nella successiva pagina di rapporto. Questo campo non verrà utilizzato se hai indicato il campo redirect, ma è utile se permetti all'utente di ricevere il rapporto nella pagina successiva, e vuoi offrire un modo per tornare alla pagina principale.
• Sintassi: <input type=hidden name="return_link_url" value="http://your.host.com/main.html" />

Campo: return_link_title

• Versione: 1.3 & superiori
• Descrizione: Questo è il titolo che sarà usato per re-inviare l'utente alla pagina che specifichi con return_link_url. I due campi verranno mostrati nella pagina del modulo risultante come: return_link_title
• Sintassi: <input type=hidden name="return_link_title" value="Back to Main Page" />

Campo: missing_fields_redirect

• Versione: 1.6
• Descrizione: Questo campo di modulo ti permette di specificare una URL a cui gli utenti saranno reindirizzati se ci sono campi obbligatori che non sono stati riempiti. In questo modo puoi personalizzare una pagina di errore, anziché mostrare la pagina di default.
• Sintassi: <input type=hidden name="missing_fields_redirect" value="http://your.host.com/error.html" />

Campo: background

• Versione: 1.3 & superiori
• Descrizione: Questo campo di modulo ti permette di specificare un'immagine di sfondo che apparirà se non hai il campo redirect. Questa immagine apparirà come uno sfondo alla pagina di risultati del modulo.
• Sintassi: <input type=hidden name="background" value="http://your.host.com/image.gif" />

Campo: bgcolor

• Versione: 1.3 & superiori
• Descrizione: Questo campo di modulo ti permette di specificare un bgcolor per la pagina di risultati del modulo nello stesso modo in cui specifichi un'immagine di sfondo. Questo campo non funzionerà se è stato indicato il campo redirect.
• Sintassi: Per un colore di sfondo bianco: <input type=hidden name="bgcolor" value="#FFFFFF" />

Campo: text_color

• Versione: 1.3 & superiori
• Descrizione: Questo campo funziona nello stesso modo di bgcolor, e cambia il colore del testo.
• Sintassi: Per un colore di testo nero: <input type=hidden name="text_color" value="#000000" />

Campo: link_color

• Versione: 1.3 & superiori
• Descrizione: Cambia il colore dei link nella pagina di risultati. Funziona nello stesso modo di text_color. Non verrà utilizzato se è definito il campo redirect.
• Sintassi: Per un colore di link rosso: <input type=hidden name="link_color" value="#FF0000" />

Campo: vlink_color

• Versione: 1.3 & superiori
• Descrizione: Cambia il colore dei link visitati nella pagina di risultati. Funziona come il link_color. Non verrà utilizzato se è definito il campo redirect.
• Sintassi: Per un link visitato di colore blu: <input type=hidden name="vlink_color" value="#0000FF" />

Campo: alink_color

• Versione: 1.4 & superiori
• Descrizione: Cambia il colore dei link attivi nella pagina di risultati. Funziona come il link_color. Non verrà utilizzato se è definito il campo redirect.
• Sintassi: Per un link attivo di colore blu: <input type=hidden name="alink_color" value="#0000FF" />

Qualsiasi altro campo di modulo che appare nel tuo script ti sarà inviato di ritorno e mostrato nella pagina di risultati se non hai il set di campi reindirizzati. Non ci sono limiti su altri campi di modulo che puoi utilizzare con questo modulo, a parte i limiti imposti dai browser e dai tuoi server.

Codice di esempio:

<html>
<head>
     <title>Modulo d'esempio</title>
</head>
<body>
<form action="/cgi-sys/form-mail.cgi" method="post">
     <p style="text-align: center;">
          Nome: <input name="nome" size="20" /><br />
          Azienda: <input name="azienda" size="20" />
     </p>
     <input type="submit" value="Invia" name="B1" />

     <input type="hidden" value="indirizzo@destinazione.com" name="recipient" />
     <input type="hidden" value="http://www.dominio.com/formok.htm" name="redirect" />
     <input type="hidden" value="Modulo inviato da WEB" name="subject" />
</form>
</body>
</html>