UserInfoPlugin

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

The format parameter might contain the following variables:

Variable	Description	Valid in
$date	date of last visit/registration	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$dollar	dollar sign	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$quot	double-quote sign	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$counter	enumeration	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$host	host of visitor	%VISITORS%, %LASTVISITORS%
$n	newline	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$percnt	percentage sign	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$time	time of last visit	%VISITORS%, %LASTVISITORS%
$topic	topic that a visitor viewed last	%VISITORS%, %LASTVISITORS%
$username	username of the visitor	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$wikiname	wikiname of the visitor	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$wikiusername	wikiusername of the visitor	%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
  • Set IGNORE_USERS = TestUser

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.

Test

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

0 of 13 registered user(s), 994 guest(s) currently online:

0 visitor(s) today (03 Apr 2025):

Recently registered users: 22 Jan 2025 - EmielDeTester567 22 Jan 2025 - EmielTester123 22 Jan 2025 - EmielTester2334 06 Jul 2024 - EmielTestTestr5 05 Jul 2024 - EmielDeTester5 05 Jul 2024 - EmielTester6 05 Jul 2024 - EmielTesterDeTester 05 Jul 2024 - EmielTesterVanRiel 07 Jun 2024 - JunoContact000001 03 Apr 2019 - LeoVanRooij 2017-05-11 - EmielTester 2016-08-08 - EmielVanRiel 2018-11-15 - JunoDemo

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