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

Fields You Can Place on Your Feedback Form or Set Using E-Forms.INI
When you create your form, you can set the values of these fields using visible or hidden fields. If you prefer, you can set all of these fields using E-Forms.INI and saving that file in the same directory as e-forms.exe. When the form is submitted, the program will look in the form itself for the values of the fields listed below. If a field is not found, the program will check E-Forms.INI for the default value. If the field is not found there either, the program will assume that the fields is not being used.

Note: You can create as many other fields as you want to on your form for whatever needs you have. If you name the field with _req as the last four letters, it will be considered a required field by the E-Forms EZ. If the value of a required field is blank when the form is submitted, the Info Missing Page will be displayed.

Field Name Required Description
smtp_server Yes Name of the SMTP server which will process your mail such as mailhost.worldnet.att.net. Check your mail software's account or server setup to determine this value or ask your web administrator. This field is almost always hidden or set using E-Forms.INI.
smtp_port No Port number used to connect to the SMTP server. By default this value is set to 25, however if you are running on a proxy server or Intranet, you may need to check with your network administrator for the correct value and set the value accordingly. This field is almost always hidden or set using E-Forms.INI.
mail_to Yes Address to which the message will be sent. You can list multiple recipients by separating them with a space. This field is sometimes visible to the user. If you send a Receipt Message, the receipt will be sent from this address unless you specify a value for receipt_from.
mail_from Maybe Address from which the message will appear to have been sent. If you choose to send a Receipt Message, the Receipt will be sent to this address unless you specify a value for receipt_to. You can require this field by setting the mail_from_required field to a value of yes (or set this option in the Wizard). If you don't require the use to fill out this field, then it will be set to the same as the mail_to field.
mail_from_required No Set this value to Yes if you want the mail_from field to be required. If you set this field to Yes and the mail_from field does not have a value (hidden or filled out by user), the Information Missing page will be triggered and the message will not be sent.
mail_subject No Subject of the message. Use a word or phrase to indicate something about the message. This field is sometimes visible to the used. If this field is omitted, the URL of the form will be used. You can combine other macros to make the subject dynamic. For example, the user could select a product from a drop-down box called "product_name" and a location from a drop-down box called "location". You could then set the value of the hidden field mail_subject read "Inquiry from %location% about %product_name". The result might be "Inquiry from Mesa, AZ about E-Forms EZ".
message_text No Name of the file which contains the message text to be sent. It can be a standard text file or an HTML file. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (message_text="myfile.txt"). If the file is in a directory below the directory where e-forms.exe is stored, use the format message_text="\mydir\mfile.txt". If you know the absolute location of the file, use the format message_text="c:\webfiles\myfile.txt". You cannot use a URL for this file name.

If you know the person receiving the e-mail can view HTML code with his mail reader, you may use an HTML document as your Message Text file. If you want to send an HTML message, the extension for this file must be ".htm". E-Forms EZ checks the file extension to determine whether to send plain text or HTML. If you use any other extension besides ".htm" your message will be sent as plain text.

This field is almost always hidden. If you omit this field or the file cannot be found, the program will create a file using the default file format set in E-Forms.INI. If that value is not set, the message will be sent with each field and its corresponding value listed on one line.

response_page No Name of the HTML file which will be displayed to the user after the message is sent. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (response_page="myfile.htm"). If the file is in a directory below the directory where e-forms.exe is stored, use the format response_page="\mydir\mfile.htm". If you know the absolute location of the file, use the format response_page="c:\webfiles\myfile.htm". You can use a URL (http://www.mydomain.com) for this file name, however, you cannot use any macros if you use a URL. This field is almost always hidden.
mail_cc No Address to which a carbon copy of the message will be sent. You can list multiple recipients by separating them with a space. This field is sometimes visible to the user.
mail_bcc No Address to which a blind carbon copy of the message will be sent. You can list multiple recipients by separating them with a space. This field is sometimes visible to the user. The Carbon Copy list can be seen by other recipients on the list. Blind Carbon Copy recipients cannot be seen by others.
attached_file No Name of a file to attach to the message. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (attached_file="attach.zip"). If the file is in a directory below the directory where e-forms.exe is stored, use the format attached_file="\webfiles\attach.zip". If you know the absolute location of the file, use the format attached_file="c:\webfiles\attach.zip". You cannot use a URL for this file name. This field is almost always hidden. Tip: The Results_File is created before the message is sent. This means you can attach the Results_File to the message.
file No Create a field of type "FILE" to accept an uploaded file from the user. If a file is uploaded by the user, it will be attached to the Primary message sent by E-Forms EZ to mail_to. It might look like <input TYPE="FILE" NAME="file" size=50>.
error_page No Name of HTML file to be displayed to the user if there is an error sending the message. If you don't create an error page, E-Forms EZ will display it's own internal version. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (error_page="error.htm"). If the file is in a directory below the directory where e-forms.exe is stored, use the format error_page="\mydir\error.htm". If you know the absolute location of the file, use the format error_page="c:\webfiles\error.htm". You can use a URL (http://www.mydomain.com) for this file name, however, you cannot use any macros if you use a URL. This field is almost always hidden.
receipt_text No Name of a file to be used for the body of the Receipt Message (a secondary message sent to the user after the message_text message has been sent). If you omit this field, no Receipt Message will be sent. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (receipt_text="receipt.txt"). If the file is in a directory below the directory where e-forms.exe is stored, use the format receipt_text="\mydir\receipt.txt". If you know the absolute location of the file, use the format receipt_text="c:\webfiles\receipt.txt". You cannot use a URL for ths file.

If you know the person receiving the e-mail can view HTML code with his mail reader, you may use an HTML document as your Receipt Text file. If you use this option, the extension for this file must be ".htm". E-Forms EZ checks the file extension to determine whether to send plain text or HTML. If you use any other extension besides ".htm" your message will be sent as plain text.

This field is almost always hidden.

receipt_subject No Subject of the Receipt Message. If you omit this field the word "Receipt" along with the referring URL will be used as the subject. This field is almost always hidden.
receipt_from No Address from which the Receipt Message will appear to have been sent. If you omit this field, the value of the mail_to field will be used. This field is almost always hidden.
receipt_to No Address to which the Receipt Message will be sent. If you omit this field, the mail_from address will be used. This field is usually completed by the user.
info_missing_page No Name of HTML file to be displayed to the user if one of the following fields is blank when the form is submitted: mail_to, smtp_server, or any field you create with _req as the last four characters of the field name.

If you don't create an Info Missing Page, E-Forms EZ will display it's own internal version. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (info_missing_page="missing.htm"). If the file is in a directory below the directory where e-forms.exe is stored, use the format info_missing_page="\mydir\missing.htm". If you know the absolute location of the file, use the format info_missing_page="c:\webfiles\missing.htm". You can use a URL (http://www.mydomain.com) for this file name, however, you cannot use any macros if you use a URL. This field is almost always hidden.

entry_log No Name of a file to use as a log file. Each time E-Forms EZ sends a message and finds a valid value for this field, it will append the current date and time. Use this log to keep track of when the script is executed. You can use a different log file for each page or share log files among different pages. If you want this file located in the same directory as e-forms.exe just use the file name without the drive or directory (entry_log="mylog.txt"). If the file is in a directory below the directory where e-forms.exe is stored, use the format entry_log="\mydir\mylog.txt". If you know the absolute location of the file, use the format entry_log="c:\webfiles\log.txt". This field is almost always hidden.
results_file No Name of a file into which the results of the form will be placed. You can use a different Results File for each page or share files among different pages. If this is file located in the same directory as e-forms.exe just use the file name without the drive or directory (results_file="myresults.txt"). If the file is in a directory below the directory where e-forms.exe is stored, use the format results_file="\mydir\myresults.txt". If you know the absolute location of the file, use the format results_file="c:\webfiles\myresults.txt". This field is almost always hidden.

Automatically Generated Unique File Names: If you set the name of this field to /auto, unique file name will be generated automatically. This will allow you to have a unique results_file for each form submitted.

If this file does not exist on disk, it will be created when the program is executed. If you need to reset this file, simply delete it and let the program create a new one the next time it is executed. This file is updated before the message is sent, which allows you to attach it to the message using the attached_file field.

results_file_template No If you create a results_file, the form results will be inserted using the value of the default_format field. If that field is omitted, then the results will be formatted with one field per line (mail_to:carrprog@azwebpages.com). If you want to customize the format of the results_file, then create a results_file_template. This file is formatted using macros the same way as the message_text file is. The results_file_template overrides the default_format field.

You can use a different Results File Template for each page or share files among different pages. If this is file located in the same directory as e-forms.exe just use the file name without the drive or directory (results_file_template="myresults_template.txt"). If the file is in a directory below the directory where e-forms.exe is stored, use the format results_file_template="\mydir\myresults_template.txt". If you know the absolute location of the file, use the format results_file_template="c:\webfiles\myresults_template.txt". This field is almost always hidden.

delete_results_file No Set this value to "Yes" to set the program to delete the Results File after the message has been sent. By default this value is set to "No".
default_format No If you choose not to create a message_text file, E-Forms EZ will create a message for you. By default it will create a message using one form field per line (mail_to:carrprog@azwebpages.com). If you want the program to use a defaullt Auto-Format, you can specify the type of message using the default_format field and one of the following values:

EZ1ColTextNoLabel: One Column, No Labels, Text Format
EZ1ColTextLabel: One Column with Labels, Text Format
EZ1ColHTMLNoLabel: One Column, No Labels, HTML Format
EZ2ColHTMLNoLabel: Two Columns, No Labels, HTML Format
EZ2ColHTMLLabel: Two Columns with Labels, HTML Format
EZCSV : Comma Separated Value Format

See the E-Forms Wizard for examples of these formats.

use_asterisks No If you set this value to "Yes" then any macro that does not have a corresponding field value will be evaluated to "**". If you set this value to "No" then the macro will be replaced with a blank space. By default this value is set to "Yes".
date_format No Determines how the results of the macro ucgi_date is formatted. Set the default value using the Wizard to use the same format for all of your forms. Examples include:
dd-mmm-yy = 04-Jul-98
mm-dd-yy = 07/04/98
time_format No Determines how the reults of the macro ucgi_time is formatted. Set the default value using the Wizard to use the same format for all of your forms. Examples include:
hh:mm = 11:37
h:m:s = 9:07:23

Note: You may use any file name you want for the Response Page, Message Text, Error Page, Info Missing Page, Attached File, Receipt Text and Entry Log. You can use different names for different forms or share the same files among different forms. This gives you complete control over your site.