Welcome, Registration, and other StartingPoints; TWiki history & Wiki style; All the docs...
Login | Register | Print


This plugin analyses the log files of your twiki-engine and extracts usefull information to be displayed on your site.
Warning: please respect the privacy of your users and don't display too much information.

Syntax Rules

Tag Description
%VISITORS{format="..." max="..." sep="..." header="..." footer="..."}% list of users currently logged in
defaults: format="\t* $wikiusername" sep="$n" max="unlimited"
%NRVISITORS% number of users currently online
%LASTVISITORS{format="..." max="..." sep="..." days="..." header="..." footer="..."}% list of users that recently visited the site
defaults: format="\t* $date: $wikiusername" sep="$n" max="unlimited" days="1"
%NRLASTVISITORS{days="..."}% list of users that recently visited the site
defaults: days="1"
%NRUSERS% number of registered users
%NRGUESTS% number of guest users currently online
%NEWUSERS{format="..." max="..." sep="..." header="..." footer="..."}% list of users that recently registerd
defaults: format="\t* date: $wikiusername" sep="$n" max="10"

The format parameter might containt the following variables:

Variable Description Valid in
$counter enumeration %VISITORS%, %LASTVISITORS%, %NEWUSERS%
$wikiname wikiname of the visitor %VISITORS%, %LASTVISITORS%, %NEWUSERS%
$username username of the visitor %VISITORS%, %LASTVISITORS%, %NEWUSERS%
$wikiusername wikiusername of the visitor %VISITORS%, %LASTVISITORS%, %NEWUSERS%
$date date of last visit/registration %VISITORS%, %LASTVISITORS%, %NEWUSERS%
$time time of last visit %VISITORS%, %LASTVISITORS%
$host host of visitor %VISITORS%, %LASTVISITORS%
$topic topic that a visitor viewed last %VISITORS%, %LASTVISITORS%
$quot double-quote sign %VISITORS%, %LASTVISITORS%, %NEWUSERS%
$percnt percentage sign %VISITORS%, %LASTVISITORS%, %NEWUSERS%
$dollar dollar sign %VISITORS%, %LASTVISITORS%, %NEWUSERS%

Plugin Settings

  • Set SHORTDESCRIPTION = Render information about users on your TWikiSite

  • add a list of host addresses to ignore users comming from them
    • Set IGNORE_HOSTS =
  • add a list of users to ignore

Plugin Installation Instructions

This plugin has been tested on TWiki/Beijing, TWiki/Cairo and TWiki/Dakar. If you are installing it on TWiki/Cairo you need the TWiki:Plugins/SessionPlugin. TWiki/Dakar has build-in support for cgi sessions.

  • Download the ZIP file from the Plugin web (see below)
  • Unzip UserInfoPlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/UserInfoPlugin.txt Plugin topic
    lib/TWiki/Plugins/UserInfoPlugin.pm Plugin Perl module
    lib/TWiki/Plugins/UserInfoPlugin/Core.pm Plugin Perl module
  • (Dakar) Visit configure in your TWiki installation, and enable the plugin in the {Plugins} section.


If the plugin is installed correctly then you should get valid output for the tags below:

0 of 551 registered user(s), 30 guest(s) currently online:

3 visitor(s) in the last 4 days:
Recently registered users:

Plugin Info

Plugin Author: TWiki:Main/MichaelDaum
Copyright ©: 2005-2006, Michael Daum
License: GPL (GNU General Public License)
Plugin Version: v1.53
Change History:  
09 June 2006: fixed duplicate users in LASTVISITORS; use IGNORE_USERS in LASTVISITORS
27 May 2006: fixed error computing the number of last visitors (TWiki:Main.DavidBright); exclude the TWikiAdminGroup "user" from the statistics; check back if the user found in the logs already approved his account; fixed use of non-numerical value in comparison
17 Feb 2006: optimized tag parsing; using Time::Local instead of Date::Parse; added header and footer format strings; fixed error restricting seen visitors by days
16 Feb 2006: OO-ified the plugin to compile on demand; added IGNORE_USER plugin parameter
14 Feb 2006: fixed detection of the session directory
02 Feb 2006: fixed numerical comparison of dates (TWiki:Main/AntonAylward)
05 Aug 2005: removed dependency on the SessionPlugin
27 Apr 2005: fixed getting guests + some minor glitches
12 Apr 2005: initial release
  fixed sep handling, fixed $host parsing
TWiki Dependency: $TWiki::Plugins::VERSION 1.024
CPAN Dependencies: Time::Local
Other Dependencies: (TWiki:Plugins/SessionPlugin)
Perl Version: 5.8
TWiki:Plugins/Benchmark: TWiki:TWiki/GoodStyle nn%, TWiki:TWiki/FormattedSearch nn%, UserInfoPlugin nn%
Plugin Home: TWiki:Plugins/UserInfoPlugin
Feedback: TWiki:Plugins/UserInfoPluginDev
Appraisal: TWiki:Plugins/UserInfoPluginAppraisal

-- TWiki:Main/MichaelDaum - 09 June 2006

r5 - 06 Jan 2011 - 10:09:56 - ScottWilliams
WikiRing logo

Copyright © High 5s 2009 (Read the full copyright statement).
The High 5s Project is a patient safety collaboration among a group of countries and the WHO Collaborating Centre for Patient Safety
in support of the World Health Organization (WHO), Patient Safety Programme (Read the full acknowledgment statement).
Ideas, requests, problems regarding High 5s Project? Send feedback
Syndicate this site RSSATOM