Support Forum
System CGI
form.cgi


form.cgi (version 1.0, deprecated)
Modifications Required: none
Optional Modifications: None recommended.

form.cgi is a custom script at pair Networks, designed as a very simple way to deliver form contents through e-mail. It will only send e-mail to local addresses (ending in @pair.com). For a more advanced form mailer, try FormMail.pl or cgiemail. form.cgi exists on our servers only for historical reasons.

To use form.cgi with a form, three hidden fields are required, and you must use the POST method. For example:

<FORM METHOD="POST" ACTION="/cgi-sys/form.cgi">

<INPUT TYPE="hidden" NAME="TO" VALUE="username">
<INPUT TYPE="hidden" NAME="OK" VALUE="new-URL">
<INPUT TYPE="hidden" NAME="KW" VALUE="Keywords">

...where username is the local user who should receive the form contents, new-URL is the absolute URL to which the visitor should be sent after a successful form delivery, and Keywords is any phrase that should appear in the Subject: field of the mail being delivered.

The body of the e-mail sent will contain all defined fields in the form, listed in sorted order. For example:

01_NAME:: John Doe
02_COMPANY:: Doe Enterprises
03_ADDRESS:: 45 Somewhere St

To receive the fields in a preferred order, we recommend the use of a naming scheme with numeric prefixes, as shown above.

If new-URL is missing, a generic "Success" message will be shown to the visitor. The Keywords field is also optional.

Please note that the username is always relative to @pair.com, so you will want to use your account login name. Also, the names of the hidden fields must be exactly correct, and in uppercase.

Remember, for more advanced functionality, try FormMail.pl or cgiemail.