[an error occurred while processing this directive][an error occurred while processing this directive]FormMail Help: Sending Data From a Web Form to an Email Address
This is a highly configurable, general purpose perl script, and is callable by anyone using CSM web services. It allows users to create an HTML FORM, have the results e-mailed to a designated address, and present the client with a "Thank you" page.
NOTE: The recipient e-mail address must either be (1) an e-mail address in the Mines.EDU domain (for example: username@mines.edu or user.name@is.mines.edu); or (2) if the address is not a Mines.EDU address, you must open a ticket at Mines Help Center and request that your recipient e-mail address be added to the "@recipients" array (you will need to include information about the intended URL of your web form, the purpose of your web form and information about to whom the form results are to be sent.)
This version was created by Matthew Wright (http://www.scriptarchive.com/) with some minor changes made for CSM.
The FormMail-Readme is available here.
Four additions have been made to FormMail.pl for CSM use.
- A cc_email (for sending a CC email) and a replyto (to set a different replyto email address instead of the "From" address) parameter. These work similar to the email parameter (the person who is filling out your form can indicate their email address). None, one or more of these can be used in a form.
- A parameter named send_cc_to_email has been added. Use this if you want a copy of the message to be sent to the email address that the user enters into the form (in addition to the copy that is sent to the "recipient"). To use this paramter, you should make "email" a required parameter and set the "send_cc_to_email" flag. Your "hidden input" commands should include lines similar to:
<INPUT TYPE="HIDDEN" NAME="required" VALUE="email">
<INPUT TYPE="HIDDEN" NAME="send_cc_to_email" VALUE="yes">
This can be used in conjuction with the cc_email parameter. By using the email, send_cc_to_email, and cc_email parameters, you could send a copy of the same message to the recipient and additionally to the email addresses that get filled in for email and cc_mail.
- Code has been added so that the web address (URL) of the web page that calls FormMail.pl is included in the email message that is sent and on the "result" web page that is displayed after the form is submitted.
TWO REQUIRED STATEMENTS
- The opening FORM statement should be (you must use POST, GET is not valid):
<FORM METHOD="POST" ACTION="http://www.mines.edu/csm-cgi-bin/FormMail.pl">
- Between the <FORM> and </FORM> tags, the HTML file MUST contain the following HIDDEN INPUT statement:
<INPUT TYPE="HIDDEN" NAME="recipient" VALUE="youremail@mines.edu">
recipient must be lowercase. The recipient is the email address to which the FORM results will be sent.
Notes:
- TYPE="HIDDEN" statements: this information is sent to FormMail.pl and is included in the FORM results, but the person filling out the FORM will not see this information.
- other TYPE statements (eg, text, textarea, radio, etc): this information is collected from the person filling out the FORM and is included in the FORM results.
Some useful predefined INPUT statements (Predefined NAMEs must be lowercase as shown. For other predefined INPUT statements, see FormMail-Readme.txt):
- <INPUT TYPE="HIDDEN" NAME="subject" VALUE="Your Subject">
Set the subject for the email message to be sent to you.
- <INPUT TYPE="HIDDEN" NAME="required" VALUE="email,realname">
Set VALUE to the NAME(s) of any field that you would like to be required input from the person filling out the FORM. Separate the VALUE names with commas.
Questions and comments -- open a ticket at Mines Help Center
Wednesday, 07-May-2008 10:34:32 MDT