HOWTO Forms
===========

Included in the basic Plexus package is a form processor that will email
the form to the email address you specify and it also has a test mode.

First, configure the forms processing code in your local.conf file, e.g.:
    load   forms.pl
    map form-admin forms.pl &forms'emailto($top, $rest, $query,
                                $main'plexus{'admin'}, "Feedback")
    map form-test  forms.pl &forms'emailto($top, $rest, $query,
                                undef, "Generic Test Form")

Then in your .html file specify the path in the ACTION field.  You can
optionally include information about which fields are required and which
must be numeric.  To do this just put the name of the field, an equal
sign, and then the type information ("r" for required, "n" for numeric).
If the field requirements are not met then a client error will be returned
to the user listing which fields failed to match and for what reasons and
the form will not be sent.

For example:
    <FORM ACTION="/form-admin/name=r/phone=n/rn=rn">
    <INPUT TYPE="submit" VALUE="Submit Form"> <P>
    <INPUT NAME="name" SIZE="30"> Name (required) <BR>
    <INPUT NAME="phone" SIZE="30"> Phone Number (optional numeric) <BR>
    <INPUT NAME="PIN" SIZE="30"> PIN (required numeric) <BR>
    </FORM>
