Adding Admin Tools
(Difference between revisions)
Cschoenfeld (Talk | contribs) m (→Explanation of the MacroPrefix values) |
Cschoenfeld (Talk | contribs) m (→Admin Tool parameters) |
||
| Line 2: | Line 2: | ||
Tools can be given parameters which are automatically appended to the generated tool buttons. Parameters are set using the property ''admintoolhandler-args'' and may have the following syntax. | Tools can be given parameters which are automatically appended to the generated tool buttons. Parameters are set using the property ''admintoolhandler-args'' and may have the following syntax. | ||
| − | Syntax: "params:" ParamDef ("&" ParamDef)* | + | Syntax: "params:" ParamDef ("&" ParamDef)* "|" "path:" Path |
| + | Path: VFS or other path | ||
ParamDef: Identifier "=" (MacroDef|Value) | ParamDef: Identifier "=" (MacroDef|Value) | ||
Identifier: String value | Identifier: String value | ||
Revision as of 09:57, 20 February 2007
Admin Tool parameters
Tools can be given parameters which are automatically appended to the generated tool buttons. Parameters are set using the property admintoolhandler-args and may have the following syntax.
Syntax: "params:" ParamDef ("&" ParamDef)* "|" "path:" Path
Path: VFS or other path
ParamDef: Identifier "=" (MacroDef|Value)
Identifier: String value
Value: String value
MacroDef: "${" (FixedMacro | (MacroPrefix "." MacroName)) "}"
MacroPrefix: "key" | "param" | "pageContext"
| "property" | "elementProperty"
MacroName: String value
FixedMacro: "currentuser.name" | "currentuser.firstname" | "currentuser.lastname"
| "currentuser.fullname" | "currentuser.email" | "currentuser.street"
| "currentuser.zip" | "currentuser.city" | "currentuser.country"
| "request.uri" | "request.folder" | "request.encoding" | "request.locale"
| "currenttime"
| "opencms.uri" | "opencms.filename" | "opencms.folder" | "opencms.default.encoding"
Explanation of the MacroPrefix values
key is a message bundle key.
param is a HTTP request parameter
pageContext is a JSP page context attribute
property is a VFS property of the requested tool's CMS resource
elementProperty a VFS property of the currently requested element which might be an included resource, not necessarily the resource requested by the user
