Learning

Getting Started

Welcome to the Form Processor Pro, the professional tool for processing of web forms on your web site.

This chapter includes:

• Detailed description of headers used to process email messages if Form Processor Pro 4.1;
• Server variables; short description; how they can be included into template;
• How to organize message with attached files, both user and predefined;
• Accurate tuning of multiple selection fields;
• Most common usage and customizing of Log Templates.

E-mail Headers

Body of Form Processor Pro 4.1 e-mail template may contain arbitrary data in html format or plain text either. This data must be preceded by required key part of template - headers. Headers contain technical information on e-mail message in question and additional message info as well.

Form Processor Pro 4.0 uses following headers:

From	Full name (if stated), E-mail and Company (if stated) of sender
To	Full name (if stated), E-mail and Company (if stated) of recipient(s) **
Cc *	Full name (if stated), E-mail of recipient(s), copy of the message is sent to **
Bcc *	Full name (if stated), E-mail of recipient(s), copy of the message is sent to, but invisible for other recipients **
Subject	Subject of the message (if stated)
Attachment *	File names of files attached to message (if present)

* If you are not intended to use this field, do not include it to template header.
** Multiple recipients are separated by comma "," from each other.

Server Variables

Form Processor Pro 4.1 allows to access server environment variables. They are addressed to as [%SERVER_VARIABLE]. Case is sensitive.

Amount, names and values of server variables can vary upon server platform and software installed. Please consult your hosting support on list and availability of certain variable.

Working with Attaches

Form Processor Pro 4.1 allows you to attach predefined and user-submitted files to e-mail message being sent. Following variables must be set correctly to make this feature work: attachments_path, max_file_size and attachments_ttl.

1. Predefined attachments
First, you need to upload attachment to the server folder defined in attachments_path. To attach this file to the email template you need to append to header information such header line:
Attachment: name_of_file

Example (email template, just header lines):

Will attach test.txt file to the email.
User attachments
To enable user-uploaded attaches you need:

1. your form to be set as multipart-form-data:
   
   <form enctype="multipart/form-data" ..(other parameters). >
2. to include to your form tag of the following kind:
   
   <input type=file name="field_name">
3. e-mail template to contain following header:
   
   Attachment: [field_name_uploaded]

Example:
Form has such tag:

Email template will have such line in headers section:

Now Form Processor Pro 4.1 will attach user file "User-File" to the email template.
To have more attachments you need to separate them in the email template using comma separation.
Example:

Working with Multiple Select Fields

If user submits form with multiple select field, Form Processor Pro 4.1 parses the checked values in one line, separating them with default separator (comma).
However, you can set _multi_separator variable in Local Form Configuration File form.cfg or in the web form (see FPP Configuration / Form Configuration section) to override default separator (comma).

Examples:
in form.cfg:
or in a form page:

Values obtained from multiple select fields now are separated by colon when being processed.

Setting up Log Templates

Flexibility of templates customization in Form Processor Pro 4.1 finds its reflection in log templates with free format for logging data.
Most often this feature is used to produce CSV (Comma Separated Values) formatted file. That is because this format is easily understood by Microsoft Excel.
CSV file is plain text file with values separated from each other with commas (,) or semicolon (;).
Actually, CSV-style doesn't care about separator sign, the above used for compatibility with MS Excel.