dw-mailer - form mailer - installation instructions
last update 17.04.2019

Here you can activate our form generator. In four steps to your own form without any html-knowledge

Begin your form with the following line:

For the free version (financed by publicity) as well as for the payable version (free of publicity) you use:

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

It is up to you which and how many form fields you place afterwards. The 'dw-mailer' looks after the correct selection and the right description of your fields - no matter if you there are umlauts or space signs in your fields.

Do not forget to set the finish at the end of the form. After button -sending- you put in:

</form>

Set the e-mail recipient and name (recipient, recipient_name)

You may choose the name as well as the address of the recipient on your own.

<input type="hidden" name="recipient_name" value="Your Name">
<input type=
"hidden" name="recipient" value="e@Mail.com">

The sender e-mail and name form field (sender_mail, sender_name)
<input type="text" name="sender_name" size="12">
<input type=
"text" name="sender_mail" size="12">

  

Information:
Please consider the identical way of writing with all variables and form field descriptions. (also capital or small letters)
Attention: You absolutely have to include the two following variables
"recipient"  and  "sender_mail" in the form, otherwise dw-mailer cannot work correctly!!!


All other possibilities you may use in order to adjust the form to your page in an optimal way.

Set the e-mail recipient and name in hidden variable (sender_mail, sender_name)
You would like to set a fix sender (e. g. with automatic applications). In this case please hidden fields:
The e-mails that you receive all have a sender to whom you can forward the e-mails.

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

Set a second e-mail recipient and name (only in the payment version)

The mail generated by your form may be sent to a second recipient at the same time.
Syntax of the mail addresse is checked by the program, the generated mail is going to be included in the payment, A data attachment possibly existing will not be sent. You may choose the name as well as the e-mail address of the second recipient on you own.

<input type="hidden" name="recipient_name2" value="Your Name">
<input type=
"hidden" name="recipient2" value="e@Mail.com">

A mailcopy to sender

The generated mail of your form may also be sent to the sender (sender_mail) as a mail copy.
(e.g. order from online shop, copy of the merchandise trolley for sender)

<input type="hidden" name="copy_to_sender" value="on">

You can also choose the subject of the mail copy on your own
<input type="hidden" name="copy_subject" value="Your order regarding the printout">

Set the e-mail subject

You can set the subject of the e-mail sent via 'dw-mailer'by the following line in your HTML-form:

<input type="hidden" name="subject" value="Enquiry contact page">

Issue an e-mail template (for formation of the mails in the text format)

'dw-mailer' standard supplies an e-mail to the recipient given in which all form fields are shown one by one. If you prefer another format (for further data processing, taking over datebase etc.), you may create a template having the form of a text file. Thist text will be used later in order to write an e-mail. For showing the content of the form fields in an e-mail, you can use variables. You describe a variable by putting the name of the form field into angular brackets [] . This variable will be replaced automatically by the content of the corresponding form field. A template e. g. could look like that:

Hello!

sender text of the textbox:
[sender_text]
from [sender_mail].

Yours sincerely
[sender_name]

further sender data:
company:   [sender_company]
phone: [sender_telephone]
fax:     [sender_fax]
e-mail:   [sender_mail]
answer: [sender_answer]

This form was filled in by:
[%HTTP_REFERER]

Create the text of the template e.g. with note pad oder via another text editor and store it in your server. (web storage place)
Include the following line in your HTML-form:

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

'your_domain.com' has to be replaced by you domain name of course!
email.txt
is the file name of your e-mail template.
allowed file endings of your template are:
(*.txt *.tmpl *.dat)

Issue a responder mail template (thanks or confirmation)

dw-mailer standard usually does not supply any e-mail to the e-mail sender entered in the form. If you would like to activate an automatic responder you require a template in form of a text file. This text will be used for creating the responder mail. In order to describe the content of the form fields in your e-mail you can also use variables here of course.
A template for the responder mail e. g. could look like this:

To
Mr./Mrs./Company
[sender_name]
[sender_mail]

Thank you very much for filling in the form with
[%HTTP_REFERER]!

Processing will follow soon

Yours sincerely
Signature

Create the text of the template e.g. with note pad oder via another text editor and store it in your server. (web storage place)
Include the following line in your HTML-form:

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

'your_domain.com' has to be replaced by you domain name of course!
thankyou.txt is the file name of your responder template.
allowed file endings of your template are:
(*.txt *.tmpl *.dat)

Here you can determine the subject of the responder mail on your own
<input type="hidden" name="respond_subject" value="Thank you for your order">

Activate sender's confirmation of responder's mail

If required you can activate a sending confirmation of the sender. When reading the responder mails the sender is asked to acknowlegde receipt.

<input type="hidden" name="respond_notification" value="on">

Produce a page of confirmation with replacement of variables (only with the payable version)

'dw-mailer' standard usually does not supply a standard-HTML-page which shows the user that all data have been entered in the form and transferred correctly. You may easily replace this page by an HTML document of your choice on demand. Here you can also use variables of course. In order to do this please create/prepare the HTML document you wish according to your wishes and ideas. Variables can be included again with angular brackets [] and the corresponding form field name.
Your answering page could look like this for example:

<html>

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

<body>
</center>
<table border=
"0" cellpadding="3" cellspacing="0" width="100%">
<tr>
<td width=
"100%" bgcolor="#EFEFEF"><b>Confirmation</b></td>
</tr>

<tr>
<td width=
"100%">
<p><br>

Dear Sir/Madam <b>[sender_name]</b></p>
<p>
Thanks for your enquiry.<br>
A mail of confirmation was sent <b>[sender_mail]</b> to <br>
</p>

<blockquote>
<p><b>
e-mail:</b> [sender_mail]<br>
<u><b>
Your enquiry text:</b><br>
</u>
[sender_text]<br>
</p>
</blockquote>

<p>If any of these data should not be correct please proceed to the <a href="javascript:history.back(1)"><b>entering form
(back)</b></a>and change the corresponding entries.<br>
Thank you for your support</p>
<blockquote>
<p>
Yours sincerely</p>
<p><b>
Signature</b></p>
</blockquote>

<pre>
IP Address....: [%REMOTE_ADDR]
Remote Host...: [%REMOTE_HOST]
</pre>

</td>
</tr>
</table>

</body>

</html>

 

In order to choose your answering page please include the following line in your HTML form:

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

'your_domain.com' has to be replaced by you domain name of course!
ok.html
should be the name of the answering page file.
allowed data file endings for the answering page are:
*.htm, *.html, *.shtml, *.php, *.php3, *.txt, *.tmpl, *.dat

Prepare the file with a HTML editor or notepad and store it at your server. (web storage place)

Produce a page of confirmation without replacement of variables (only with the payable version)

If you do not need any input variables with the form of the confirmation page you can also use variable 'html_redirect_url' instead of variable 'html_template_url'. It will be diverted directly to a page of confirmation of your choice. (redirect)
This variable has got priority over 'html_template_url'. (only with the cost version)

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

Define required fields

You can determine which fields have to be filled in by your customers in any case. If these fields are ignored 'dw-mailer' breaks off processing and shows the standard error page. In order to prescribe e. g. the fields name and telephone.

Your name: <input type="text" name="sender_name" size="12">
Phone: <input type="text" name="sender_telephone" size="12">

You insert the following line into your HTML form:

<input type="hidden" name="required" value="sender_name,sender_telephone">

Under value=" " you may set as many form fields as you like. You just have to separate each other by placing a comma.
The variable sender_mail is an obligation field automatically and has therefore not to be indicated as obligation/duty field.

Issue error output with replacement of variables (only with the payable version)

'dw-mailer' supplies a standard error page in case of a mistake which shows the user that an error happened. (e.g. obligation fields have to been filled in, no correct e- mail address entered or attached data file is too large) On request you may easily replace this page by an HTML-document of your choice. Here you can also use the variables. For that please create the requested HTML-document according to your wishes. Variables can be included with angualar brackets [] and the corresponding form field name. The error emission could look like this:

<html>

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

<body>
<table border=
"0" cellpadding="3" cellspacing="0" width="100%">
<tr>
<td width=
"100%" bgcolor="#EFEFEF"><b>[%_T]</b></td>
</tr>
<tr>
<td width=
"100%">
<p><br>
[%_M]</p>

<pre>
IP Address....: [%REMOTE_ADDR]
Remote Host...: [%REMOTE_HOST]
</pre>
</td>
</tr>
</table>
</body>

</html>

In order to call on the requested error description page please insert the following line in your HTML-form

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

'your_domain.com' has to be replaced by you domain name of course!
error.html
should be the data file name of your error emission.
Allowed data file endings for your emission page are:
*.htm, *.html, *.shtml, *.php, *.php3, *.txt, *.tmpl, *.dat

Prepare the file with a HTML editor or notepad and store it at your server. (web storage place)


These two variables [%_T]  and [%_M] stand for title of error and description of the type of mistake.
You should also be integrated in your HTML-page in order to see the errors you caused.

Information:
Please consider the identical way of writing with all variables and form field descriptions. (also capital or small letters)

Issue error output without replacement of variables (only with the payable version)

If you do not require insertion variables in the form or your error emission page, you may also use variable 'error_redirect_url'instead of 'error_url'. In case of false fill-in of the form you will be diverted to an error page of your choice. (redirect) This variable has got priority over 'error_url'. (only with the cost version)

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

Sending files in the mail attachment

In case you would like to receive data files from your visitors (e.g. a picture a curriculum vitae or some design etc.), there is -of course- a function included in the 'dw-mailer'. You may receive five data files by each visitor at most.
For this please use the following HTML-code:

Sending data 1: <input type="file" name="file_upload">
Sending data 2: <input type="file" name="file_upload_2">
Sending data 3: <input type="file" name="file_upload_3">
Sending data 4: <input type="file" name="file_upload_4">
Sending data 5: <input type="file" name="file_upload_5">

Thus your visitor is able to choose a data file of its hard disc which will be sent to the indicated recipient of the form. Data files up to a size of 15KB (with the free version) can be sent/dispatched. In order to receive larger data files you have to use the cost version of 'dw-Mailer' that is free of publicity. Here - in the standard version- 5 Mbytes per data attachment are allowed.

Here is the list of permitted endings for uploading data.
*.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

Activate csv data with automatic mail sending

Maximally a store capacity of 1024 Kb are at your disposal for storing a csv-data file. in the member area you may set a storage capacity. If this capacity is exceeded the csv-data will be sent to the 'recipient' in the form automatically and sets free the existing storage capacity again. In the member sector there is always the possibility to start downloading your csv-data. The actual size of your data file is shown to you in kbytes.

For activating csv data storing please insert the following line in your HTML-form:

<input type="hidden" name="csv" value="on">

If you include the above mentionned line only, all form field input will be stored one by one separated by commas in your personal data base. One line per each generated mail. In order to store form field input for your excel program just include an additional line into your HTML-form:

<input type="hidden" name="csv_selection" value="fieldname_1,fieldname_2,one_further_field name">

Under value=" " you may set as many form fields as you like. You just have to separate each other by placing a comma.

Environment variables (Special variables)

Besides the variables which you generate in your form there is also the possibility to include some special variables directy in your template.
In the following you see the possible variables:

[%_AUTO_NUMBER]
unique number

[%_Ticket_ID]
ticket ID

[%DATE]
date

[%TIME]
time

[%REMOTE_ADDR]
Shows the IP-address of the visitor.

[%REMOTE_HOST]
Indicates the HOST-address of the visitor (provider).

[%HTTP_REFERER]
Indicates the URL of the form page unless all are suppressed by firewalls etc.

[%HTTP_USER_AGENT]
Indicates the browser your visitor is surfing with.

Standard output multilanguage

If you would like to offer your forms in different languages there is -of course- a program function included in the 'dw-mailer'.
You have the possibility by inserting one of the following variables to control the standard page emission (error and confirmation) linguistically.
For this please use the following HTML-code:

Output in english:
<input type="hidden" name="language" value="en">

Output in french:
<input type="hidden" name="language" value="fr">

Output in spanish:
<input type="hidden" name="language" value="es">

Output in italian:
<input type="hidden" name="language" value="it">

Output in hungary:
<input type="hidden" name="language" value="hu">

Output in norwegian:
<input type="hidden" name="language" value="no">

Output in danish:
<input type="hidden" name="language" value="dk">

The standard emission/output is German. For this it is not necessary to include an HTML-code.

HTML-code for an easy example form

<html>

<head>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
<title>
Contact form</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_telephone">
<input type=
"hidden" name="recipient_name" value="Your Name">
<input type=
"hidden" name="recipient" value="info@your_domain.com">
<input type=
"hidden" name="subject" value="Enquiry contact page">
<input type=
"hidden" name="language" value="en">
<table border=
"0" cellpadding="3" cellspacing="0">
<tr>
<td width=
"100%" bgcolor="#EFEFEF"><b>Contact form</b></td>
</tr>
<tr>
<td width=
"100%">Get in contact with us!
<table border="0" cellspacing="3" width="400">
<tr>
<td bgcolor=
"#ECECEC"><b>Company</b></td>
<td><input type=
"text" name="sender_company" size="20"></td>
</tr>
<tr>
<td bgcolor=
"#ECECEC"><b>Name</b></td>
<td><input type=
"text" name="sender_name" size="20"></td>
</tr>
<tr>
<td bgcolor=
"#ECECEC"><b>Street</b></td>
<td><input type=
"text" name="sender_street" size="20"></td>
</tr>
<tr>
<td bgcolor=
"#ECECEC"><b>Address</b></td>
<td><input type=
"text" name="sender_address" size="20"></td>
</tr>
<tr>
<td bgcolor=
"#ECECEC"><b>Telephone</b></td>
<td><input type=
"text" name="sender_telephone" size="20"></td>
</tr>
<tr>
<td bgcolor=
"#ECECEC"><b>Telefax</b></td>
<td><input type=
"text" name="sender_fax" size="20"></td>
</tr>
<tr>
<td bgcolor=
"#ECECEC"><b>Email</b></td>
<td><input type=
"text" name="sender_mail" size="20"></td>
</tr>
<tr>
<td bgcolor=
"#ECECEC"><b>Answer</b></td>
<td><select size=
"1" name="sender_answer">
<option selected value=
"please select">please select</option>
<option value=
"by telephone">by telephone</option>
<option value=
"by e-mail">by e-mail</option>
<option value=
"by telefax">by telefax</option>
</select></td>
</tr>
<tr>
<td colspan=
"2"><b>Your comment/text</b></td>
</tr>
<tr>
<td colspan=
"2"><textarea rows="8" wrap="soft" name="sender_text" cols="45"></textarea></td>
</tr>
<tr>
<td colspan=
"2" height="72"><br>
<input type=
"submit" value="send"> <input type="reset" value="reset"></td>
</tr>
</table>
</td>
</tr>
</table>
</form>

</body>
</html>

 

Prepare the file with a HTML editor or notepad and store it at your server. (web storage place)
Im Beispielformular sind natürlich die Angaben "Your Name" and "info@your_domain.com" to be replaced by your name resp. e-mail address.

© 1999-2019 DIS dürr-internet-service | alle Rechte vorbehalten