FormMail es un programa escrito en lenguaje Perl que toma el contenido de los campos de un formulario y los manda por e-mail a un destino específico. Además también es capaz de generar su propia página de confirmación. Las siguientes instrucciones asumen que usted sabe cómo crear un formulario.

Para usar el script FormMail.pl con un formulario ya creado, deberá modificar su etiqueta <FORM> para enviar (post) los resultados del formulario al programa CGI de la forma siguiente:

<FORM ACTION="/cgi-sys/formmail.pl" METHOD="POST">

Formmail.pl hará toda la programación por Usted. Usted altera la conducta de FormMail usando los campos escondidos en su formulario.

Solo hay un campo que debe tener en su formulario para que Formmail trabaje correctamente. Este es el campo recipient (recipiente).

CAMPO	recipient
DESCRIPCIÓN	Este campo de formulario le permite especificar a quién desea que se envíen los resultados de su formulario. Casi seguramente Usted querrá configurar esta opción como un campo escondido con un valor igual al de su dirección de E-mail.
SINTAXIS	<input type=hidden name="recipient" value="sunombredeusuario@localnet.com">

 

Hay diversos campos que pueden utilizarse a la hora de configurar un formulario mediante FormMail. A continuación les mostramos algunos de los más utilizados:

CAMPO	subject
DESCRIPCIÓN	El campo subject le permite especificar el tema que desea Usted que aparezca en el E-mail que Usted recibe después de que el formulario ha sido llenado. Si no tiene esta opción activada, entonces el script asignará un tema por default:: WWW Form Submission.
SINTAXIS	<input type=text name="titulo" value=""">

CAMPO	email
DESCRIPCIÓN	Este campo de formulario le permite al usuario especificar su dirección de regreso del correo electrónico. Si desea ser capaz de regresar E-mail a su usuario, sugiero que incluya este campo y les de la posibilidad de llenarlo. Este será puesto dentro del campo FROM: del mensaje que Usted recibe.
SINTAXIS	<input type=text name="email">

CAMPO	realname
DESCRIPCIÓN	El campo de formulario realname le permite al usuario introducir su verdadero nombre. Este campo es útil para propósitos de identificación. Este será puesto dentro del campo FROM: del mensaje que Usted recibe.
SINTAXIS	<input type=text name="nombrereal">

CAMPO	sort
DESCRIPCIÓN	Este campo le permite escoger el orden en el cual desea que aparezcan sus variables en el E-mail que genera Formmail. Puede escoger tener el campo odenado alfabéticamente o especificar el orden que Usted desee.
SINTAXIS 1	<input type=hidden name="sort" value="alphabetic">
SINTAXIS 2	<input type=hidden name="sort" value="order:nombre1,nombre2,etc...">

CAMPO	redirect
DESCRIPCIÓN	Si desea enviar al usuario a un URL diferente, puede usar esta variable escondida. Esta se usa para enviar a una página HTML pre-hecha.
SINTAXIS 1	<input type=hidden name="redirect" value="http://su.dirección/archivo.html">
SINTAXIS 2	<input type=text name="redirect">

CAMPO	required
DESCRIPCIÓN	Puede requerir que ciertos campos de su formulario sean llenados para que el usuario envíe exitosamente el formulario. Si estos no se llenan completamente se le notifica al usuario y se le da un link para ir al formulario otra vez.
SINTAXIS	<input type=hidden name="required" value="campo requerido">

CAMPO	env_report
DESCRIPCIÓN	Le permite tener las variables Environment incluidas en el mensaje de E-mail que Usted recibe después de que un usuario ha llenado el formulario. Esto es útil si desea saber que buscador están usando. A continuación se le presenta una pequeña lista de las variables environment válidas que podrían ser de utilidad: REMOTE_HOST – Envía el nombre del host haciendo una petición. REMOTE_ADDR – Envía las direcciones IP del host remoto. HTTP_USER_AGENT – El buscador que el usuario está usando para enviar la petición. Formato General : software/version library/version
SINTAXIS	Si quisiera encontrar al host remoto y al buscador que envían la petición, pondría Usted lo siguiente en el formulario: <input type=hidden name="env_report" value="REMOTE_HOST,HTTP_USER_AGENT">

CAMPO	title
DESCRIPCIÓN	Esta formulario le permite especificar el título y encabezado que aparecerá en la página resultante si no especifica un URL redirigido.
SINTAXIS	Si quisiera que el título fuera 'Resultados del Formulario de Retroalimentación': <input type=hidden name="title" value="Resultados del Formulario de Retroalimentación">

CAMPO	return_link_url
DESCRIPCIÓN	Este campo le permite especificar un URL que aparecerá como título del link de retorno, en la página de reporte siguiente. Este campo no será usado si tiene un set de campo redirect, pero es útil si le permite al usuario recibir el reporte en la página siguiente, pero quiere darle un modo de regresar a su página principal.
SINTAXIS	<input type=hidden name="return_link_url" value="http://host.xxx/web.html">

CAMPO	return_link_title
DESCRIPCIÓN	Este es el título que será usado para mandar al usuario a una página hacia atrás que Usted especifique. Los dos campos serán mostrados en la página resultante como: <ul> <li><a href="return_link_url">return_link_title</a> </ul>
SINTAXIS	<input type=hidden name="return_link_title" value="Regresar a la Página Principal">

CAMPO	background
DESCRIPCIÓN	Le permite especificar la imagen que quiere que sea el background que aparecerá si no tiene el campo redirect instalado. Esta imagen aparecerá como el background de la página de resultados del formulario.
SINTAXIS	<input type=hidden name="background" value="http://su.host.xxx/imagen.gif">

CAMPO	bgcolor
DESCRIPCIÓN	Le permite especificar el color de la imagen background para la página de resultados del formulario.
SINTAXIS	<input type=hidden name="bgcolor" value="#códigodecolor">

CAMPO	text_color
DESCRIPCIÓN	Sirve para especificar el color del texto.
SINTAXIS	<input type=hidden name="text_color" value="#códigodecolor">

CAMPO	link_color
DESCRIPCIÓN	Cambia el color de los links de la página resultante. No se debe definir si el redirect ya lo está.
SINTAXIS	<input type=hidden name="link_color" value="#códigodecolor">

CAMPO	vlink_color
DESCRIPCIÓN	Cambia el color de los links visitados. No se debe definir si el redirect ya lo está.
SINTAXIS	<input type=hidden name="vlink_color" value="#códigodecolor">

CAMPO	alink_color
DESCRIPCIÓN	Cambia el color de los links activos de la página resultante. No se debe definir si el redirect ya lo está.
SINTAXIS	<input type=hidden name="alink_color" value="#códigodecolor">

 

Cualquier campo de formulario que aparezca en su script será enviado de vuelta a Usted en la página resultante, si no tiene el campo redirect activado.