MULTIFORMURL Setting

MULTIFORMDIR Index TEXT_SUBS

This page documents the MULTIFORMURL configuration setting in FormMail.

Type Of Setting

MULTIFORMURL 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 URL for multi-page form templates.

Description

Set MULTIFORMURL to the URL where multi-page form template files can be fetched. If you set MULTIFORMDIR too, that takes precedence and MULTIFORMURL is ignored.

MULTIFORMURL is analogous to MULTIFORMDIR, but allows for templates to be read from a web server. This is useful for cases where you want the template to be generated via a PHP script, for example.

You can use $SCHEME and $SERVER to refer to your own server. However, this relies on your server providing PHP with the correct information. If you have problems with these features, use an explicit literal URL.

Note that the HTTP_USER_AGENT string is passed to any URL opened through MULTIFORMURL with a parameter, for example:

http://yoursite.com/multiforms/page2.php?USER_AGENT=Mozilla

This is useful for dynamically generated pages which generate different content depending on the user's browser.

Note that the actual template URL is created by appending a '/' and the file name you provide in the form (with next_form) to the MULTIFORMURL 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 good_template value is stripped down to:

page2.htm

before being appended to MULTIFORMURL.

Default Value

$MULTIFORMURL = "";

Examples

$MULTIFORMURL = "http://www.mysite.com/multiforms";

$MULTIFORMURL = $SCHEME.$SERVER."/multiforms";