E-Forms EZ
1998 by James Carr
http://www.azwebpages.com/e-forms

Feedback Form
This is an ordinary HTML document with a form on it. The user will fill out this form and click the Submit button. E-Forms EZ will read the values of all of the input fields on this form (hidden and visible), send an e-mail message (using message_text) and display an HTML page (response_page) to the user. If you set a value for the receipt_text field, the program will also send a confirmation receipt to the user.

The form definition must have "e-forms.exe" as the action. Usually this file is stored in your CGI-BIN directory. If so, the setting would be: action = "/cgi-bin/e-forms.exe". You need to find out the directory on your web server from where scripts can be run. The Method for the form must be "Post". And don't forget to put a Submit button on the form!

Setting Field Values
Values for the fields used by e-forms.exe can be set one of three ways. First, you can create a field on the form that the user completes. The value from this field can be used by the program. Second, you can add a hidden field to your form with the value for that field already set. Third, you can set a default value in e-forms.ini and place that file in the same directory as e-forms.exe on your web server.

Required Fields
The following four fields must have a value in order for the program to work. You can set them using any of the above three methods. While there are many other fields used by the program, these four are the only ones required for operation.

smtp_server
smtp_port
mail_to
You can also add any of the other optional fields as described in the List of Fields.

Other Input Fields
In additon to the required fields and optional fields you can add as many other fields as you need to make your form useful to you. The only two requirements are that the field names cannot contain spaces or the percent (%) symbol. All the fields on your form can then be used as macros in your Message Text, Response Page, Error Page, Results File Template and Receipt Text files.

E-Forms EZ Wizard
E-Forms EZ comes with a program to assist you in creating the required and optional hidden fields as well as setting defaults. Use this program to help you create all the fields you need without the risk of typing errors!

Start the Wizard and select the option you want. Click the Next button and follow the instructions you see on the Wizard.

Creating Hidden Fields
If you are using the Wizard to create the hidden fields, you must copy the text to your HTML editor. Here's how: When you reach the last screen in the Wizard click the Copy button. Next, switch to your favorite HTML editor. If your program uses a graphical view of the HTML screen, switch to the standard HTML source view (text mode). Find the section where your form begins (<form action="/cgi-bin/e-forms.exe">). Insert your cursor after this tag and before the </form> tag like this:

<form action="/cgi-bin/e-forms.exe">
{your cursor here}
</form>

Select Edit, Paste (ctrl-v is the keyboard shortcut). The HTML code for the hidden fields will be automatically inserted where your cursor is. Save your file so that your HTML editor is sure to read the new HTML code.

Accepting Uploaded Files
You can accept an uploaded from the user if that user's browser permits uploading. Netscape 2.0 and higher permits this option. Explorer can support this option with the use of an ActiveX control. You only need to make two modifications to your form to accept uploads. First, change the action of your form to include the ENCTYPE setting.

	<form ENCTYPE="multipart/form-data" action="/cgi-bin/e-forms.exe">

You must also create a field named file of type FILE to accept the name of the upload.

	<input TYPE="FILE" NAME="file">

When the form is submitted, E-Forms EZ will automatically check to see if a file was uploaded. If there is one, it will automatically attach it to the Primary Message. The EZ-Demo.htm sample file includes this setup.