Roles are a way of grouping multiple users and assigning permissions to that group. They are the connection of users to permissions. A user can have multiple roles, each with different permissions. Though for simple needs, it's common for a user to just have one non-guest role. However, you may assign as many as you need.

While roles are assigned to users, they are applied to the context of a Page by way of template access control settings. These can be accessed from the template editor Access tab (Setup > Templates > Edit Template > Access). From here you can dictate what roles are allowed to view, edit, create, add new pages, and more. Only roles that have at least page-edit permission are assignable for edit/add/create access in these template access settings.

Default Roles

ProcessWire includes two permanent roles by default, though you may add as many roles as you like. The two roles included with every ProcessWire installation are:

The guest role is automatically given to all anonymous site users. You should not give this role any access other than page-view permission.

The superuser role has all-inclusive access to the site without limitation. This role should only be given to the most trusted users that operate the site. Superuser has all permissions regardless of what you assign with the superuser role.

Custom Roles

You can also add as many other roles as you want and selectively assign them to specific users. Each role can be assigned a unique set of permissions. Any given user can have multiple roles, and that user will inherit all permissions assigned to each of their roles. All users also inherit permissions assigned to the guest role.


No comments yet. Be the first to post!

Post a Comment

Your e-mail is kept confidential and not included with your comment. Website is optional.