CGI Instructions: E-mail results

To have your Angelfire CGI form send you the results as E-MAIL

1. You need a page of html to put the form into. You can either put it in an existing page, or put it in a new page. To put it in a new page, it's easiest to create a new page in the Angelfire Web Shell, using the Advanced Editor. If you have to use the Basic Editor you will only be able to put the form in the "Text Block" area of a Basic page.
   
   You can also create a new page on your own computer, with your own HTML editing program, and when the page with the form is done (follow the steps below) you can upload it to your site by FTP or via the Web Shell like other pages.

   
   

2. Copy and paste the code clipping from above into your page.
   The code given is just an example - you will need to adjust it to fit your needs. You can add new form elements or rename the elements, but you have to make sure that you are using the exact formatting as our example, or it won't work. IMPORTANT: the "name" of your form elements must always be one word names. For example...

   BAD: <input type="text" name="street address" />

   GOOD: <input type="text" name="street_address" />

   
   

3. Now adjust the form tags so they are set up for e-mailing the data to you. Make sure the first line of the form is set to form_handler_mail like this:

   <form action="/cgi-bin/script_library/form_handler_mail" method="post" />

   Then put the email address of where you want the form output sent in this form tag:

   <input type="hidden" name="email_to" value="username@somewhere.com" />

   replacing the username@somewhere.com with your email address.

   
   
4. Now you have to decide what page will be displayed after the person clicks submit. You probably want to create a new page that says something simple like "Thanks for filling out my form! Now check out these links to other fun stuff on my site!" or something like that. Edit this tag:

   <input type="hidden" name="end_display" VALUE="http://www.YOURLINK.com" />

   to include the URL of the page you want displayed after the visitor submits a form, putting the URL where it says "http://www.YOURLINK.com".

   
   

5. OPTIONAL: You can use a hidden input named "required" to list any inputs that you want to make sure that the user fills out. If a required field doesn't get filled in, the user will get an error telling him or her to try again. In our example form tags the "email" form element is required. You can also use a hidden input named "order" to specify the order in which you want data from the form to be submitted to you. Otherwise, it will be sent to you in a random order within the e-mail. You can also leave these tags off entirely.

   
   
6. That's it! Test out your form now - if you are having the form send you the info as email, it may take a few minutes or a few hours for the email to get to you - that depends on your e-mail provider.