Difference between revisions of "Role extensions"
(→Documentation) (Tag: visualeditor) |
(→Documentation) (Tag: visualeditor) |
||
| Line 11: | Line 11: | ||
When the role extension is called with zero parameters, it should return some documentation for itself. | When the role extension is called with zero parameters, it should return some documentation for itself. | ||
| − | The documentation consists of a [[RoleExtensionDocumentation]] class instance | + | The documentation consists of a [[RoleExtensionDocumentation]] class instance. |
| − | + | Depending of the role extension works on users or roles, the actual value returned may be a [[RoleExtensionUserDocumentation]], or a [[RoleExtensionRoleDocumentation]]. It is also possible to return a [[RoleExtensionEventDocumentation]] for those extensions that are event on changes to membership of a role, these are called automatically so documentation makes little sense. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Inheritance == | == Inheritance == | ||
| Line 29: | Line 21: | ||
== Discovery of role extensions == | == Discovery of role extensions == | ||
Role extensions are discovered in the following order: | Role extensions are discovered in the following order: | ||
| − | # Workflow | + | # Workflow scripts may be defined in folders named "Role exts" anywhere in the system. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
# If the current user does not have read access to the role extension itself, then the extension is ignored. | # If the current user does not have read access to the role extension itself, then the extension is ignored. | ||
| − | # If | + | # If the documentation has LimitToPath, then that is examined to filter out if not applicable to current role. |
[[Category:Roles]] | [[Category:Roles]] | ||
Revision as of 11:19, 18 December 2019
Role extensions are extensions points for a role.
Contents
Parameters
The parameter given is either an instance of the RoleExtensionParameter class or zero parameters.
If called with zero parameters, the script should return documentation for itself.
If the script is called with other parameters, then the script is not called via the Role framework, which can be useful if scripts can be utilized for other functions.
Documentation
When the role extension is called with zero parameters, it should return some documentation for itself.
The documentation consists of a RoleExtensionDocumentation class instance.
Depending of the role extension works on users or roles, the actual value returned may be a RoleExtensionUserDocumentation, or a RoleExtensionRoleDocumentation. It is also possible to return a RoleExtensionEventDocumentation for those extensions that are event on changes to membership of a role, these are called automatically so documentation makes little sense.
Inheritance
Helper functions/classes
Discovery of role extensions
Role extensions are discovered in the following order:
- Workflow scripts may be defined in folders named "Role exts" anywhere in the system.
- If the current user does not have read access to the role extension itself, then the extension is ignored.
- If the documentation has LimitToPath, then that is examined to filter out if not applicable to current role.
