CGIEMAIL es el nombre del script que incluimos en cada una de nuestras ofertas de hosting en UNIX y que sirve para poder recibir por correo electronico los datos introducidos en un formulario creado por usted en su página web. Estos son lo pasos necesarios para utilizar CGIEMAIL.

El script cgiemail reside en el directorio cgi-bin del servidor y no necesita ser instalado en su propia cuenta . 

1. Crear el formulario como documento HTML.
2. Crear una plantilla de email.
3. Asegúrese de que ACTION está bien definida.
4. Repase lo que ha hecho si no recibe un correo
5. Crear formularios en HTML más avanzados.

Los siguientes pasos son opcionales

• Añádale texto a la página en caso de éxito en petición
• Utilice otra página de éxito si no le gusta la que hay
• Defina algunos campos de imprescindible cumplimentación
• Defina el formato de algunos campos de entrada
• Utilice variables de entorno CGI

1. Crear el formulario como documento HTML.

Aquí tiene un ejemplo de formulario HTML...

...y este es su código HTML:

<form method="post" action="/cgi-bin/cgiemail/plantilla.txt">
Nombre: <INPUT NAME="nom"><p>
Direccion: <INPUT NAME="dir"><p>
Telefono: <INPUT NAME="tel"><p>
E-mail: <INPUT NAME="email"><p>
<INPUT TYPE="submit" value="Enviar e-mail">
</FORM>

Este es un ejemplo muy sencillo. Los nombres en rojo son las variables que luego deberá introducir en su plantilla de e-mail. Las variables serán sustituidas por los valores introducidos al rellenar el formulario.

2. Crear una plantilla de email.

Esta es la plantilla de texto que recibirá como un e-mail corriente y que debe tener la siguiente estructura:

To: Juanperez@123web.com.ar        LINEAS DE ENCABEZAMIENTO
From: [email]
Subject: datos cliente
                                  línea en blanco
Nombre:         [nom]
Dirección:      [dir]             cuerpo del mensaje
Teléfono        [tel]
etc...          [etc]

Antes de enviar la plantilla a su espacio repase todos estos pasos:

1. Use una sola palabra entre paréntesis cuadrados y sin espacios. Por ejemplo, Su nombre: [sunombre]. y NO [ponga su nombre aquí].
2. Omita los acentos y letras hispanas como la ñ 
3. Usar letras minusculas.
4. Asegúrese que introduce una dirección de email correcta en el campo To:
5. Si hay líneas en blanco entre las líneas del encabezado, quítelas.
6. Si hay líneas en blanco antes del encabezado, quítelas también.
7. Asegúrese de que todas las líneas del encabezado son válidas. El primer carácter de cada línea debe ser una letra.
8. Asegúrese de que hay una línea en blanco entre el encabezado y el cuerpo del mensaje.
9. Recuerde que debe guardar el documento en formato ASCII. Por ejemplo, si está utilizando MS Word, utilice la opción "Guardar como" y elija "Texto con separadores de líneas"
10. Si utilizó un Mac para generar el fichero, aegúrese de que lo transfiere como un archivo de texto (los ordenadores con Unix tienen diferentes códigos para señalar saltos de línea que los Mac, por lo que su fichero podría ser interpretado por Unix como conteniendo una sola línea larga).

Transfiera su plantilla de email al servidor WWW y recuerde la ruta o URL.

3. Asegúrese de que ACTION está bien definida.

La parte más complicada del formulario HTML es definir correctamente el comando ACTION. Empiece con la URL de su plantilla de email, luego divídala en dos partes, por ejemplo,

http://www.su dominio.es/plantilla.txt
\                      /\            /
 `----- Parte1 -------'  -- Parte2-- 

A continuación añada el nombre del script en la parte central.

http://www.su dominio.es/cgi-bin/cgiemail/plantilla.txt
\                       /\               / \          /
 `-------- Parte1 -----'  -nombre script-   - Parte2 -'

4. Repase lo que ha hecho si no recibe un correo

Generalmente el correo no es enviado de forma sincronizada. Esto quiere decir que el correo enviado pasa a una cola para ser enviado en un momento más conveniente. El correo enviado de esta forma es más eficiente y fiable, aunque tiene la desventaja de que sólo se puede informar de los problemas enviando un mensaje de error al remitente. El sistema de mail interpreta que el remitente del correo es el servidor web, por lo que Ud. no recibirá el mensaje de error.

Si no está recibiendo sus mails, puede utilizar de forma temporal el sistema sincronizado de envío. Para esto tendrá que crear un campo de entrada oculto llamado cgiemail-mailopt y asignarle un valor "sync". Por ejemplo,

<INPUT TYPE="hidden" NAME="cgiemail-mailopt" VALUE="sync">

Note: Esto no funcionará si está trabajando con la versión 1.1. Pídale a su webmaster que le instale la versión 1.2. Algunos mailers cuentan con una extensión no estándar que hace que los correos mal enviados vayan a la dirección especificada en un campo de cabecera llamado Errors-To: . Aún así, algunos errores producen que este campo sea ilegible, por lo que nunca se puede estar seguro de adónde van a ir estos correos mal enviados.

5. Crear formularios en HTML más avanzados..

Para aprender a crear formularios más complicados, lea la guía NCSA. Todos los formularios que se ponen como ejemplo pueden convertirse a formularios de cgiemail simplemente cambiando la ACTION. A diferencia de otros programas de tipo forms-to-email, no necesitará definir campos de entradas de datos ocultos con nombres especiales.

Cualquier tipo de botón que quiera definir (radio, etc.) funciona de la misma forma. Cada campo de entrada de datos requiere un NAME (nombre), denominación que deberá aparecer entre paréntesis cuadrados en su plantilla de email. Es tan simple como todo eso. Para más información, vea la página de ejemplo de cgiemail..

Opcional: Añadir texto a la página de éxito.

Cuando se envía un correo aparece una página titulada "Success" (Éxito) junto al texto del mensaje. Puede utilizar una variable oculta llamada ``addendum'' para añadir su propio texto. Vea un ejemplo sencillo:

<INPUT TYPE="hidden" NAME="addendum" VALUE="Gracias!">

Si asume que los visitantes de su formulario disponen de un navegador de reciente aparición como Lynx 2.6 o Netscape 3.0, puede incluso resaltar esta variable utilizando las entidades de carácter apropiadas. Por ejemplo, si quisiera añadir

Gracias!

el resultado en HTML sería

<em>Gracias!</em>

lo cual significa que tendría que poner lo siguiente en su formulario:

<INPUT TYPE="hidden" NAME="addendum"
 VALUE="Gracias!">

Dése cuenta de que, además de ser difícil de codificar, se trata de una función que no verán aquellos que luego estén utilizando versiones de navegadores antiguas.

Opcional: Utilizar una página de éxito diferente.

Si no le gusta la página por defecto que aparece cuando se envía un correo con éxito, puede especificar una URL diferente utilizando en su forma HTML una variable oculta llamada ``success''. Por ejemplo:

<INPUT TYPE="hidden" NAME="success" 
VALUE="http://123web.com.ar/web/mail-ok.htm>

Nota:Comience su URL con / o con http://. Si no lo hace así, cgiemail instruirá a su navegador que vuelva a ejecutar cgiemail por segunda vez y acabará apareciéndole un error "No variable substitutions".

En la versión 1.2 sigue sin haber un sistema para que aparezca en la página de éxito algún dato de los que el usuario haya rellenado en el formulario.

Opcional: Defina campos como de imprescindible cumplimentación.

Si quiere rechazar automáticamente aquellas formas que tengan determinados campos en blanco, añada el prefijo ``required-'' al nombre del campo, tanto en el formulario HTML como en su plantilla de email. Vea un ejemplo:

En el formulario HTML:

Su nombre: <INPUT NAME="required-sunombre">

En la plantilla de email

Su nombre:      [required-sunombre]

Opcional: Especifique el formato de algunos campos.

Si en su plantilla de email el texto que aparece dentro paréntesis cuadrados comienza con %, cgiemail utilizará la función printf() en C en el nombre del campo después de la coma. Si no está familiarizado con esta función, consulte un libro sobre C. Si sí estuviera familiarizado, recuerde estas dos diferencias:

1. El primer cararácter del string debe ser un signo %.
2. Caracteres como \n y \t deben ser literales. Si quiere un salto de línea, deberá ponerlo justo antes de la coma, aunque esto le resulte extraño. Por ejemplo, si Godzilla's Pizza quisiera que sus pizzas apareciesen una en cada línea, deberían poner lo siguiente en su plantilla de email:

   
    [%s,topping]
   

Opcional: Use variables de entorno CGI.

Esta función puede funcionar o no dependiendo si su webmaster la activó cuando configuró su cgiemail.

Además de los campos de entrada de datos de su formulario, su plantilla puede incluir variables de entorno CGI. Para esto lo que tendrá que hacer es incluir el carácter $ antes del nombre de la variable. Por ejemplo, el comando

        [$HTTP_USER_AGENT]

añadirá el nombre del navegador y/o del gateway de su cliente en el mensaje de email. Para respetar la privacidad, su forma HTML debería comunicar a los clientes que el email incluirá estos u otros datos sobre los mismos. Por ejemplo: HTTP_USER_AGENT, REMOTE_ADDR.  

Diseño de Sitios Web. Hosting de paginas web. Registro de dominios. Comercio Electronico, portales, e-comerce, e-commerce, alojamiento de sitios web en plataformas Unix y Windows, casillas pop e-mails. forward email, webmail, webmasters, diseñadores, cobro con tarjetas de credito, buscadores, yahoo, google, altavista, msn, yuppi, yupi, terra.