Com configurar FormMail?

ATENCIÓ!: aquesta funcionalitat ha estat desactivada ja que és obsoleta avui en dia. En el seu defecte, es podrà utilitzar qualsevol eina externa d'enviament de correus mitjançant formulari, com per exemple MailThisTo, FormsPark o MailSlurp

Configuració del Formulari:

L'acció del teu formulari necessita apuntar cap a aquest script, i el mètode ha de ser POST o GET en majúscules. La versió 1.5 de FormMail ofereix molts nous camins per codificar el teu formulari per adaptar la pàgina HTML que resulta i la forma en què actuen els scripts. A continuació hi ha una llista de camps de formulari que pots utilitzar i la forma d'implementar-los.

Adreça al CGI FormMail: /cgi-sys/form-mail.cgi

Camps de formulari necessaris:

Només hi ha un camp que has de tenir en el teu formulari perquè FormMail funcioni correctament. Aquest és el camp recipient.

Camp: recipient

• Descripció: Aquest camp de formulari et permet especificar a qui vols que siguin enviats per e-mail els resultats del teu formulari. Probablement desitjaràs configurar aquesta opció com un camp de formulari ocult amb un valor igual a la teva adreça de correu electrònic.
• Sintaxi: <input type=hidden name="recipient" value="email@your.host.com" />

Camps de formulari opcionals:

Camp: subject

• Descripció: El camp subject et permetrà especificar l'assumpte que desitges que aparegui en el correu que se t'envia quan algú omple el formulari. Si no desitges tenir aquesta opció activada, el script enviarà el missatge amb un assumpte per defecte: WWW Form Submission.
• Sintaxi: Si desitges indicar l'assumpte: <input type=hidden name="subject" value="Your Subject" />
  Per permetre a l'usuari que triï el tema: <input type=text name="subject" />

Camp: email

• Descripció: Aquest camp de formulari permetrà a l'usuari especificar la seva adreça de correu electrònic. Si desitges poder enviar respostes al correu electrònic de l'usuari, és molt recomanable incloure aquest camp de formulari i permetre que el reomplin. Aquest camp es mostrarà en el camp From: del missatge que tu rebis. Si desitges comprovar la Sintaxi de l'adreça de correu electrònic per obligar que aquesta sigui vàlida, cal afegir aquest nom de camp als camps '\''required'\''.
• Sintaxi: <input type=text name="email" />

Camp: realname

• Descripció: El camp de formulari realname permetrà a l'usuari introduir el seu nom real. Aquest camp és útil per a propòsits identificatius i també s'inclourà en el From: línia de la capçalera del missatge.
• Sintaxi: <input type=text name="realname" />

Camp: redirect

• Descripció: Si desitges redirigir l'usuari a una URL diferent, en comptes de deixar-lo veure la resposta per defecte del formulari omplert, pots utilitzar aquesta variable oculta per enviar-lo a una pàgina HTML prèviament creada.
• Sintaxi: Per escollir l'adreça URL a la qual seran redirigits: <input type=hidden name="redirect" value="http://your.host.com/to/file.html" />
  Per permetre-li especificar una URL a la qual accedir una vegada el formulari estigui omplert: <input type=text name="redirect" />

Camp: required

• Versió: 1.3 & superiors
• Descripció: Pots exigir que certs camps del formulari siguin omplerts abans que l'usuari pugui enviar el formulari amb èxit. Simplement has d'indicar dins d'aquest camp, tots aquells camps que desitgis que siguin obligatoris. Si els camps obligatoris no s'omplen, se li notificarà a l'usuari que ha d'omplir-los, i un enllaç el portarà de nou al formulari que estava omplint. Per utilitzar una pàgina d'error personalitzada, veu missing_fields_redirect
• Sintaxi: Si desitges que els camps email i telèfon siguin obligatoris, de manera que puguis contactar amb ells quan rebis el correu electrònic, utilitza una Sintaxi com: <input type=hidden name="required" value="email,phone" />

Camp: env_report

• Versió: 1.3 & superiors
• Descripció: Et permet tenir variables d'Environment incloses en el missatge de correu electrònic que rebis després que un usuari hagi omplert el formulari. És útil si desitges conèixer el navegador que estan utilitzant, des de quin domini han accedit o qualsevol altre atribut associat amb les variables d'entorn. La següent és una curta llista de variables d'entorn vàlides i que poden ser útils: - REMOTE_HOST Envia el hostname fent una pregunta. - REMOTE_ADDR Envia l'adreça IP del host remot fent una pregunta. - REMOTE_USER Si el servidor utilitza autenticació i el script està protegit, aquest és el username amb què s'han autenticat. Normalment no es mostra. - HTTP_USER_AGENT El navegador que utilitza el client per enviar el formulari. hi ha altres, però aquests són alguns dels més útils. Per a més informació sobre variables d'entorn, veu: Environment_Variables
• Sintaxi: Si vols trobar el remote host i el navegador que envien el formulari, has d'indicar el següent: <input type=hidden name="env_report" value="REMOTE_HOST, HTTP_USER_AGENT" />

Camp: sort

• Versió: 1.4 & superiors
• Descripció: Aquest camp et permet escollir l'ordre en què desitges que les teves variables apareguin en el correu electrònic que genera el FormMail. Pots obtenir els camps ordenats alfabèticament o establir l'ordre en què desitges que apareguin els camps al teu missatge de correu electrònic. Deixant aquest camp buit, l'ordre serà simplement l'ordre en què per defecte els navegadors envien la informació al script (habitualment és el mateix ordre en què apareixen en el formulari.) Per establir un ordre dels camps, ha d'incloure's la frase "order:" com la primera part del valor del camp elegit, i després continuar amb els noms dels camps que vols que siguin llistats en el missatge de correu electrònic, separats per comes. La versió 1.6 permet una mica més de flexibilitat en llistar els camps a ordenar, de manera que permet incloure espais i salts de línia en el camp sense que aquests interfereixin en l'ordre. Això és útil quan hi ha molts camps de formulari i cal inserir una línia de separació.
• Sintaxi: Per ordenar alfabèticament: <input type=hidden name="sort" value="alphabetic" /> Per ordenar per un conjunt de camps: <input type=hidden name="sort" value="order:name1,name2, name3,etc..." />

Camp: print_config

• Versió: 1.5 & superiors
• Descripció: print_config et permet especificar les config variables que desitges que siguin impreses en el teu missatge de correu electrònic. Per defecte, cap camp config s'imprimeix en el correu electrònic. Això és així, ja que els camps de formulari importants, com email, subject, etc. s'inclouen en la capçalera del missatge. De totes maneres alguns usuaris han preguntat per aquesta opció, de manera que poden tenir aquests camps impresos en el cos del missatge. Els config fields que pots tenir impresos estaran en l'atribut value del tag d'entrada, separats per comes.
• Sintaxi: Si desitges imprimir els camps email i subject en el cos del missatge, has de posar el següent tag de formulari: <input type=hidden name="print_config" value="email,subject" />

Camp: print_blank_fields

• Versió: 1.6
• Descripció: print_blank_fields et permet assegurar que tots els camps de formulari estan impresos en l'HTML de tornada, a menys que no s'hagin omplert. Per defecte, FormMail deixa aquesta propietat off, de manera que els camps de formulari no usats no són enviats.
• Sintaxi: Si desitges imprimir tots els camps en blanc: <input type=hidden name="print_blank_fields" value="1" />

Camp: title

• Versió: 1.3 & superiors
• Descripció: Aquest camp de formulari et permet especificar el títol i capçalera que apareixerà a la pàgina de resultat si no especifiques una adreça URL en el camp redirect.
• Sintaxi: Si desitges un títol de '\''Feedback Form Results'\'': <input type=hidden name="title" value="Feedback Form Results" />

Camp: return_link_url

• Versió: 1.3 & superiors
• Descripció: Aquest camp et permet especificar una URL que apareixerà, com return_link_title, a la següent pàgina d'informe. Aquest camp no s'utilitzarà si has indicat el camp redirect, però és útil si permets a l'usuari rebre l'informe a la pàgina següent, i vols oferir un camí per tornar a la pàgina principal.
• Sintaxi: <input type=hidden name="return_link_url" value="http://your.host.com/main.html" />

Camp: return_link_title

• Versió: 1.3 & superiors
• Descripció: Aquest és el títol que serà usat per enviar de nou l'usuari a la pàgina que especifiquis amb return_link_url. Els dos camps seran mostrats en la pàgina del formulari resultant com: return_link_title
• Sintaxi: <input type=hidden name="return_link_title" value="Back to Main Page" />

Camp: missing_fields_redirect

• Versió: 1.6
• Descripció: Aquest camp de formulari et permet especificar una URL a la qual els usuaris seran redirigits si hi ha camps obligatoris que no han estat omplerts. Així pots personalitzar una pàgina d'error, en comptes de mostrar la pàgina per defecte.
• Sintaxi: <input type=hidden name="missing_fields_redirect" value="http://your.host.com/error.html" />

Camp: background

• Versió: 1.3 & superiors
• Descripció: Aquest camp de formulari et permet especificar una imatge de fons que apareixerà si no tens el camp redirect. Aquesta imatge apareixerà com un fons a la pàgina de resultats del formulari.
• Sintaxi: <input type=hidden name="background" value="http://your.host.com/image.gif" />

Camp: bgcolor

• Versió: 1.3 & superiors
• Descripció: Aquest camp de formulari et permet especificar un bgcolor per a la pàgina de resultats del formulari de la mateixa manera que especifiques una imatge de fons. Aquest camp no funcionarà si s'ha indicat el camp redirect.
• Sintaxi: Per a un color de fons blanc: <input type=hidden name="bgcolor" value="#FFFFFF" />

Camp: text_color

• Versió: 1.3 & superiors
• Descripció: Aquest camp funciona de la mateixa manera que bgcolor, i canvia el color del text.
• Sintaxi: Per a un color de text negre: <input type=hidden name="text_color" value="#000000" />

Camp: link_color

• Versió: 1.3 & superiors
• Descripció: Canvia el color dels enllaços a la pàgina de resultats. Funciona de la mateixa manera que text_color. No s'utilitzarà si està definit el camp redirect.
• Sintaxi: Per a un color d'enllaç vermell: <input type=hidden name="link_color" value="#FF0000" />

Camp: vlink_color

• Versió: 1.3 & superiors
• Descripció: Canvia el color dels enllaços visitats a la pàgina de resultats. Funciona igual que el link_color. No s'utilitzarà si està definit el camp redirect.
• Sintaxi: Per a un enllaç visitat de color blau: <input type=hidden name="vlink_color" value="#0000FF" />

Camp: alink_color

• Versió: 1.4 & superiors
• Descripció: Canvia el color dels enllaços actius a la pàgina de resultats. Funciona igual que el link_color. No s'utilitzarà si està definit el camp redirect.
• Sintaxi: Per a un enllaç actiu de color blau: <input type=hidden name="alink_color" value="#0000FF" />

Qualsevol altre camp de formulari que aparegui en el teu script et serà enviat de tornada i mostrat a la pàgina de resultats si no tens el conjunt de camps redirigit. No hi ha límit sobre altres camps de formulari que pots utilitzar amb aquest formulari, excepte els límits imposats pels navegadors i pels teus propis servidors.

Codi d'exemple:

<html>
<head>
     <title>Formulari d'exemple</title>
</head>
<body>
<form action="/cgi-sys/form-mail.cgi" method="post">
     <p style="text-align: center;">
          Nom: <input name="nom" size="20" /><br />
          Empresa: <input name="empresa" size="20" />
     </p>
     <input type="submit" value="Enviar" name="B1" />

     <input type="hidden" value="adresa@destinació.com" name="recipient" />
     <input type="hidden" value="http://www.domini.com/formok.htm" name="redirect" />
     <input type="hidden" value="Formulari enviat per WEB" name="subject" />
</form>
</body>
</html>