Contact Site map Home

Technical Support
(Historical information only. We hope you find it to be a beneficial resource)

Using Cgiemail

Basics
Sending a Thank You Page
Secure Server

To modify an existing HTML form to work with the script cgiemail you will need to use the following form action within your HTML code:

<form method="post" action="/cgi-bin/cgiemail/mailform.txt">

Please Note: If you are a FrontPage user with the FrontPage 98 extensions installed on your site, you will use this path instead:

<form method="post" action="/cgibin/cgiemail/mailform.txt">

(The difference is that you are using "cgibin" instead of "cgi-bin".)

This code calls the preinstalled script cgiemail which is in the server's cgi-bin directory once the web page visitor clicks the "submit" button. The script cgiemail in turn calls a text file (or template) called mailform.txt. The template defines the format by which the submitted form content is to be sent via email.

You can create the template in a basic text editor (such as MS Notepad) beginning with the following two lines:

   To: username@yourdomain.com
   Subject: Information Request

Substitute the desired recipient email address and subject above. If your form asks for the email address of the visitor (be sure to name this field: email), add this as the second line of the template:

From: [email]

There can be no blank lines at the top of the file and no blank spaces at the beginning of these header lines.

Next, you will need to add ALL field names within the HTML form to the template in a form similar to the following:

   To: username@yourdomain.com
   From: [email]
   Subject: Information Request

   Name            [name]
   Address         [address]
   Phone           [telno]

As long as each form field name is contained within brackets ("[ ]") within the template, the email should be sent successfully and contain all submitted data. We suggest using all lowercase field names within your HTML form and template.

If you want a specific web page to load when the email is successfully sent, such as a thank you note, add the following code to your HTML form:

  • <input type="hidden" name="success" value="http://your_domain.com/thanks.html">

Substitute the URL of the file you wish to load after form data is submitted. The field name in this case MUST be "success", but does not need to be added to the template.

  • For FrontPage users the path will be same:

<form method="post" action="/cgi-bin/cgiemail/mailform.txt">

<form method="post" action="https://wwwXXXX.xynext.com/cgi-bin/cgiemail/<yourdomain>/mailform.txt">
<form method="post" action="https://wwwXXXX.securedweb.net/cgi-bin/cgiemail/<yourdomain>/mailform.txt">

where XXXX should be substituted with the number of your server.

  • For Secured Server with FrontPage the path would be:

<form method="post" action="https://wwwXXXX.xynext.com/cgi-bin/cgiemail/<yourdomain>/FrontPage/mailform.txt">
<form method="post" action="https://wwwXXXX.securedweb.net/cgi-bin/cgiemail/<yourdomain>/wwwfp/mailform.txt">

where XXXX should be substituted with the number of your server. Be sure to check our SSL page for the correct secure server name above.

IMPORTANT THINGS TO REMEMBER:

  • There are only two parts to your email forms, the Form itself & the .txt template. The CGIEMAIL program resides in our root system for you to use.
  • The .txt file can be named anything.txt and placed anywhere in your site as long as the path reflects its location (see below).

<form method="post" action="/cgi-bin/cgiemail/mailform.txt"> the mailform.txt file is in your root directory

<form method="post" action="/cgi-bin/cgiemail/forms/mailform.txt"> the mailform.txt file is in directory called forms

  • When using secure server, make sure you are using the proper server number (i.e. www, www2, etc).
  • Secure forms should have   a)   The link to the form secure:
                          
                    <a href="https://www#.securedweb.net/yourdirectory/order.htm">Secure Order Form</a>

    b)   The link to the cgiemail program secure:

        <form method="post" action="https://www#.securedweb.net/cgi-bin/cgiemail/yourdirectory/mailform.txt">

    and   c)  The link to the thank you page secure:

         <input type="hidden" name="success" value="https://www#.securedweb.net/yourdirectory/thanks.html">

Try our test email form.

See the source of the testform.txt template.

 
 
[ Home ]   [ About ]   [ Plans ]   [ Designs ]   [ Graphics ]   [ Marketing ]   [ Hosting ]   [ Portfolio ]   [ Contact ]   [ Site Map ]
Copyright © 1995-2000 XyNexT Internet Strategies - All Rights Reserved Worldwide