BlueSpicePermissionManager

- Error

The provided source article ("Buch:Administration manual") does not exist.

PermissionManager is for managing rights or permissions at a group and namespace level. User permissions are defined via the groups in which the users are placed.

Technical background

In order to hide the syntax of permission management in Mediawiki and the Lockdown extension, a dialogue is created in which the permissions can be set and easily viewed. A special form of group permissions is permission templates (rolls). GroupManager, NamespaceManager and Permissions-TemplatesManager are special extensions or dialogues.

Where can I find the function PermissionManager?

Firstly, you will need admin rights in order to call up the permission manager. If you have the right permissions, you will find "Permission manager" in the left navigation bar under "Admin". Click on the link and you will be taken to the administration page.

Sceenshot: Open the permission manager in the admin area

The functionality of PermissionManager

Choose one of the three work modes in the drop-down menu:

Group: An array is displayed for a chosen user group showing the namespaces and the permissions attached.
Namespace: An array is displayed for a chosen namespace showing the user groups and the permissions attached.
Permission: An array is displayed for a chosen permission showing the user groups and the namespaces.

PERMISSION MANAGER EXPLAINED

Permission manager is used to grant or revoke permissions. On the left side there is Groups menu that can be shown by clicking on the arrow at the top. It shows permission groups hierarchy. The asterisk (*) group includes all users that enter wiki, regardless of whether they are logged in or not. The "user" group applies to all logged in users. This groups holds different sub-groups, some of which are default to MediaWiki while others may be custom. Clicking on the group name shows (in the list to the right) all permissions granted to the group. You can add permissions by checking appropriate check box.

Assigning permissions Permissions can be granted for entire wiki (by checking "Wiki" checkbox) or only for selected namespaces. Assigning permissions follows an inheritance model. If you add permission to (*) group it will also be assigned to "user" and all sub-groups of "user". It will show like green unchecked field. When a permission is not explicitly granted to a group but its inherited from a parent group, field will appear as green and not checked

When explicitly adding permission to one groups (for entire wiki or just for one namespace) all other groups in the same hierarchy level will lose this permission.

Templates You can create templates for permissions. Templates represent collection of permissions to make permission management more straight-forward. Templates are added/edited in Template editor (click on "Edit templates" buttom at the bottom). Enter name for template, description and select permissions that will be managed by this template. When template is added it will appear at the top of the permission lists and assigning it to a group will grant all permissions defined in the template, and at the same time revoke these permissions from other groups in the same hierarchy level.

Assign the permissions as you want in the table. The permissions are colour coded. The explatation for the coding can be found in "Good to know". You can also work with permission-templates, also called roles. Such roles contain a collection of permissions.

Screenshot: Settings in the PermissionManager

Good to know:

Assigning permissions to groups and namespaces can be done either by choosing a permission-template (role) or by choosing individual permissions.
Permission-templates are defined by using unique (descriptive) names.
A permission-template is a freely definable collection of permissions.
Management of permission-templates is a component of the PermissionManager (with its own dialogue).

The first step to set permissions is to set them in the first folder - for the whole wiki (*).
The permissions you set for a group, will be set automatically for the following folders, for the wiki and all namespaces (green coloured - not checked).
If you want to give the groups more/different permissions - maybe in different namespaces - you can select them manually, but if you do that, the other groups, in the same hierarchy level, lose that permission for the namespace you choosen.
Colour coding:
- no colour " border="0"

|- ! style="border: 1px solid #ebecec; width: 20%;"| User permissions

! style="border: 1px solid #ebecec;"| Definition

! style="border: 1px solid #ebecec;"| User group

|- | style="border: 1px solid #ebecec;"| read

| style="border: 1px solid #ebecec;"| lets the user view pages

| style="border: 1px solid #ebecec;"| user

|- | style="border: 1px solid #ebecec;"| edit

| style="border: 1px solid #ebecec;"| allows the user to edit unprotected pages

| style="border: 1px solid #ebecec;"| user

|- | style="border: 1px solid #ebecec;"| createpage

| style="border: 1px solid #ebecec;"| allows the user to create new pages (edit permission is needed here)