Groups and Permissions Overview
Since version 2.1, Censura has a much improved user groups/permissions system. You can create custom groups, assign permissions to them, then assign them to users. You can also assign permissions directly to users. If you are intgrating with an external system, eg a forum, you can map user groups in your forum to censura user groups.
Permissions
Censura checks for a certain permissions before it allows a user to perform an action. For instance before a user adds a review, censura looks for the reviewAdd permission. Permissions can be assigned to users directly, plus they are inherited from the groups that the user belongs to. Assign permissions to a user by clicking "users" from the admin home page then clicking the "key" next to the user you want to edit. Permissions inherited from the groups the user belongs to are shown in grey, and cannot be removed. Sometimes you might want a user to be able to edit some items, but not others. For example, you might want a user to be able to edit only products belonging to a certain vendor. To do this you can create custom permissions. Go to the "view custom permissions" page from the admin control panel and click "create a new custom permission". Choose the type of permission you want to create, then you can give it a name and select parameters for the type of items you want the user to have control over. For instance if you select "manage products" as the type and then select a vendor as a parameter, then any users you assign this permission to will be able to access the admin, but they will only be able to access products belonging to the given vendor. They will also only be shown links to pages they can actually go to and use. At the moment, vendor is the only parameter, but it will be possible to add more in the future. You can also click "create vendor admin group" on the groups page (see below) to create permissions which enable a user to edit everything to do with products belonging to the given vendor (eg products, reviews etc), then assigns them all to a new group. You can simply assign this group to a user as described below to given them vendor admin privileges.
Groups
Censura has 3 built-in "core" groups which you cannot remove. These are guest, member (registered user) and root admin. These groups are assigned automatically, and cannot be removed from a user. A user is a root admin if they were created by the installer. All registered users have the member group. Everyone (including admins and members) is assigned to the guest group. This is because no group can have less permissions than the guest group, as the user could simply log out to get more privileges. To save duplication of permission assignments, all users will have any permissions assigned to the guest group. A root admin automatically bypasses all permissions checks, so there is no need to assign any permissions to them. In addition to these, you can also create your own custom groups, eg a moderator groups. You can then assign permissions to them, and assign the group to a user. To create a group, go to the "groups" page in admin, then click "create a group". Once you've created the group, you will be directed to a page to assign permissions to the group. From the group menu, you can access the permission assignment page by clicking the "key" in the row for the group you want. To assign groups to users, go to the "users" page from the admin home page and click the "groups" icon next to the user you want to assign a group to, then select and assign the group. If you are integrating with an external group, you can map external groups to censura groups. Any users assigned to a particular group in your forum will be assigned to the group(s) in censura that you specify. Click the "Map Groups from an External System" link on the admin home page, then select an external group, then a censura group to map it to. Please note that not all external systems have the concept of groups, so obviously you can't map them here if that's the case with your software.