Users
✋ Note About the Users Admin Pages
For convenience (mostly during development) there is a small users admin section provided with Watchtower. While it does allow you to create, edit, delete, synchronize users it only allows you to do so with the name, email (and when necessary "password") fields from the users table in the database.
As your app grows and takes shape you will probably have your own users page later with many more fields to manage. At that point you can change the 📜 Watchtower Dashboard Configuration Options to point the link to your own users admin pages. However you are not required to do so, you can modify the views provided with Watchtower if you prefer to continue using the views provided.
If you have the watchtower.acl.user.index permission, you will be able to view the user index list. By default pagination is set to 15 items. Watchtower Configuration will allow you to change that value for users.
If you have the watchtower.acl.user.create permission, when you view the user index list, you will see a large "Add New User" button above the list of users.
Clicking that button will bring you to a form to input your new user. All four fields are mandatory.
If you have the watchtower.acl.user.show permission, when you view the user index list, you will be able to click on the Name of the user and be brought to a page that will show you information about that user, with links to its associated roles or to edit the user.
✋ NOTE Clicking on the "Roles" link at the bottom of the form, will bring you to the Sync page so you can view and/or modify the roles associated with the user.
If you have the watchtower.acl.user.edit permission, when you view the user index list, you will see an "Update" button for each user. (in the following image, the button is coloured grey and is the middle button in the group of buttons)
Clicking that button will take you to the form to edit the properties of the user.
If you have the watchtower.acl.user.destroy permission, when you view the userindex list, you will see a "Delete" button for each user. (in the following image, the button is coloured red and is the last in the group of buttons)
If you click that button, you will need to confirm that you want to delete the user.
✋ NOTE If you confirm and delete the user, it is gone. There is no going back.
The user matrix is the most useful of the user pages provided with Watchtower. It allows you to view all your users and all your roles in one big matrix where you can check off the boxes needed to assign multiple users to multiple roles all at one time. If you have the watchtower.acl.user.viewmatrix permission, you will be able to access the user matrix.
When you click on each checkbox, it will inform you of the Role and the Email address of the user being selected. This way, if your page is starting to get a bit long, you won't need to scroll back up and see what role you are assigning.
Beside each username and after each role name is a link button that will take you to that show page for that specific item in case you need to see the properties of that item.
If you have the watchtower.acl.user.role permission, when you view the user index list, you will see a "Roles" button for each user. (in the following image, the button is coloured blue and is the first in the group of buttons)
If you click on that button you will be shown which roles are currently assigned to that user and all the other roles available to be assigned to that user. You can also click on the "Toggle Permissions" button to see what permissions the current user has associated to them through their various roles.
Check off the boxes as appropriate and then click the Update button to modify a users role memberships.
💡 Tip If you look closely, you will see there is a count of Current Roles and Available Roles in parenthesis in the appropriate headers.
If you have the watchtower.acl.user.search permission, when you view the user index list, you will see a search box directly below the title with a count of how many records were found. It will also list any filter used and, if you have performed a search, a link to clear the filter.
✋ Note Searching is not a complicated intensive affair, this is a simple lookup box. This is not a super-duper google style search box. It is a simple string match against the name field.