admin_tool1Add my vote for this tag statistics1Add my vote for this tag users2Add my vote for this tag create new tag
, view all tags


Render information about users on a TWiki site

This plugin analyzes the log files of your twiki-engine and extracts useful information to be displayed on your site.

NOTE: Please respect the privacy of your users and don't display too much information.

Syntax Rules

Tag Description Default
%VISITORS{format="..." max="..." sep="..." header="..." footer="..."}% list of users currently logged in 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 format="\t* $date: $wikiusername" sep="$n" max="unlimited" days="1"
%NRLASTVISITORS{days="..."}% list of users that recently visited the site 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 format="\t* date: $wikiusername" sep="$n" max="10"

The format parameter might contain 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 a TWiki site

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

Plugin Installation Instructions

  • 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
  • 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:

%NRVISITORS% of %NRUSERS% registered user(s), %NRGUESTS% guest(s) currently online:
%NRLASTVISITORS{days="1"}% visitor(s) today (09 Feb 2018):
%LASTVISITORS{days="1" format=" * $wikiusername"}%
Recently registered users:

Plugin Info

Plugin Author: TWiki:Main.MichaelDaum
Copyright: © 2005-2006 Michael Daum,
© 2005-2010 TWiki:TWiki.TWikiContributor
License: GPL (GNU General Public License)
Plugin Version: 19259 (2010-07-25)
Change History:  
2010-07-25: TWikibug:Item6530 - doc fixes
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: none
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
Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 UserInfoPlugin.md5 r9 r8 r7 r6 r5 manage 0.2 K 2010-07-26 - 06:38 PeterThoeny  
Compressed Zip archivetgz UserInfoPlugin.tgz r9 r8 r7 r6 r5 manage 8.0 K 2010-07-26 - 06:38 PeterThoeny  
Compressed Zip archivezip UserInfoPlugin.zip r17 r16 r15 r14 r13 manage 10.3 K 2010-07-26 - 06:38 PeterThoeny  
Unknown file formatEXT UserInfoPlugin_installer r2 r1 manage 3.4 K 2010-07-26 - 06:38 PeterThoeny  
Edit | Attach | Watch | Print version | History: r28 < r27 < r26 < r25 < r24 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r28 - 2013-10-16 - PeterThoeny
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.