This page documents the SESSION_ACCESS configuration setting in FormMail.
Type Of Setting
SESSION_ACCESS 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
Allows access to PHP session variables.
Description
If your website uses a PHP session to hold information, you can access this information in your forms processing.
The SESSION_ACCESS configuration setting allows you to control which data items your forms can view and/or alter.
For example, suppose your website allowed people to login to identify themselves. Your forms processing could access this information and automatically include it in the email it sends you.
Another example using this feature: your Tectite FormMail form could perform a login process and provide the logged-in user name and details for the rest of your website.
When using multi-page forms, SESSION_ACCESS allows you to create persistent fields (persistent for the session) that can be accessed or altered on any page of your multi-page form.
For example, if you have 3 page form, you could save a submitted field on page 2 to the PHP session and use that field value if the user goes back to page 1.
This overcomes the normal restriction in multi-page processing: a page can only use a field that was submitted on previous pages in the sequence (i.e. page 3 can use page 1 and page 2 fields, but page 2 cannot use page 3 fields).
SESSION_ACCESS controls which fields can be accessed in the PHP session. The process is automatic - once a field is specified it will be created or updated whenever a form is submitted with that field name.
SESSION_ACCESS was introduced in version 8.11.
Default Value
$SESSION_ACCESS = array();
Examples
$SESSION_ACCESS = array("username","firstname","lastname");