Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top
Display the profile information of several users alphabetically sorted according to given criteria using the Profile List macro. The configuration options allow for different profile lists for a variety of purposes: birthday list, telephone directory, expert list ...


Image 1: Profile List Macro

Please refer to our FAQ article How do I create a phone book with User Profiles for Confluence? if you are interested in this option.

Parameters

Parameter

Default

Description

Criteria

none

required

The criteria define which user profiles will be displayed. All user profiles that match the specified criteria will be displayed. Multiple criteria can be separated by comma (,).

For everyone familiar with Lucene search syntax: You can use it to further refine your criteria (see also Searching Macro "Profile List" (v 2.0)#Searching the User Profiles).

To display all users you have to insert [a TO z]

Elements per Page6optionalDefines how many user profiles will be displayed per page. If there are more elements, the page navigation menu will be displayed.
Styleprofile cardsoptional

The style defines how the results should be displayed.

  • profile cards – displays the user profiles in a business card layout for each user (as known from the People Directory). The shown profile elements depend on the selected mode (Full name, email and latest status message will always be shown. Except in minimal mode where  the status is not displayed.)
  • table – displays the users' profiles listed in a table. One row for each user, one column for each profile element – the full name will always be the first column

Mode

minimal

optional

The mode defines which elements of the user profile will be shown:

  • minimal – the elements user name and email 
  • custom – selected elements of the user profile, according to the configuration of the user profile element (see “Visibility” in  Configuration of Elements – Add and Edit )
  • namedFields – selected elements of the user profile that you have to enter below in the input field “Named Fields”
  • full – all elements of the user profile that contain data
Named fieldsnonerequired, if mode is ‘namedFields’

Fields to be displayed if the mode “namedFields” is chosen. If you want to see multiple fields separate them with commas, e.g. “phone” or “phone, website”.

Use the following keys for the default Confluence profile elements:

  • Name: fullName (This element does not have to be entered because it is always displayed.)
  • E-Mail: email
  • Phone: phone
  • Website: website
  • IM: im
  • Position: position
  • Department: department
  • Location: location

(lightbulb) Demonstration of the profile list macro (If you cannot see the embedded video below, please check whether you have agreed to the privacy policy of this website or if your browser blocks unsafe content.)



Back to Top

Include Page
_Version Switch
_Version Switch

Disable checkingPremium suggestions