The User List macro has an optional Display Online parameter. If the User Listener plugin is configured to allow this feature, then the page author can select Display Online 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 Display Online filter in the User List macro:

  1. Choose the cog icon  at top right of the screen, then choose Confluence Admin.
  2. Select Plugins in the left-hand panel. This will list the currently installed plugins.
  3. Scroll down and click User Listener. The User Listener plugin panel will appear at the top of the screen.
  4. Enable the User Log In Listener module by clicking Enable on its right.
  5. Restart Confluence.
 

(warning) The information on this page does not apply to Confluence OnDemand.

List of online users can be misleading

When the Display Online parameter 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

User List Macro
Enabling and Configuring Macros

  • No labels

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