This page documents the MULTIFORMDIR configuration setting in FormMail.
Type Of Setting
MULTIFORMDIR is an OPTIONAL setting, which means...
OPTIONAL : you can change this setting if you need to, but the default value is fine for most circumstances.
Précis
Sets the directory/folder for multi-page form templates.
Description
Set MULTIFORMDIR to the directory/folder on your server where multi-page form template files are stored.
If you want to specify "next_form" in your forms (that is, you want to use multi-page forms), the templates must be found in the directory/folder you specify in this setting (or the alternate setting MULTIFORMURL).
This is a necessary step to prevent security problems. For example, without this measure, an attacker might be able to gain access to any file on your server.
We recommend you set aside a particular directory on your server for all your multi-page form templates.
NOTE: on Windows servers, use '/' instead of '\' or double the '\', like this:
"d:\\path\\to\\multiforms"
or
"d:/path/to/multiforms"
Note that the actual template file path name is created by appending a '/' and the file name you provide in the form (with next_form) to the MULTIFORMDIR setting. But, for security reasons, any path components preceding the file name are stripped. For example, with
<input type="hidden" name="next_form" value="path/to/page2.htm" />
the next_form value is stripped down to:
page2.htm
before being appended to MULTIFORMDIR.
Default Value
$MULTIFORMDIR = "";
Examples
$MULTIFORMDIR = "/home/mysite/public_html/multiforms";