¿Cómo configurar FormMail?

Configuración del Formulario:

La acción de tu formulario necesita apuntar hacia este script, y el método debe ser POST o GET en letras mayúsculas. La versión 1.5 de FormMail ofrece muchos nuevos caminos para codificar tu formulario para adaptar la página HTML que resulta y la forma en que actuan los scripts. A continuación hay una lista de campos de formulario que puedes utilizar y la forma de implementarlos.

Dirección al CGI FormMail: /cgi-sys/form-mail.cgi


Campos de formulario necesarios:

Sólo hay un campo que debes tener en tu formulario para que FormMail funcione correctamente. Éste es el campo recipient.

Campo: recipient

  • Descripción:

    Este campo de formulario te permite especificar a quien quieres que sean enviados por e-mail los resultados de tu formulario. Probablemente desees configurar esta opción como un campo de formulario oculto con un valor igual a tu dirección de correo electrónico.

  • Sintaxis:

    <input type=hidden name="recipient" value="email@your.host.com" />


Campos de formulario opcionales:

Campo: subject

  • Descripción:

    El campo subject te permitirá especificar el asunto que deseas que aparezca en el e-mail que se te envía cuando alguien rellena el formulario. Si no deseas tener esta opción activada, el script enviará el mensaje con un asunto por defecto: WWW Form Submission.

  • Sintaxis:

    Si deseas indicar el asunto:

    <input type=hidden name="subject" value="Your Subject" />

    Para permitir al usuario que elija el asunto:

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

Campo: email

  • Descripción:

    Este campo de formulario le permitirá al usuario especificar su dirección de e-mail. Si deseas poder enviar respuestas de e-mail al usuario, es muy recomendable incluir este campo de formulario y permitir que lo rellenen. Este campo se indicará en el campo From: del mensaje que tu recibas. Si deseas comprobar la Sintaxis de la dirección de email para obligar a que ésta sea válida, hay que añadir este nombre de campo a los campos 'required'.

  • Sintaxis:

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

Campo: realname

  • Descripción:

    El campo de formulario realname permitirá al usuario introducir su nombre real. Este campo es útil para propósitos identificativos y también será incluido en el From: línea de tu cabecera de mensaje.

  • Sintaxis:

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

Campo: redirect

  • Descripción:

    Si deseas redireccionar el usuario a una URL distinta, en vez de dejarle ver la respuesta por defecto del formulario rellenado, puedes utilizar esta variable oculta para enviarle a una página HTML previamente creada.

  • Sintaxis:

    Para escoger la dirección URL a la que serán redireccionados:

    <input type=hidden name="redirect" value="http://your.host.com/to/file.html" />

    Para permitirle especificar una URL a la que acceder una vez el formulario esté rellenado:

    <input type=text name="redirect" />

Campo: required

  • Versión: 1.3 & superiores

  • Descripción:

    Puedes exigir que ciertos campos del formulario sean rellenados antes que el usuario pueda enviar el formulario con éxito. Simplemente debes indicar dentro de este campo, todos aquellos campos que desees que sean obligatorios. Si los campos obligatorios no se rellenan, se le notificará al usuario que debe rellenarlos, y un enlace le llevará de nuevo al formulario que estaba rellenando.

    Para utilizar una página de error personalizada, véase 'missing_fields_redirect'

  • Sintaxis:

    Si deseas que los campos email y teléfono sean obligatorios, de forma que puedas contactar con ellos cuando recibas el e-mail, utiliza una Sintaxis como:

    <input type=hidden name="required" value="email,phone" />

Campo: env_report

  • Versión: 1.3 & superiores

  • Descripción:

    Te permite tener variables de Environment incluidas en el mensaje de e-mail que recibas después de que un usuario haya rellenado el formulario. Es útil si deseas conocer el navegador que están utilizando, desde qué dominio han accedido o cualquier otro atributo asociado con las variables de entorno. La siguiente es una corta lista de variables de entorno válidas y que pueden ser útiles:

    • REMOTE_HOST Envia el hostname haciendo una pregunta.

    • REMOTE_ADDR Envia la dirección IP del host remoto haciendo una pregunta.

    • REMOTE_USER Si el servidor utiliza autentificación y el script está protegido, éste es el username con que se han autentificado. *Normalmente no se muestra.*

    • HTTP_USER_AGENT El navegador que utiliza el cliente para enviar el formulario.

    Hay otros, pero estos son unos pocos de los más útiles. Para más información en variables de entorno, ver:

    http://www.cgi-resources.com/Documentation/Environment_Variables/

  • Sintaxis:

    Si quieres encontrar el remote host y el navegador que envian el formulario, debes indicar lo siguiente:

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

Campo: sort

  • Versión: 1.4 & superiores

  • Descripción:

    Este campo te permite escoger el orden en que deseas que tus variables aparezcan en el e-mail que genera el FormMail. Puedes obtener los campos ordenados alfabéticamente o establecer el orden en que se desea que aparezcan los campos en tu mensaje de e-mail. Dejando este campo vacío, el orden será simplemente el orden en que por defecto los navegadores envien la información al script (habitualmente es el mismo orden en que aparecen en el formulario.) Para establecer un orden de los campos, debe incluirse la frase "order:" como la primera parte del valor del campo elegido, y entonces continuar con los nombres de los campos que quieres que sean listados en el mensaje de e-mail, separados por commas. Version 1.6 permite un poco más de flexibilidad al listar los campos a ordenar, de forma que permite incluir espacios y saltos de línea en el campo sin que estos interfieran en el orden. Esto es útil cuando hay muchos campos de formulario y hay que insertar una línea de separación.

  • Sintaxis:

    Para ordenar alfabéticamente:

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

    Para ordenar por un conjunto de campos:

    <input type=hidden name="sort" value="order:name1,name2, name3,etc..." />

Campo: print_config

  • Versión: 1.5 & superiores

  • Descripción:

    print_config te permite especificar las config variables que deseas sean impresas en tu mensaje de e-mail. Por defecto, ningún campo config se se imprime en el e-mail. Esto es así, puesto que los campos de formulario importantes, como email, subject, etc. son incluidos en la cabecera del mensaje.

    De todas formas algunos usuarios han preguntado por esta opción, de manera que pueden tener estos campos impresos en el cuerpo del mensaje. Los config fields que puedes tener impresos estarán en el atributo value del tag de entrada, separados por comas.

  • Sintaxis:

    Si deseas imprimir los campos email y subject en el cuerpo del mensaje, debes poner el siguiente tag de formulario:

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

Campo: print_blank_fields

  • Versión: 1.6

  • Descripción:

    print_blank_fields te permite asegurar que todos los campos de formulario están impresos en el HTML de vuelta, a menos que no se hubieran rellenado.

    Por defecto, FormMail deja esta propiedad off, de forma que los campos de formulario no usados no son enviados.

  • Sintaxis:

    Si deseas imprimir todos los campos en blanco:

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

Campo: title

  • Versión: 1.3 & superiores

  • Descripción:

    Este campo de formulario te permite especificar el titulo y cabecera que aparecerá en la página de resultado si no especificas una dirección URL en el campo redirect.

  • Sintaxis:

    Si deseas un título de 'Feedback Form Results':

    <input type=hidden name="title" value="Feedback Form Results" />

Campo: return_link_url

  • Versión: 1.3 & superiores

  • Descripción:

    Este campo te permite especificar una URL que aparecerá, como return_link_title, en la siguiente página de informe. Este campo no se utilizará si has indicado el campo redirect, pero es útil si permites al usuario recibir el informe en la página siguiente, y quieres ofrecer un camino para volver a la página principal.

  • Sintaxis:

    <input type=hidden name="return_link_url" value="http://your.host.com/main.html" />

Campo: return_link_title

  • Versión: 1.3 & superiores

  • Descripción:

    Este es el título que será usuado para enviar de nuevo el usuario a la página que especifiques con return_link_url. Los dos campos serán mostrados en la página dle formulario resultante como:

    return_link_title

  • Sintaxis:

    <input type=hidden name="return_link_title" value="Back to Main Page" />

Campo: missing_fields_redirect

  • Versión: 1.6

  • Descripción:

    Este campo de formulario te permite especificar una URL a la que los usuarios serán redireccionados si hay campos obligatorios que no han sido rellenados.

    Así puedes personalizar una página de error, en vez de mostrar la página por defecto.

  • Sintaxis:

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

Campo: background

  • Versión: 1.3 & superiores

  • Descripción:

    Este campo de formulario te permite especificar una imagen de fondo que aparecerá si no tienes el campo redirect. Esta imagen aparecerá como un fondo a la página de resultados del formulario.

  • Sintaxis:

    <input type=hidden name="background" value="http://your.host.com/image.gif" />

Campo: bgcolor

  • Versión: 1.3 & superiores

  • Descripción:

    Este campo de formulario te permite especificar un bgcolor para la página de resultados del formulario de la misma forma que especificas una imagen de fondo.

    Este campo no funcionará si se ha indicado el campo redirect.

  • Sintaxis:

    Para un color de fondo blanco:

    <input type=hidden name="bgcolor" value="#FFFFFF" />

Campo: text_color

  • Versión: 1.3 & superiores

  • Descripción:

    Este campo funciona de la misma forma que bgcolor, y cambia el color del texto.

  • Sintaxis:

    Para un color de texto negro:

    <input type=hidden name="text_color" value="#000000" />

Campo: link_color

  • Versión: 1.3 & superiores

  • Descripción:

    Cambia el color de los enlaces en la página de resultados. Funciona de la misma forma que text_color. No se utilizará si está definido el campo redirect.

  • Sintaxis:

    Para un color de enlace rojo:

    <input type=hidden name="link_color" value="#FF0000" />

Campo: vlink_color

  • Versión: 1.3 & superiores

  • Descripción:

    Cambia el color de los enlaces visitados en la página de resultados. Funciona igual que el link_color. No se utilizará si está definido el campo redirect.

  • Sintaxis:

    Para un enlace visitado de color azul:

    <input type=hidden name="vlink_color" value="#0000FF" />

Campo: alink_color

  • Versión: 1.4 & superiores

  • Descripción:

    Cambia el color de los enlaces activos en la página de resultados. Funciona igual que el link_color. No se utilizará si está definido el campo redirect.

  • Sintaxis:

    Para un enlace activo de color azul:

    <input type=hidden name="alink_color" value="#0000FF" />


Cualquier otro campo de formulario que aparezca en tu script te será enviado de vuelta y mostrado en la página de resultados si no tienes el conjunto de campos redireccionado. No hay límite sobre otros campos de formulario que puedes utilizar con este formulario, salvo los límites impuestos por los navegadores y por tus propios servidores.


Código de ejemplo:

<html>

<head>

<title>Formulario de ejemplo</title>

</head>

<body>

<form action="/cgi-sys/form-mail.cgi" method="post">

<p style="text-align: center;">

Nombre: <input name="nombre" size="20" /><br />

Empresa: <input name="empresa" size="20" />

</p>

<input type="submit" value="Enviar" name="B1" />

<input type="hidden" value="direccion@destino.com" name="recipient" />

<input type="hidden" value="http://www.dominio.com/formok.htm" name="redirect" />

<input type="hidden" value="Formulario enviado por WEB" name="subject" />

</form>

</body>

</html>


Soporte