Skip to end of metadata
Go to start of metadata

Overview

Displays a list of user pictures linked to their profile.

Usage

{users:beginning=a|group=myGroup|showPicture=false|showName=true}
{users:recently-created|count=10}

Parameters

Parameter

Required

Default

Notes

Bubbles Version

default

(error)

list

The display mode

  • list list users
  • group list users in group (need to spcify group param)
  • recently-created list recently created users
  • recently-contributed list users who have recently edited, created or removed content

1.0

beginning

(error)

 

A string with which all users full names must begin for them to be included in the list

1.0

group

(error)

 

The group whose pictures should be displayed (only with group or list display modes)

1.0

count

(error)

25

Limit the number of users/pictures displayed.

1.0

none

(error)

 

The text to show if no matching users can be found

1.0

unique

(error)

true

Only show one copy of each user.

1.0

class

(error)

 

The css class to add to the outermost div.

1.0

showName

(error)

true

Whether the users's name should be shown.

1.0

showControls

(error)

false

Show icons with the image that link to functions related to the user being displayed.

1.0

Examples

 Listing new users

The following will list the 10 most recently created users on this site:

{users:recently-created|count=10}

Which results in:

 Listing recent contributors

The following will list the 10 most recent contributors on this site:

{users:recently-contributed|count=10}

Which results in:

 

 People who's name starts with the letter A

The following will list 10 people whose name starts with the letter A in the main confluence-users group:

{cache}{users:group|count=10|beginning=A|group=confluence-users}{cache}

Which results in:

We wrapped the users macro in the {cache} macro to reduce load on the server.

 

 

7 Comments

  1. Unknown User (jmdwitte)

    Is it possible to determine the scope of the users macro? It would be very great to display an overview of users that did recent updates to a particular space.

    1. Unknown User (skrebs)

      Not currently, I can see how that would be useful though.

    2. Unknown User (gfraser)

      If your space permissions are set so that only users in one group can contribute content you can use the "recently-contributed" mode of the plugin along with specifying the user group to get that sort of information.

      However, there isn't a mode that currently works by just specifying a space.

  2. Unknown User (bcarr)

    This might be a really dumb question, but do you know what might be causing the users' pictures to not show up when using the {users} macro? Here's what I have on my page:

    {users:group=user_experience}
    

    But here's what I get:

    I am currently evaluating Community Bubbles on a Development instance of Confluence.

    1. Unknown User (skrebs)

      Check the base url settings in the Confluence admin. (Also if you aren't running the latest version, there was some issues in earlier releases where Confluence wasn't running at the root context of the app server.)

      1. Unknown User (bcarr)

        Brilliant. Changing the base URL did the trick. Thanks for your quick response!

        1. Unknown User (shumano)

          I had the same issue too...

          All that i missed in the base url was "http://" in front of my www url

          Now its rocking...(smile)