Formmailer - Instrucciones de instalación.

últimamente actualizado el 21.05.2007

• Comenzar y terminar el formulario (form action)
• Colocar al destinatario del eMail (recipient, recipient_name)
• Colocar al remitente del eMail (sender_mail, sender_name)
• Predeterminar al remitente del eMail (sender_mail, sender_name)
• Colocar la linea de asunto del eMail
• Elaborar un eMail Template (para el formateo del Mail en formato de texto)
• Elaborar la página de confirmación sin variable sustituible
• Definir los espacios obligatorios
• Elaborar la página de indicación de error sin variable sustituible
• Enviar un fichero como anexo
• Variables de entorno (variables especiales)
• Edición por defecto en varios idiomas
• Código HTML para un formulario muestra simple

Emplee:

<form action="http://www.dw-formmailer.de/cgi-bin/dwmailer/dwmailer.pl" method="post" enctype="multipart/form-data">

o SSL-secured (128bit)

<form action="https://www.dw-formmailer.de/cgi-bin/dwmailer/dwmailer.pl" method="post" enctype="multipart/form-data">

Cuales y cuantos formularios ponga Ud. depende de Ud. El 'dw-Mailer' se ocupa de la correcta elección y representación de sus espacios - igual, si han sido utilizados metafonías o caracteres blancos en los nombres de los espacios.

No se olvide de poner al final del formulario el Cierre del formulario. Entonces coloque Ud. detrás del botón de envío:

</form>

Colocar al destinatario del eMail (recipient, recipient_name)

Ud. mimso puede determinar tanto el nombre como la dirección del destinatario de eMail.

<input type="hidden" name="recipient_name" value="Su nombre">
<input type="hidden" name="recipient" value="Su_Organizacion@Xarxa21.org">

Aquí hay que poner la dirección de e-mail a la cual se quiere que lleguen los mensajes. Debe ser una dirección de correo alojada en Xarxa21, por motivos de seguridad no puede ser una dirección externa

Aviso:
Por favor tenga cuidado de que esté congruente el deletreo (también mayúsculas/minúsculas) en todas las variables y definiciones de espacio del formularion
Atención: Es indispensable que introduzca las dos variables
"recipient"  y  "sender_mail" en el formulario,de lo contrario el dw-Mailer no funciona correctamente !!!

Todo lo demás puede Ud. utilizar, para adoptar el formulario en forma optima a sus páginas.

<input type="hidden" name="sender_name" value="Su nombre">
<input type="hidden" name="sender_mail" value="e@Mail.com">

Puede Ud. determinar aquí el asunto (Subject) del eMail enviado por el 'dw-Mailer' mediante la siguiente linea en su formulario Html:

<input type="hidden" name="subject" value="Demanda página de contacto">

Por defecto el 'dw-Mailer' entrega un eMail al destinatario indicado en la cual se muestran todos los espacios del formulario uno trás otro. Si prefiere otro formato (para el procesamiento subsiguiente, la transferencia del banco de datos, etc.), puede crear Ud. un Template en forma de un fichero de texto. Después, este texto será tomado para escribir el eMail. Para copiar el contenido de los espacios del formulario en el eMail, puede utilizar variables. Usted describe una variable, poniendo el nombre de los espacios del formulario entre paréntesis cuadradas []. Esta variable será entonces automáticamente sustituida por el correspondiente contenido del espacio-formulario. Un Template podría por ejemplo tener la siguiente forma:

¡Hola!

el texto del remitente del Textbox:
[sender_comentario]
de [sender_mail].

Con cordiales saludos
[sender_name]

Otro datos del remitente:
Empresa:   [sender_empresa]
Teléfono: [sender_teléfono]
Télefax:     [sender_télefax]
eMail:   [sender_mail]
Respuesta: [sender_respuesta]

Este formulario fue rellenado por:
[%HTTP_REFERER]

Elabore el texto para el Template p.ej. con el Notepad o con otro editor de textos y grábelo en su Server. (Sitio de almacenamiento del Web)
Añade al formulario HTML la siguiente linea:

<input type="hidden" name="email_template_url" value="http://your_domain.com/email.txt">

'your_domain.com' se debe reemplazar naturalmente con su nombre de Domain!
email.txt Sea el nombre de fichero de su eMail Template.
Terminaciones de fichero permitidas para el Template son:
*.txt, *.tmpl, *.dat, *.htm, *.html, *.shtml, *.php, *.php3

Si no necesita Variables de introducción del formulario en la página de confirmación, puede utilizar en vez de la variable 'html_template_url' la Variable 'html_redirect_url'. Será dirigido directamente hacia una página de confirmación de su elección. (Redirect)
Esta variable tiene preferencia sobre 'html_template_url'. (sólo en la versión con costo)

<input type="hidden" name="html_redirect_url" value="http://your_domain.com/any_page.html">

Puede determinar, cuántos espacios deben ser llenados por sus clientes en todo caso. Cuando al rellenar estos espacios hayan sido omitidos, el 'dw-Mailer' interrumpe el trámite und muestra una página de error por defecto. Por ej. para prescribir los espacios para el nombre y teléfono,

Su nombre: <input type="text" name="sender_name" size="12">
Teléfono: <input type="text" name="sender_teléfono" size="12">

<input type="hidden" name="required" value="sender_name,sender_teléfono">

Bajo value=" " puede colocar tantos espacios como quiera. Cada uno deberá separlo con una coma.
La variable sender_mail representa automáticamente un espacio obligatorio y por ello ya no debe ser introducida como espacio obligatorio.

Si no necesita introducir variables del formulario en la página de indicación de error, podrá utilizar en vez de la variable 'error_url' la variable 'error_redirect_url' verwenden. Al llenarse el formulario incorrectamente será dirigido directamente hacia una página de indicación de error de su elección. (Redirect) Esta variable tiene preferencia frente a la de 'error_url'.

<input type="hidden" name="error_redirect_url" value="http://your_domain.com/any_page.html">

Si quiere Ud. recibir un fichero de sus visitantes(por ej. una foto, un currículum o un gráfico etc.), el 'dw-Mailer' también para ello ofrece un función. Puede recibir 5 ficheros como máximo de cada visitante.
Utilice Ud. en su formulario el código HTML siguiente:

Envío de fichero 1: <input type="file" name="file_upload">
Envío de fichero 2: <input type="file" name="file_upload_2">
Envío de fichero 3: <input type="file" name="file_upload_3">
Envío de fichero 4: <input type="file" name="file_upload_4">
Envío de fichero 5: <input type="file" name="file_upload_5">

Su visitante ahora tendrá la posibilidad de elegir de su disco duro un fichero que se enviará al destinatario del formulario indicado. Es posible enviar ficheros de un tamaño de 15KB como máximo (en la versión con costo). Para poder recibir ficheros más grandes, deberá utilizar la versión sin publicidad (con costo) del 'dw-Mailer'. Ésta, como vesrión por defecto, permitirá 2 MByte para cada anexo de fichero.

Aqui tiene Ud. la lista de terminaciones permitidas para el Upload de ficheros.
*.jpg, *.gif, *.png, *.zip, *.exe, *.mp3, *.pdf, *.html, *.htm, *.php, *.php3, *.php4, *.pl, *.cgi, *.wav, *.rar, *.ace, *.txt, *.dll, *.reg, *.cab, *.bat, *.tar, *.doc, *.jpeg, *.cdr, *.eps, *.psd

Adicionalmente a las variables que genere Ud. de su formulario, tendrá la posibilidad de incorporar directamente en su Template una serie de variables especiales.
Vea Ud. a continuación un resúmen de las variables de entorno posibles:

[%REMOTE_ADDR]
Indica la dirección IP del visitante.

[%REMOTE_HOST]
Indica la dirección HOST del visitante (Provider).

[%HTTP_REFERER]
Indica la URL de la página de formulario, siempre que ésta no fuere suprimida por Firewalls o sistemas similares.

[%HTTP_USER_AGENT]
Indica el browser con qué surfea su visitante.

Si quiere Ud. ofrecer sus formularios en varios idiomas, sírvase activar la función ofrecida por el 'dw-Mailer'.
Empleando una de las variables siguientes tendrá la posibilidad de ajustar las páginas de edición por defecto (errores y confirnación) acerca de los idiomas.
Utilice Ud. en su formulario el código HTML siguiente:

Edición den inglés:
<input type="hidden" name="language" value="en">

Edición den francés:
<input type="hidden" name="language" value="fr">

Edición en español:
<input type="hidden" name="language" value="es">

Edición en italiano:
<input type="hidden" name="language" value="it">

Edición in hungary:
<input type="hidden" name="language" value="hu">

La lengua por defecto es alemán. Para ella no es necesario incorporar un código HTML.

<html>

<head>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
<title>Formulario de contacto</title>
</head>

<body>
<form action="http://www.dw-formmailer.de/cgi-bin/dwmailer/dwmailer.pl" method="POST" enctype="multipart/form-data">
<input type="hidden" name="required" value="sender_name,sender_teléfono">
<input type="hidden" name="recipient_name" value="Su nombre">
<input type="hidden" name="recipient" value="info@xarxa21.org">
<input type="hidden" name="subject" value="Demanda página de contacto">
<input type="hidden" name="language" value="es">
<input type="hidden" name="html_redirect_url" value="http://confirma.xarxa21.org.es">
<input type="hidden" name="error_redirect_url" value="http://error.xarxa21.org.es">
<table border="0" cellpadding="3" cellspacing="0">
<tr><td width="100%" bgcolor="#EFEFEF"><b>Formulario de contacto</b></td>

</tr>
<tr>
<td width="100%">Póngase en contacto con nosotros!
<table border="0" cellspacing="3" width="400">
<tr>
<td bgcolor="#ECECEC"><b>Empresa</b></td>
<td><input type="text" name="sender_empresa" size="20"></td>
</tr>
<tr>
<td bgcolor="#ECECEC"><b>Nombre</b></td>
<td><input type="text" name="sender_name" size="20"></td>
</tr>
<tr>
<td bgcolor="#ECECEC"><b>Calle</b></td>
<td><input type="text" name="sender_calle" size="20"></td>
</tr>
<tr>
<td bgcolor="#ECECEC"><b>Código postal/Lugar</b></td>
<td><input type="text" name="sender_adress" size="20"></td>
</tr>
<tr>
<td bgcolor="#ECECEC"><b>Teléfono</b></td>
<td><input type="text" name="sender_teléfono" size="20"></td>
</tr>
<tr>
<td bgcolor="#ECECEC"><b>Télefax</b></td>
<td><input type="text" name="sender_télefax" size="20"></td>
</tr>
<tr>
<td bgcolor="#ECECEC"><b>Adress del email</b></td>
<td><input type="text" name="sender_mail" size="20"></td>
</tr>
<tr>
<td bgcolor="#ECECEC"><b>Respuesta</b></td>
<td><select size="1" name="sender_respuesta">
<option selected value="Elija por favor">Elija por favor</option>
<option value="por teléfono">por teléfono</option>
<option value="por email">por email</option>
<option value="por télefax">por télefax</option>
</select></td>
</tr>
<tr>
<td colspan="2"><b>Su comentario/texto</b></td>
</tr>
<tr>
<td colspan="2"><textarea rows="8" wrap="soft" name="sender_comentario" cols="45"></textarea></td>
</tr>
<tr>
<td colspan="2" height="72"><br>
<input type="submit" value="enviar"> <input type="reset" value="retroceder"></td>
</tr>
</table>
</td>
</tr>
</table>
</form>

</body>
</html>

Elabore el fichero con un editor HTML o Notepad y grábelo en su Server. (Sitio de almacenamiento del Web)
En el formulario modelo deberán naturalmente sustituírse los datos "Su nombre" y "info@xarxa21.org" con su nombre o bién dirección email.