Every feature of this utility can be customized to your liking through "hidden" tags that you can include in your HTML form between the
tags. The following list contains each of the property names and an example of their usage.
NAME=cgiemail_html tells the script which should be the next html page shown after the form is submitted. If a relative URL is used, (i.e. VALUE="/done.html", instead of VALUE="www.someplace.com/done.html"), then replacements may be used on the next page to fill in what your visitor typed on the previous page. This value should appear only once in a form. Here are a few examples of this property's usage:
or ...
NAME=cgiemail_invalid sets the error message that your visitor will be shown if an invalid e-mail addresses is entered (i.e., VALUE="You entered an invalid Email address"). This property should appear only once in each of your forms if you want to use it. Here are a few example:
or ...
NAME=cgiemail_required requires the visitor to enter information in any field(s) you specify. A customized message can be used for each missing field. (Note: Do not use the ";" character in the messages. This is a reserved character and it will cause your form not to work.) This property can be set for any field you want and therefore can appear as many times as you have control names in a form. Here are some examples:
(Note: In the second and third examples above, these "hidden" controls imply that you have another control for each of these names in your form. To extend the example, you must have two other controls between the tags in your HTML form which are similar to "" and "". The second and third examples above simply tell the Form E-mailer to check each of those controls to make sure they have not been left blank. They do not actually create the controls.)
NAME=cgiemail_message is the message file, including the headers and body of the e-mail. Replacements may be used, but they must be a relative URL (i.e., VALUE="message.txt"). This input may be used multiple times to send multiple e-mail messages. If this file begins with ">/path/db.txt", then the contents of the rest of this file will be appended to /path/db.txt. Multiple tags can also be used. Here are some examples:
NAME=delim_(name) overrides the default delimitor (",") on multi-valued inputs associated with name (i.e., VALUE="\n"). For examples,
NAME=cgiemail_timezone overrides the default timezone (GMT) for the message (i.e., VALUE="MST" or VALUE="US/Mountain"). For examples,
NAME=cgiemail_order (This field is ignored if "cgiemail_message" is used.) This field sets the order for displaying fields (i.e., VALUE="name1:name2:name3"), as in the following example:
NAME=cgiemail_subject (This field is ignored if "cgiemail_message" is used.) This field is the "Subject:" for the e-mail. (i.e., VALUE="WEB FEEDBACK"). For example,
NAME=cgiemail_username (This field is ignored if "cgiemail_message" is used.) This field is the "To:" for the e-mail. (i.e., VALUE="webmaster"). For example,
NAME=email must be a valid, formatted e-mail address. (This field is ignored if "cgiemail_message" is used.) This field is the "From:" for the e-mail. EXAMPLE HTML CODE: Enter your email: Examples VALUES for cgiemail_timeformat field:
NAME=cgiemail_timeformat overrides the default (EPOCH seconds) time format used to assign the special variable. This field is only used to customize the and has no other purpose. (You can include the variable on any page returned by the CGI and the time will be printed in its place). VALUE="%a %b %e %T %Z %Y" would appear: Fri Dec 23 10:10:42 EST 1988, VALUE="%A, %B %e, %Y %T" would appear: Friday, December 23, 1998 10:10:42, VALUE="DATE: %m/%d/%y%nTIME: %H:%M:%S" would appear: DATE: 12/23/98 TIME: 10:10:42 Output can be customized by using the following codes:
%% = a literal %
%n = a newline
%t = a horizontal tab
%H = hour (00..23)
%I = hour (01..12)
%k = hour ( 0..23)
%l = hour ( 1..12)
%M = minute (00..59)
%p = locale's AM or PM
%r = time, 12-hour (hh:mm:ss [AP]M)
%s = seconds since 1970-01-01 00:00:00 UTC (a nonstandard extension)
%S = second (00..61)
%T = time, 24-hour (hh:mm:ss)
%X = locale's time representation (%H:%M:%S)
%Z = time zone (i.e., EDT), or nothing if no time zone is determinable
%a = locale's abbreviated weekday name (Sun..Sat)
%A = locale's full weekday name, variable length (Sunday..Saturday)
%b = locale's abbreviated month name (Jan..Dec)
%B = locale's full month name, variable length (January..December)
%c = locale's date and time (Sat Nov 04 12:02:33 EST 1989)
%d = day of month (01..31)
%D = date (mm/dd/yy)
%h = same as %b
%j = day of year (001..366)
%m = month (01..12)
%U = week number of year with Sunday as first day of week (00..53)
%w = day of week (0..6) with 0 corresponding to Sunday
%W = week number of year with Monday as first day of week (00..53)
%x = locale's date representation (mm/dd/yy)
%y = last two digits of year (00..99)
%Y = year (1970...)
Example:
email@emailaddress.com
