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.

(info) 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 'Administration Console' view. To do this:

    • Go to a page in the space and choose 'Administration' from the 'User' menu, which is labelled with your Confluence username. 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
Macros

  • No labels

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.