Limit
Impose or modify various limits.
Synopsis
You can set multiple names and values at once
by using the Perl-style "here document" syntax,
as follows:
Limit <<EOE
name1 value1
name2 value2
EOE
|
Scope
This directive is only available for use in the local
(catalog.cfg) configuration file.
It will not affect any other website in any way.
This directive will not work in the global
(interchange.cfg) configuration file.
Description
This directive allows you to impose or modify any of the following limits,
thus modifying Interchange's response to certain situations.
The following limits are available for you to override as you see fit:
| Name
|
Description
|
Default
|
Versions
|
| cart_quantity_per_line
|
Maximum quantity associated with every individual row in the cart. |
Unlimited |
All
|
| chained_cost_levels
|
Maximum number of atoms in a CommonAdjust chained pricing setup. |
32
|
All
|
| dbm_open_retries
|
Maximum number of attempts to open a DBM file before failing. |
10
|
All
|
| file_lock_retries
|
Maximum number of file lock attempts to make before failing. |
5
|
All
|
| include_depth
|
The maximum number of nested inclusions |
10
|
All
|
| ip_session_expire
|
If the total number of unique sessions reaches the
RobotLimit during this interval
(specified in minutes) then a lockout will be triggered. |
60
|
5.5.0+
|
| list_text_overflow
|
If set to "abort" and a looping tag's current row size is greater than the "list_text_size" limit then loop processing will stop at that point. |
Unlimited |
All
|
| list_text_size
|
Maximum row size, used along with the "list_text_overflow" setting (see above). |
Unlimited |
All
|
| lockout_reset_seconds
|
Pause time required in order to reset the RobotLimit page counter. |
30
|
All
|
| logdata_error_length
|
Truncate text sent to the Interchange core's logData() subroutine if it exceeds the configured limit. |
Unlimited |
All
|
| no_ship_message
|
Boolean.
If true then Interchange won't set the [data session ship_message] (error message) that would normally be shown with the shipping method section list when a problem is found. |
False |
All
|
| option_list
|
Maximum number of loop iterations that can be generated by the [loop] tag's "ranges" parameter. |
5000
|
All
|
| robot_expire
|
Lock an IP address for this many days if the RobotLimit
page count is breached over the interval specified by the
ip_session_expire limit, listed above. |
1
|
All
|
| session_id_length
|
Length of the session IDs generated by Interchange. |
8
|
All
|
|
Availability
"All versions" refers to Interchange 5.0.0 and above,
as 5.0.0 is the baseline for the documentation on
this website.
Most of the limits marked "All" were available long before
version 5.0.0 was released.
|
Example
Limit <<EOL
lockout_reset_seconds 20
robot_expire 0.04
EOL
|
