Users Module
- Creating a New User
- Managing User Groups and Permissions
- Customizing Profile Fields
- User Module URLs
- Using User Data in Layouts
The users module is where you manage your sites users. To start, go to Users → Manage Users. You'll see a paginated list of your current users.
You can search and filter them using the filter tools. Typing into the text box will search names and usernames of users. The results are populated via AJAX.
Creating a New User
To register a new user on your site, click on + Add User and fill out the user form. At the very least, you need to provide an email address, username, password, display name, and whatever profile fields you have set to required. The display name is what will be used when the system needs to display the proper name of the user.
Managing User Groups and Permissions
By default, PyroCMS comes with two user groups:
- Administrators - These are admins of your site and have access to everything on the back end.
- Users - These are basic users of your site and only have access to the front end.
These two groups cannot be deleted, however you can add additional groups by going to Users → Groups and clicking on + Add Group. You'll be asked to simply name your group and give it a slug.
Once you have created a new group, you can go to Users → Permissions and click on Edit Permissions for the group you just created. On the edit permissions page, you'll see a lot of permissions options. Here you can exclude users from having access to particular modules, as well as give them granular permissions in modules that support them.
Customizing Profile Fields
PyroCMS comes with a preset slate of user fields, but these can be easily changed. To manage your user profile fields, go to Users → Manage Users and click on the Profile Fields section menu.
There you'll see a list of all the profiles fields. Simply delete, edit, and add as necessary. Profile fields run off of so you can use any core field types or third party field types you've installed.
To make a profile field show up on the register page, simply make it required when you create a new field.
User Module URLs
The Users module uses the following public URLs:
/register // Register page if you have user registration turned on)
/user/{user_id} // User public profile page
/my-profile // User's own public profile page
/edit-profile // Page for a user to edit their own profile
To customize these pages, see module view overloading.
Using User Data in Layouts
To see how to use settings values in layouts, see the user plugin docs.