Confluence Docs 3.0 : Configuring the userlister Macro This page last changed on Nov 03, 2008 by smaddox. 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, Go to the Confluence 'Administration Console'. To do this: Open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' view will open. Select 'Plugins' in the left-hand panel. This will list the currently installed plugins. Scroll down and click the 'User Listener' link. The User Listener plugin panel will appear at the top of the screen. Enable the 'User Log In Listener' module by clicking the 'Enable' link on its right. 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 Attachments: UserListenerPlugin.png (image/png)

Document generated by Confluence on Nov 05, 2009 23:27