Usage Instructions for Form2Mail

current version: 1.4

It is assumed you are familiar with writing forms in HTML. If you need assistance with the syntax refer to the HTML Quick Reference.

The first line of your form should look like this:
<FORM action="/scripts/form2mail.pl" method="POST">

The one field that is required for the script to work is:
<INPUT type="hidden" name="recipient" value="<youremailalias>">.
For example, if your email address is bob@evergreen.edu then you should use ‘bob’ as the value of the recipient tag.

The following fields of the calling form are recognized by the script:

Input nameInput typeDescriptionDefault
recipienthidden Only field required by the script. This is the email address the message is being sent to. To send the form to multiple recipients separate them with a comma  
subjecttext/hidden Subject of the email message. Use input type=text if you want the user to be able to set the topic. WWW Form Submission
realnametext The name of the user filling out the form  
emailtext email address of the user filling out the form  
commentstextarea Textarea or field with the actual message of the sender  
requiredhidden defines what input fields must be filled out by the user. Use a comma-delimited list for the value, for example value="email,realname,phone"  
redirecthidden URL the script jumps to if you don't want to use the default return page.  
sorthidden Use this field if you want to specify the order in which the form fields are printed in the email body. value="alphabetic" for alphabetic sorting, value="order:field1,field2,field3,etc..." to choose a specific order. If you use "order:..." only the fields specified in sort will be transmitted, all others ignored.  
hide_blankshidden If you add this field to your form with a value of "1" fields not filled out by the user are not printed in the body of the email message.  
bgcolorhidden Background color of the return page. #FFFFFF
backgroundhidden Background image of the return page. Must be a complete URL  
text_colorhidden Color of text on the return page. #000000
link_colorhidden Color of links on the return page. #0000FF
vlink_colorhidden Color of visited links on the return page. #660099
alink_colorhidden Color of active links on the return page. #FF0000
titlehidden Title of the return page. Thank you
return_link_urlhidden The URL of the page the user gets to from the return page.  
return_link_titlehidden Title of the return link.  
font_facehidden Font face on return page  
font_sizehidden Font size on return page  
no_tablehidden set value to "1" if you don't want tables on the return-page  

All other fields will just show up in the body of the email message.