| Ui text box |
|---|
You can assign users to Categories and Spaces. For Categories this can be done in the Site Builder. Go to: Site Builder > Category listing > Settings cog > Connect Users.
For Spaces, space admins can hover over Space Users and edit accordingly. |
...
This means the users are assigned to that category as a work space. It does not mean they have special view permissions or administrative rights.
Admins can connect individual users, user groups, or create a user role. This can be edited within the Site Builder category listing or directly from a dropdown subcategory menu.
| Ui text box | ||
|---|---|---|
| ||
Note that connecting roles, users and groups act as labels assigning users to a workspace. They do not give any permissions or administrative rights to the user. |
Roles
With our app you can assign roles to a user in a category. This is done by selecting a user, and assigning a role title for that user. The role title could be a small descriptive entry of the users role within this category. E.g. Project Lead, Supervisor, Contact person. RefinedTheme will give suggestions for the most common role titles to speed up the creation of roles.
Displaying Roles
User roles can be displayed in a category drop down menu, on a site home, a category home and/or on a space.
To display a user on a category dropdown, add a user to Roles within that category setting and they will automatically show up.
To display user roles on a Site or Category home:
- Open up the layout editor on the category
- Add the content module called Users in Category to a section.
...
- Click the edit button next to Space Users
- Add the users
- Save!
| Ui text box | ||
|---|---|---|
| ||
You can choose to only display the users in the category with a role by checking Roles only. |
Permissions
Confluence administrators can manage users for each category and subcategories through the Site Builder view permissions. Any user included as a category admin can manage users for that category and any subcategory visible for that user. The category admin will access the connect users settings from the category layout editor home.
Integration with macros
Users In Category
The users in category macro will display the users linked to the specified category, or if no category is specified, the current category (useful on category dashboards). In the macro you can specify the layout to use whilst presenting the users and if you should only display users with assigned roles.
User details macro
The user details macro can be configured to display what categories and spaces a user is a member of. If the user has any assigned roles these will be displayed as well. These 'memberships' will only be displayed while using layout: full.
Users macro
In the same way as the user details macro can be configured to display categories and spaces a user is a member of. Again, these will only be displayed while using layout:full.
Organizing users into spaces
Linking users to spaces works the same way as linking users to categories.The difference being that users linked to spaces will only be displayed through the Users In Space macro - a macro introduced in Original Theme 4.2 together with the linking users functionality. The macro has been included in the space layout templates (all except the public space layout).
Permissions
Confluence administrators and space admins will be able to access the Manage users dialog from the Users in space macro on a space or page.
Integration with macros
Users In Space macro
The users in space macro will display users and roles linked to the specified space. If no space is specified the users from the current space will be displayed.
User details macro
The user details macro can be configured to display what categories and spaces a user is a member of. If the user has any assigned roles these will be displayed as well. These 'memberships' will only be displayed while using layout: full.
Users macro
In the same way as the user details macro can be configured to display categories and spaces a user is a member of. Again, these will only be displayed while using layout:full.
Manage users dialog
The manage users dialog is where an Confluence administrator, Category admin or Space admin (depending on if it's a space or a category) can manage roles and users linked to a certain category, subcategory or space. The dialog is available from the Site Builder, from the category dashboards, or from the space via the Users In Space macro.
Configuration options
...
With Refined, you can connect users to categories and spaces. For example, on an intranet you can use this feature to show which users work on an HR project and which roles they have. You can add up to 200 users per category or space.
| Info |
|---|
This functionality is not related to any permissions, nor does it decide what content users can view. It is simply a way of displaying users who are organisationally connected to the category, for example to let other users know who to contact. |
Add users and user groups
To connect users to a category:
Go to the Refined Administration > Site Builder.
Click a category’s Cogwheel > Connect users.
To connect users to a space:
Go to the space.
Hover your mouse over the Space users box on the left-hand side and click the Pen icon that appears.
Settings
Parameters | Description | Available for |
|---|---|---|
Category | Switch between (sub)categories to select which one to edit. | Category |
Roles | Fill in the role a user has in this category or space (search for a user by full name or username |
...
). | Category/ |
...
space | ||
User groups | Search for user groups defined in Confluence. Adding a group will link all containing users to this category/space. | Category/ |
...
space | |
Users | Search for |
...
a user by full name or username |
...
. | Category/ |
...
space |
Visible |
...
Select to show the connected users in the category menu’s dropdown |
...
list. Please note that this setting does not affect visibility in modules or macros. | Category |
Only display roles |
...
Select to only show users |
...
who have roles assigned to them in the category menu’s dropdown list. This functionality is available for spaces |
...
in the Users In Space macro. | Category |
Related macros
...
Use modules/macros to display connected users
Add the Users in Category module to a site or category home to show user information.
Use macros on pages, user dashboards, and space layouts to show user information: