UserInfoPlugin

This plugin analyses the session files of your wiki and extracts useful 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%
$n	newline	%VISITORS%, %LASTVISITORS%, %NEWUSERS%
$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 wiki

• add a list of host addresses to ignore users comming 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 foswiki installation directory. Content:

File:	Description:
data/System/UserInfoPlugin.txt	Plugin topic
lib/Foswiki/Plugins/UserInfoPlugin.pm	Plugin Perl module
lib/Foswiki/Plugins/UserInfoPlugin/Core.pm	Plugin Perl module

• (Dakar) Visit configure in your Foswiki 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:

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

Plugin Info

Plugin Author:	Foswiki:Main/MichaelDaum
Copyright ©:	2005-2006, Michael Daum
License:	GPL (GNU General Public License)
Plugin Version:	v1.54
Change History:
12 Jan 2010:	ported to Foswiki (Foswiki:Main.WillNorris)
09 Jun 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 AdminGroup "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
Foswiki Dependency:	$TWiki::Plugins::VERSION 1.1
CPAN Dependencies:	CPAN:Time::Local
Perl Version:	5.8
Plugin Home:	http://foswiki.org/Extensions/UserInfoPlugin
Support:	http://foswiki.org/Support/UserInfoPlugin

-- Foswiki:Main/MichaelDaum - 09 June 2006