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 | |
list | The display mode
|
1.0 |
| beginning | |
A string with which all users full names must begin for them to be included in the list | 1.0 | |
| group | |
The group whose pictures should be displayed (only with group or list display modes) | 1.0 | |
| count | |
25 | Limit the number of users/pictures displayed. | 1.0 |
| none | |
The text to show if no matching users can be found | 1.0 | |
| unique | |
true | Only show one copy of each user. | 1.0 |
| class | |
The css class to add to the outermost div. | 1.0 | |
| showName | |
true | Whether the users's name should be shown. | 1.0 |
| showControls | |
false | Show icons with the image that link to functions related to the user being displayed. | 1.0 |
Examples
.png)








Comments (16)
Nov 28, 2008
Doods Perea says:
The users macro lists my users vertically rather than horizontally. My Bubbles ...The users macro lists my users vertically rather than horizontally. My Bubbles plugin version is 0.9.57.
Here's the code that I use:
Thanks.
(NOTE: I just edited this comment and found that your listing is horizontal. I guess I just have to update my plugin
)
Nov 28, 2008
Doods Perea says:
After upgrading my plugin to 1.0.3, I got the following error: Error formatting...After upgrading my plugin to 1.0.3, I got the following error:
Error formatting macro: users: java.lang.IncompatibleClassChangeError
The "forum macro" works okay, its just this "users macro" that produces the above error.
Help please.
Thanks.
Nov 29, 2008
Shannon Krebs says:
As a first step it might be worth restarting your Confluence instance incase the...As a first step it might be worth restarting your Confluence instance incase the old version of the plugin didn't uninstall correctly.
If that doesn't work please open a support issue on tracker.adaptavist.com and let us know what version of confluence you are using along the full stacktrace from the logs to help us work out what is going wrong.
Dec 02, 2008
Jan-Mark de Witte says:
Is it possible to determine the scope of the users macro? It would be very great...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.
Dec 02, 2008
Shannon Krebs says:
Not currently, I can see how that would be useful though.Not currently, I can see how that would be useful though.
Dec 03, 2008
Guy Fraser says:
If your space permissions are set so that only users in one group can contribute...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.
Mar 04, 2009
Brian Carr says:
This might be a really dumb question, but do you know what might be causing the ...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.
Mar 04, 2009
Shannon Krebs says:
Check the base url settings in the Confluence admin. (Also if you aren't runnin...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.)
Mar 04, 2009
Brian Carr says:
Brilliant. Changing the base URL did the trick. Thanks for your quick response!Brilliant. Changing the base URL did the trick. Thanks for your quick response!
Apr 08, 2009
shumano shakai says:
I had the same issue too... All that i missed in the base url was "http://" in ...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...
Apr 08, 2009
shumano shakai says:
I would like to customize the way the users macro displays the user details. F...I would like to customize the way the users macro displays the user details.
Few customizations that i wish to do are changing the round rectangle display to a plain white rectangle; adding a border to the user profile pic; increase/decrease the spacing between the users;
Is there a way to do them? I am using confluence 2.10.2 with community bubbles 1.2.2
Jul 20, 2010
James Nevin says:
I'd like to know what period of time defines "recently-contributed" in this macr...I'd like to know what period of time defines "recently-contributed" in this macro?
Currently, when I generate the user list with this option, as say...
{users:recently-contributed|count=10|group=OUR-GROUP|showControls=true}...I'm not getting a full 10 users listed (though there are at least that many who have contributed and are members of OUR-GROUP) – presumably because some of the users' most recent contributions are old, i.e., stale.
At what point does the "recently-contributed" option consider a user's contribution to be too old for the purpose of including the user in the generated list? Is there a way of changing that time window?
Aug 24, 2010
James Brown says:
I am having an issue with the popup display box. When I hover over a users photo...I am having an issue with the popup display box. When I hover over a users photo I basically am only seeing the shadow of the popup box and none of the content (see image below). Can someone help me?
Oct 16, 2010
heather says:
I have James Browns issues with only a line crossing the list of users also in F...I have James Browns issues with only a line crossing the list of users also in Firefox 3.6mac. I am using 3.4 and everything is updated.
Dec 08, 2010
Brian Wylie says:
I'm sure it's pilot error, but I want to simply list the users. So how do I do t...I'm sure it's pilot error, but I want to simply list the users. So how do I do that?
{users:list=user1,user2,user3}just hangs my browser.
Jun 30, 2011
ualex7 says:
Hi Brian, Did you figure out how to display custom list? Thanks, mateHi Brian,
Did you figure out how to display custom list?
Thanks, mate