restrict
Restrict ICML tag execution in a region.
If a restricted ICML (not HTML) tag is encountered,
it will be returned verbatim.
Summary
| Parameter
|
Description
|
Default
|
| enable |
Path to Interchange page or action. |
None |
| disable |
Interchange argument to page or action
|
None |
| policy |
Encode CGI form parameters into the link URI. |
deny |
| interpolate |
Parse Interchange tags, included in the body text, before this container tag executes. |
No
|
Examples
Tag expansion example
[restrict enable="calc"]
This is a restricted block.
calc = [calc] return 'Enabled'; [/calc]
calcn = [calcn] return 'Enabled'; [/calcn]
[/restrict]
|
This is a restricted block.
calc = Enabled
calcn = [calcn] return 'Enabled'; [/calcn]
|
|
Note
This tag is not available for use with embedded Perl due to the special
processing required within Interchange's ICML tag parser.
|
Description
This tag is used to restrict the ICML tags that are allowed to execute
the region defined by the [restrict] tag's body text.
If a restricted tag is encountered,
it will be output verbatim.
This can be used to allow certain tags,
perhaps in a user-editable region,
while denying more dangerous tags as you see fit.
Of course it can be used to restrict all ICML tag execution in the region.
Parameters
enable
A space or comma-separated list of ICML tags to enable when the
policy is set to "deny" (the default).
This parameter has no effect when the policy is set to
"allow",
and any tags given in the "disable" parameter will
override the tag names specified here.
disable
A space or comma-separated list of ICML tags to disable when the
policy is set to "allow".
If you enabled a list of tags,
perhaps stored in a scratchpad variable,
you can disable some of those tags here,
as this parameter takes precedence over the enable.
policy
The default policy is "deny",
which allows you to specifically enable certain ICML tags,
while leaving all of the rest disabled.
You can set the policy to "allow",
but you must be very careful to ensure that you really are disabling
all of the tags that you consider to be dangerous.
