This server will be upgraded at 3pm Sydney time on December 3rd (December 2nd, 8pm PST) and will be down for up to 30 minutes.
This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Configuring the userlister Macro

All Versions
Click for all versions
Confluence 2.9 Documentation

Index

The userlister macro has an optional 'online' parameter. If the 'User Listener' plugin is configured to allow this feature, then the page author can specify 'online=true' to show a list of all online users.

You need to have System Administrator permissions in order to perform this function.

To enable the 'online' filter in the userlister macro,

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' view will open.
  2. Select 'Plugins' in the left-hand panel. This will list the currently installed plugins.
  3. Scroll down and click the 'User Listener' link. The User Listener plugin panel will appear at the top of the screen.
  4. Enable the 'User Log In Listener' module by clicking the 'Enable' link on its right.
  5. Restart Confluence.


List of online users can be misleading

When the parameter 'online=true' is used, Confluence uses a context listener to generate the list of online users. A context listener is a J2EE term for something that listens for events in the application server. We listen for session open and close events, so a user is 'online' if they have a session on the application server. Some application servers don't correctly despatch close events for sessions – in these cases, the list of online users may be misleading.


Screenshot: Enabling the User Log In Listener

RELATED TOPICS

Userlister Macro
Enabling and Configuring Macros

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.