Adding Admin Tools
(Difference between revisions)
Cschoenfeld (Talk | contribs) (explained macro resolution) |
|||
| Line 1: | Line 1: | ||
| + | == 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)* | ||
| + | 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 | ||
| + | |||
== External Links == | == External Links == | ||
[http://www.opencms-forum.de/opencms-forum/viewthread?thread=887 Adding a New Admin Tool] | [http://www.opencms-forum.de/opencms-forum/viewthread?thread=887 Adding a New Admin Tool] | ||
Revision as of 09:55, 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)*
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
