|
All the operations that you want to occur on this iteration are
given in hidden form values. I.e.
<input type="hidden" name="_send_email"
value="email.txt">.
Operations are done in the order specified in the HTML. For this
reason, it is recommended that you specify the browser output last.
All operations are optional except config file variable. Operations
are denoted with a leading underscore. They are:
Personal
config file:
_cfg_file - is used to set the file name and path to the
config file for current form. This should not to be a URL, but a
real file path; either absolute or relative to the script. This
is only variable that uses filename with path. Other variables use
filenames only. This is required variable.
Example:
<input type="hidden" name="_cfg _file" value="../www/templates/simple.cfg">
Send
eMail:
_send_email - this sends email using the template in this
tag's value. Script will send emails using templates defined in
this variable.
Example:
<input type="hidden" name="_send _email"
value="simple-email.txt">
Will use simple-email.txt as template for email.
Output
to a file:
_out_file - this logs to a file using the template given
in the value. Using this you will be able to create log files, textual
DB files and CVS files or any other file with free format.
Example:
<input type="hidden" name="_out_file " value="simple-logfile.txt">
Will use simple-logfile.txt as template for logging [storing].
Browser
out:
_browser_out - this displays the value's template in the
browser. That can contain processed data. Also used for multiple
pages form creation.
Example:
<input type="hidden" name="_browser_out "
value="simple-preview.html">
Will display simple-preview.html after form submission. That can
contain processed data.
Redirect
URL:
_redirect - this redirects the browser to the URL given
here.
Example:
<input type="hidden" name="_redirect " value="http://www.site.com/page.html">
After from processing script will redirect user browser to the specified
URL.
Error
processing:
_error_path - if an error occurs, this template is displayed
by the browser. In addition all processing messages [such as required
fields must be filled etc.] will arrive using this template.
Example:
<input type="hidden" name="_error_path" value="simple-error.html">
_error_url - if an error occurs, the browser is redirected
to this URL.
Example:
<input type="hidden" name="_error_url" value="http://www.site.com/errorpage.html">
You can have more than one _send_email or _out_file, if you want
more than one email sent or file appended to. In this case, you
must specify a unique number or letter after each one- i.e. _send_email_1,
_send_email_2, out_file_a, _out_file_b, _out_file_c. It really doesn't
matter what you put after them, just as long as each operation is
unique.
Round:
_round - store default precision for round function in arithmetic
calculations - if set to "2", the default value of the
round function will be rounded to two decimal points. See more info
in the templates configuration - mathematical calculations
Example:
<input type="hidden" name="_round " value="2">
Make sure the name of each field corresponds exactly to what you
want it to replace in the templates.
Unique
reference number:
Using unique_reference_number in the form script will generate
unique reference number for every form submission. Use [unique_reference_number]
as variable in all templates to output its value.
Example:
<input type="hidden" name="unique_reference_number">
Date
and Time variable:
GMT_OFFSET - using this variable you will be able to adjust
[%DATE_GMT] for your purposes.
Example:
<input type="hidden" name="GMT_OFFSET" value="+5">
Will increment [%DATE_GMT] variable with 5 hours.
Required
value for Radiobuttons, checkboxes and select:
Some form elements do not give to program any information if user
did not use them. For exapmple checkbox:
<input type="checkbox" name="rm_fashion"
value="classic">
If user will not check this checkbox then program will not have
any data and it will be not recognized as required. To solve this
problem you need to add additional:
<input type="hidden" name="rm_fashion" value="default">
If user will not check ckeckbox then program will receive data
and will be able to recognize that user did not check ckeckbox.
Example:
<input type="hidden" name="rm_fashion" value="default">
<input type="checkbox" name="rm_fashion"
value="classic">
Checkbox will be processed as required
Multi
Separator:
_multi_separator - used with "m" switch value,
specifies which character(s) to use to separate multiple values.
Default is ",".
Example:
<input type="hidden" name="_multi_separator"
value="-">
Will separate multiple values with "-".
|