Macro "Profile List" (v 3.2)

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 Extended Search).

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 and email will always be shown.)
  • 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. Since version 2.1 a link for starting a Skype for Business chat will also be displayed, if the Skype for Business integration is enabled (see Skype for Business Integration (v. 3.0)).
  • prioritized – selected elements of the user profile, according to the configuration of the user profile element (see “Prioritized Element” 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

SINCE VERSION 2.1

If the Skype for Business integration is enabled, you can use the key skype-chat to render a link for starting a Skype for Business chat with the user.

(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