|
Does WingNET have a mail script that I can use?
Yes, the name of our script is mailto.cgi.
The mailto.cgi program is set up to handle web form postings.
The following are the specs to help you in designing your form. Please
note, however, there is minimal support given for this mail script. All
questions must be submitted via e-mail to
webmaster@wingnet.net
to
receive support and assistance.
Common Items You Need to Know
-
In your FORM statement, the ACTION command should point to "/cgi-bin/mailto.cgi"
-
In your form itself, there are two required fields. These are "to" and
"subject." These can be hidden fields (and normally should be) with the
VALUE of "to" being the internet address you want the results of the
form mailed to. You can use the "subject" field to force the subject
line to be anything you want. We use it to give a unique subject line
that we can then use for e-mail sorting functions within our e-mail client
software.
-
All other INPUT fields will be displayed in the e-mail message itself
sent to the party at the "to" address.
-
The person filling out the form will see an online copy of their input.
-
The CGI program will attempt to resolve the internet address of the
sending party as closely as possible based on their assigned internet
address. THIS WILL NOT BE A VALID E-MAIL ADDRESS. If you want their
e-mail address, put an INPUT field in your form with the name of
"from" and ask for it specifically. This address resolution is only
for "mild" security considerations (e.g. if someone lists their e-mail
address as joe@schmoe.com, but the CGI address resolution shows their
internet address/domain to be "unknown@dialup-user23.mouse.net" then you
-might- question whether or not this is a valid/bogus response).
-
Please try your very best to resolve any discrepancies with the CGI "not
working" before contacting the WingNET Webmaster. We use this form for
many applications here, and it works consistently day after day. If you
require customization of the CGI program, we can do this at our normal
hourly rate for CGI programming.
Advanced Items You Can Use with MAILTO.CGI
The script also provides you the capability of defining certain variables
within your HTML form. Again, these should normally be hidden fields
which you will use to alter the output that the user will see after
clicking on the "Submit" button. The following is a list of the
available variables with a brief description of their use. NOTE: these
are case sensitive variables!
|
to
|
As mentioned above, the value of this field will be used to determine
where the user input is mailed.
|
|
cc
|
If used, a carbon copy of the user input will be e-mailed to this address.
|
|
from
|
This is usually used for the real e-mail address of the user (and thus
should be a user input field). Input in this field will actually be used
to make up the From: header of the e-mail message.
|
|
body
|
This variable is normally a "textarea" input field.
|
|
subject
|
As mentioned above, the "subject" variable is used in making the actual
subject line of the e-mail message sent with the user input. We
recommend making this a hidden/static value that will keep all input uniform.
|
|
continue_url
|
After the user has clicked the "Submit" button, they will be sent to the
results page. If you want the user to be able to click a hypertext link
back to your main site page or go forward to any other page, you must put
that reference here in this fashion: http://www.wherever.com/go_joe.html
(the script will add the hypertext tags to it). NOTE: You MUST also
have defined "continue_text" (below) to use this variable.
|
|
continue_text
|
This is the actual text you want highlighted in your forward/return link.
|
|
leading_spaces
|
If you do not want the e-mail message to put leading spaces at the
beginning of each input field in the resulting e-mail message, define
this variable with a value of "no" to turn them off.
|
|
separator
|
You can also define how you want the input field names and input data
separated in your e-mail message. The "separator" field can contain any
of the following values which will be used to separate field names from
data: colon (: ), dash ( - ), hyphen (-- ), line ( --- ), equal ( = ),
space ( ), tab ( ).
|
|
sort_order
|
The two values you can define for the variable "sort_order" are
"alphabetical" and "reverse alphabetical" (which do what they say). If
you do not define this variable, the input fields will be left alone.
|
|
required_fields
|
If you want to require the user to fill out certain fields before a
successful submission, you must define this field with a comma separated
list of the names of the fields the user must fill out.
|
|
body_bgcolor, body_background, body_link, body_vlink, body_text
|
These variables are grouped together for ease of explanation, but you
will make them separate variables in your HTML form. The values you
enter into these variables will determine the look of the results page
the user sees after successfully submitting input. These are to be used
as you would normally use them in an HTML document. Graphics (for
backgrounds) should have the full URL since output of the script is
relative to the CGI-BIN directory.
|
|
blurb, blurb2
|
The variables "blurb" and "blurb2" are available for you to be able to
customize the actual receipt the customer receives. You are free to put
actual HTML coding between the "" of the VALUE= statement of the hidden
field. However, BE WARNED that some browsers cannot handle the ">" even
though it is included within the quotes. MSIE 2.0 is a noticeable failure. |
|