Using Windows Hosting Form Mailers
This article only applies to Web Hosting. For more information, see What type of hosting account do I have?
We include form mailer scripts with new Windows shared hosting accounts: webformmailer.asp
and gdform.php
. To use a form mailer, create a Web form in HTML that links to one of our scripts and upload it to your hosting account.
NOTE: Do not use test@test.com
to test your form mailer.
WARNING: The gdform.asp
and gdform.php
files cannot be recovered if they are deleted.
The form mailers are not installed until you specify the email address you want to use with the form mailer in your account manager. For more information, see Specifying an Email Address for the ASP Form-Mailer.
webformmailer.asp
To Use webformmailer.asp
- Create a Web form, assigning unique names to your form fields.
- In the form tag, assign
_gdForm/webformmailer.asp
to the action attribute and set the form method topost
:
- In addition to the form fields you create, there are three hidden elements you can use.
form_format determines in what format the information is delivered. Its values are 'text', 'csv', 'html', 'xml', and 'default' (same as 'text').
form_order dictates in what order the fields are reported. Its values are 'default' (the same order as they appear on in the form), 'alpha' (alphabetized by field name) or a comma-separated, case-sensitive list of all or some field names.
form_interval determines the frequency and packaging of delivery. To receive one email per form submission, the form_interval values are 'default' (every 10 minutes), 'hourly', and 'daily'. To specify when the attached submissions are received, the form_interval values are 'digest', 'hourly_digest', and 'daily_digest'.
For example:
NOTE: The webformmailer.asp
file is accessed through a virtual directory. You cannot modify the file, and it does not display in the file manager.
gdform.php
Only Windows accounts running IIS 7 can use gdform.php
.
To Use gdform.php
- Create your Web form as normal and assign unique names to your form items.
NOTE: Keep in mind that our form-mailer script will sort the names of your form items alphabetically when it composes the email message. This is the order of precedence: uppercase letters, lowercase letters, numbers.
- For the form action line, enter
/gdform.php
. For example: - Set the form method to "post."
- In addition to the fields you create in your form, there are three special fields that you can use: subject, redirect, and email.
Subject. Controls the subject line in the form email.
Redirect. Controls the page that your visitors will see after they submit the form.
Email. Controls the return address for the form email.
For example:
- Save and upload your file to your hosting account.
gdform.asp
To Use gdform.asp
WARNING: As of October 29th, 2008, gdform.asp
is no longer offered on Windows shared hosting accounts. If your account does not have gdform.asp
, these instructions will not work.
- Create your Web form as normal and assign unique names to your form items.
NOTE: Keep in mind that our form-mailer script will sort the names of your form items alphabetically when it composes the email message. This is the order of precedence: uppercase letters, lowercase letters, numbers.
- For the form action line, enter
gdform.asp
. For example: - Set the form method to "post."
- In addition to the fields you create in your form, there are three special fields that you can use: subject, redirect, and email.
Subject. Controls the subject line in the form email.
Redirect. Controls the page that your visitors will see after they submit the form. If the page exists off your hosting root, the subdirectory must be specified.
Email. Controls the return address for the form email.
For example:
- Save and upload your file to your hosting account.
NOTE: Your file and gdform.asp
need to be placed in the same directory of your hosting account in order for the form to properly function. If the directory in which they reside is off your hosting account root, you must provide the complete confirmation page path in your code.
For information on reinstalling your default scripts, see Reinstalling the Default Scripts Directory on Windows Shared Hosting.