From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual
Crystal Clear action run.png

Release status: stable

Implementation User activity, Special page
Description Creates a list of logged-in & anonymous users currently online
Author(s) Maciej Brencz
Latest version 1.5.0 (2015-08-24)
MediaWiki 1.26+
Database changes Yes
License GNU General Public License 2.0 or later
  • $wgWhosOnlineShowAnons
Hooks used


Translate the WhosOnline extension if it is available at translatewiki.net

Check usage and version matrix; code metrics

The WhosOnline extension adds a special page - Special:WhosOnline - for viewing the list of users currently viewing a page on the wiki.

Installation[edit | edit source]

  • Download and place the file(s) in a directory called WhosOnline in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'WhosOnline' );
  • Run the update script which will automatically create the necessary database tables that this extension needs.
  • If you want anonymous users IP addresses shown, add:
    $wgWhosOnlineShowAnons = true;
    to LocalSettings.php after the above statement. Default is not to show them, for privacy reasons.
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing extensions using wfLoadExtension(), since MediaWiki 1.25. If you need to install this extension in earlier versions, instead of wfLoadExtension( 'WhosOnline' );, you need to use:

require_once "$IP/extensions/WhosOnline/WhosOnline.php";

(To run an extension on an earlier release, you may need to download the version of it tagged for that release from Special:ExtensionDistributor.)

Usage[edit | edit source]

Users who login after the extension is installed can be seen at Special:WhosOnline. Refresh the page if it is blank. As of version 1.3.1 it is possible to include the contents of the special page into a page: {{:Special:WhosOnline}}. If you use {{:Special:WhosOnline/10/shownav}} it will only show 10 users and will have the navigation controls.