Acknowledging the Visitor

Phorm™ v3.5.2

Acknowledging the Visitor:

The other most-commonly-desired action is to display a page to the visitor, acknowledging and possibly confirming their entry.

Acknowleding with $PHORM_ACK

There are two ways you can accomplish this; the first is to set $PHORM_ACK to the name of an acknowledgement page created in standard HTML. You can include data from the form in this file by enclosing the field names in double curly braces, as described in the Using Phorm section. For an example, see the file ack.html in the examples/warble/templates or examples/widget/templates folder in the distribution.

Re-directing to an Ack Page

If $PHORM_ACK is not set, Phorm will check the variable $PHORM_RDIRECT; if it has been set Phorm will re-direct to it. Note that Phorm simply re-directs to the specified URL -- it does not parse the page at that location for variable substitutions.

If neither $PHORM_ACK nor $PHORM_RDIRECT is set, Phorm will check $PHORM_POSTINC, on the assumption that an acknowledgement or redirect will be done in post-processing. If none of these variables is set, Phorm will use the generic ack template.

PHP Code

If you know PHP, you can include PHP code in your acknowledgement template, and it will be executed. Simply give your template a PHP extension (.php, .php3 or .php4) and set the variable $PHORM_PARSPHP to true. For security reasons, variable substitution is performed after the file is passed to the PHP parser. There are a number of Phorm variables and functions available to you. For more details, see the plugin programming documentation.

0101000001101000011011110111001001101101010010010111001101000011011011110110111101101100