We are looking at this feature as the first candidate to leverage the new ‘properties’ concept that Joram Wilander has been working on.
Figma Design - Figma Prototype - Loom Demo Video
Configuring custom user properties
In the system console, a new view is proposed under Site Configuration > System properties
. This will house configuration for customizing properties for users, messages, and cards.
To start, we’ll focus on user properties. Below is the view for configuring these properties.
User Property Types
Locked
Locked properties can not be:
Renamed
Reordered
Deleted
changed in Visibility
Everything other option remains the same as in default properties.
Unlocked
User can reorder, delete, and rename these properties.
Property Options
Rename: Sets focus on the name cell
Edit property type: Sets focus on the type cell and shows the type menu
Visibility: Choose whether the property shows in user profiles. Available options are:
Always show
Always hide
This hides the property from the profile popovers for all users.
Hide when empty (default)
This hides the property when its empty from the profile popovers.
Duplicate property: Creates a copy of the property with the same configuration and adds to the bottom of the table. Appends ‘2’ to the end of the property name.
Delete property: Removes the property from the list.
Locked user properties
Every Mattermost server has as set of standard user properties. These properties cannot be removed.
Profile Image (no visibility options)
Full Name (visibility default: Always show)
Username (visibility default: Always show)
Email (visibility default: Hide when empty)
ID (visibility default: Always hide)
Unlocked user properties
Default unlocked user properties
By default, the following optional properties ship with user profiles. These properties can be removed or edited as needed. Additional properties can also be added here (see ‘Adding a new property’ below).
Nickname
Position
Adding a new user property
Users can click the + Add property
button to add a new property to the system.
Re-ordering unlocked properties
Each row in the custom properties table can be dragged to re-order. Re-ordering here will change the order properties are displayed in the user profile.
NOTE: Standard properties cannot be re-ordered.
Editing a property
Editing property name
Clicking on the property name in the table enables users to edit the name inline.
Note: User property names must be unique.
Editing property type
Custom properties can be clicked to open up the types menu to change the property type. This menu is searchable.
We only provide the option to have 3 property types in the MVP:
Text
Phone
Email
If its easy to provide email and image since they are already used, we can consider them in the MVP.
Editing property options
Admins can set predefined options for a property with Select, and Multi-Select property types. Admins can add and remove options directly in this configuration table.
Displaying custom properties in the profile popover
Webapp
Standard properties will have reserved slots in the popover, while custom properties will display directly below the ‘Email’ property.