Pagina Utilidades - Formularios wwwmailplus -

Instrucciones de uso del WWWMAILPLUS 2.0

El wwwmailplus 2.0 es un programa cgi para que los formularios colocados en la Web, devuelvan los datos a una página o bien los envien a traves de e-mail a un destinatario.

Este programa CGI, puede usarse de varias maneras:

/cgi-bin/wwwmailplus No se define página de vuelta. En este caso si existe Home (index.htm), volverá a esta página, y si no existe, a la homepage del dominio desde el que se llama al programa. No se indica directorio por lo tanto todas las operaciones se realizan sobre el directorio principal del dominio.

/cgi-bin/wwwmailplus/directorio Indica el directorio donde se realizarán las operaciones (leer plantilla, leer MAXID). Al finalizar el programa volverá a la homepage del directorio indicado.

/cgi-bin/wwwmailplus/directorio/pagina Se indica directorio con las mismas implicaciones que en el parrafo anterior. Volverá a la página al finalizar el programa. Esta página puede incluir marcas de campo que se sustituyen por el valor que toma la variable en el formulario. Funciona de la misma manera que las Plantillas.

Plantillas

Las plantillas son ficheros de texto que incluyen marcas de la forma $campo$ (se admiten formato anteriores del wwwmailplus %campo% pero no se recomiendan). Las marcas se sustituyen por los valores de los campos en el formulario. Si la marca de campo es de la forma $$campo$ solo se incluye la linea en la que aparece esta marca en el resultado final si el campo contiene información.

Es posible incluir ademas los siguientes campos generados por el programa:

#fecha
#hora
#REMOTE_HOST Nombre del host desde el que envia el email
#REMOTE_ADDR IP del host desde el que envia el email

Las plantillas se leen del directorio indicado al llamar al programa. Si el directorio no incluye el archivo .wwwmailplus no podrá leerse.

También puede incluirse la marca #ID que se sustituye por un número único para cada mensaje. No se actualiza el #ID sino se indica introduciendo el campo ID entre los del formulario. En este caso el programa actualiza el contador dentro del fichero MAXID, por lo tanto este fichero ha de haber sido creado previamente con permisos de escritura y lectura para todos.

Ver plantilla wwwmailplus.prn

Ver plantilla wwwmailplus2.prn

Las plantillas pueden incluir código html para clientes de correo que lo soporten.

También puede utilizarse este sistema de marcas en la página de resultado del programa.

Ver resultado.htm

Parámetros de Configuración del programa
Campo	Ejemplo	Comentarios
_Para:		Destinatario, a quien se envía. Obligatorio
De:		Quien lo envía. Si no se indica este parámetro el programa toma como remitente el mismo destinatario. En estos casos la mayoría de clientes de email obligan a introducir el destinatario al responder al mensaje. MUY IMPORTANTE. este campo no se puede validar, la dirección puede ser incorrecta si el usuario no la completa correctamente.
Asunto:		Asunto del mensaje
Home:		Pagina de vuelta. Obsoleto. incluido por compatibilidad con wwwmailplus 1.0.
I.D.:		Identificador de Mensaje. Si se indica genera un identificador único para cada mensaje enviado. Puede incluirse en plantillas con el nombre #ID
Plantilla:		Plantilla para envio de mensaje a destinatario. Si se indica formatea los datos con el fichero de plantilla que incluye marcas que se sustituyen por los valores de los campos. El nombre de la plantilla ha de incluir la extension prn que sin embargo no debe indicarse en este campo. La plantilla se lee de distintas formas según el modo como se ha llamado al programa.
Plantilla2:		Plantilla para envio de mensaje a remitente. Genera un mensaje al remitente del mensaje formateado con esta plantilla
Campos que se incluyen en el mensaje. Puede incluir cualquier tipo y numero de campos. Los campos que empiezan con el simbolo "_" son obligatorios, el usuario ha de rellenarlos antes de poder enviar el mensaje.
Observaciones: