Users include authors, admins, and content managers who have access to Burdy CMS. Their permissions can be fine-grained through Groups. When first creating Burdy and when you are promoted with creating of the first user, it will be marked as Admin. Additionally, at the start, 2 groups are created:
- Admin - They have access to all the permissions (and have access to any new permissions which you might add via Hooks)
- User - Allows for basic access to CMS (only Authentication - no permission to edit anything)
Managing Users is done from 2 views:
- Users - Available from left panel
- Groups - Available via Settings -> Groups
To start managing the users in CMS, firstly you need appropriate permissions (Admin or user_administration permission). After that open up the Users tab on the left side:
Creating a user
To create a new user, click the Add button in the user's command bar. You will be promoted with a panel on the right side where you can create a new user, also you can assign them Groups and manage what they have access to. When opening up the user creation panel, there are 2 tabs available - Account (basic account information, first name, last name, password, etc.) and Groups (assigned Groups to the user).
Let's start by creating an example author:
If we go to the Groups tab, we will be promoted with an option of assigning groups to this user, and hence managing permissions which the user has.
Since we currently only have Admin and User, neither of them satisfy the permissions which we would like an author to have, so in one of the next following steps, we will create a new group for Authors. For now, we will create a user without any groups.
Go outside of the Group Selection panel and hit Create, you should see the new user in the user's list.
Editing a User
There are 2 main actions when editing a user (also visible from Command Bar):
- Activation / Deactivation - This allows you to activate or deactivate multiple selected users at once. This will remove their access from the panel and remove any sessions which they might've had.
- Delete - Deletes the user from the Burdy CMS
Apart from that if you click Edit on a user you will be presented with more options (such as assigning Groups or changing their name/password). You can also Edit Your Profile by clicking on your name in the top right corner and selecting Profile or clicking on yourself in the list and choosing Edit. In case of editing your profile, you can change your password, basic info (first name, last name) or assign yourself to groups (if you have permission to do so).
Groups allow you to manage and fine grain permissions that a user belonging to a group has the access to. To open the Groups configuration navigate to Settings -> Groups. You should see the following:
Functionalities of editing or creating a group are quite similar. Essentially you can fine-grain permissions, add basic information to the group (name, description). Note that protected groups cannot be fully edited, and they cannot be deleted (Admin and Users).
In the next step, let's create an Author group for the user we've previously created.
Creating A Group
To create a group, click on Add a Group button, and enter the basic details for the group. In terms of permissions, we will select Asset Management and Content Management, allowing our authors to upload images and update content. Also, since we can assign users to a group here as well (can be done from user creation/user editing as well). Let's add our Example Author to the Author group.
Now that we are done with the creation of the user let's log in as Example Author, and see the panel from their perspective.
Example Author Panel
If we log in as an example author now (using the credentials) we will only have permission to edit what was marked as editable previously. As you can see our Example Author, only has permission to access and view information/resources that we've selected. We also have permission to open the user's tab, however, this tab will only contain information about us.
As you can see, creating and managing users and their permissions inside Burdy is simple, yet powerful.