Tags:
create new tag
, view all tags

RecentVisitorPlugin

Show statistics of recent visitors to the TWiki site

Introduction

This plugin shows statistics of recent visitors to a TWiki site. The time of last visit and the IP address used can be shown of individual users. The recent report shows latest visitors in chronological order.

Syntax Rules

Most recent visit of an individual

%RECENTVISITOR{ action="user" ... }%

Parameter Description Default
"user" or
action="user"
Show statistics of individual user. (none)
name="..." WikiName of person (current user)
format="..." Format of report. Supported tokens:
$date - date of last visit
$time - time of last visit (GMT)
$ago - how long ago
$ip - IP address (only shown to non-administrators if enabled in configure)
$n, $nop, $quot, $percnt, $dollar - standard FormatTokens
"Last seen $ago ago"
notfound="..." Message shown if user is not found. "Never seen"

Report of recent visitors

%RECENTVISITOR{ action="recent" ... }%

Parameter Description Default
"recent" or
action="recent"
Show statistics of most recent visitors. (none)
format="..." Format of each line of the report. Supported tokens:
$username - login name of user
$wikiname - WikiName of user
$wikusername - WikiName prefixed with Main web name
$date - date of last visit
$time - time of last visit (GMT)
$ago - how long ago
$ip - IP address (only shown to non-administrators if enabled in configure)
$n, $nop, $quot, $percnt, $dollar - standard FormatTokens
"   * $wikiusername
      last seen $ago ago"
separator="..." Separator between lines. Standard FormatTokens are expanded. "$n" (newline)
limit="..." Limit the number of lines. "10"

See also VarRECENTVISITOR documentation for TWikiVariables.

Examples

Example: Show most recent visit of TWikiAdminUser

You type You get (if installed) Simulated example
%RECENTVISITOR{
 action="user"
 name="TWikiAdminUser"
 format="Last seen $ago ago ($date 
$time)"
}%
Sorry, only members of the TWikiAdminGroup can view visitor statistics. Last seen 3 weeks ago (2012-11-03 06:22)

Example: Show recent visitors, default bullet list report

You type You get (if installed) Simulated example
%RECENTVISITOR{
 action="recent"
 limit="5"
}%
Sorry, only members of the TWikiAdminGroup can view visitor statistics.

Example: Show recent visitors, table report

You type You get (if installed) Simulated example
%RECENTVISITOR{
 action="recent"
 format="| $wikiusername | $date |"
 limit="5"
}%
Sorry, only members of the TWikiAdminGroup can view visitor statistics.
NielsBohr 2012-02-03
KlausFuchs 2012-02-03
AlbertEinstein 2012-02-02
EnricoFermi 2012-01-19
DavidBohm 2011-11-27

Example: Show recent visitors with geolocation

This example uses the TWiki:Plugins.GeoLookupPlugin to resolve IP addresses to geolocations.

You type You get (if installed) Simulated example
| *Name* | *Last seen* | *Where* |
%RECENTVISITOR{
 action="recent"
 limit="5"
 format="| $wikiusername | $ago ago
 | $percntGEOLOOKUP{$ip}$percnt |"
}%
Name Last seen Where
Sorry, only members of the TWikiAdminGroup can view visitor statistics.
Name Last seen Where
NielsBohr moments ago Oak Ridge, TN, USA
KlausFuchs 3 hours ago Cupertino, CA, USA
AlbertEinstein 1 day ago Oak Ridge, TN, USA
EnricoFermi 15 days ago Los Alamos, TN, USA
DavidBohm 2 month ago Los Alamos, NM, USA

Plugin Installation & Configuration

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.

  • For an automated installation, run the configure script and follow "Find More Extensions" in the in the Extensions section.

  • Or, follow these manual installation steps:
    • Download the ZIP file from the Plugins home (see below).
    • Unzip RecentVisitorPlugin.zip in your twiki installation directory. Content:
      File: Description:
      data/TWiki/RecentVisitorPlugin.txt Plugin topic
      lib/TWiki/Plugins/RecentVisitorPlugin.pm Plugin Perl module
    • Set the ownership of the extracted directories and files to the webserver user.
    • Install the dependencies (if any).

  • Plugin configuration and testing:
    • Run the configure script and enable the plugin in the Plugins section.
    • Configure additional plugin settings in the Extensions section if needed:
      $TWiki::cfg{Plugins}{RecentVisitorPlugin}{Debug} = 0;      # debug flag, 0 or 1
      $TWiki::cfg{Plugins}{RecentVisitorPlugin}{ShowIP} = 0;     # show IP address, 0 or 1
      $TWiki::cfg{Plugins}{RecentVisitorPlugin}{OnlyAdmins} = 0; # show reports to administrators only, 0 or 1
    • Test if the installation was successful: See example above.

Plugin Info

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Show statistics of recent visitors to the TWiki site

Plugin Author: TWiki:Main.PeterThoeny, TWiki.org
Copyright: © 2011-2012 TWiki:Main.PeterThoeny
© 2011-2012 TWiki:TWiki.TWikiContributor
License: GPL (GNU General Public License)
Plugin Version: 2012-11-22
Change History:  
2012-11-22: TWikibug:Item7020: Categorize RECENTVISITOR TWiki Variable; doc enhancements
2011-06-06: TWikibug:Item6725: Plugins: Change global package variables from "use vars" to "our" -- TWiki:Main.PeterThoeny
2011-05-14: TWikibug:Item6701: Small fix in Config.spec -- TWiki:Main.PeterThoeny
2011-05-01: TWikibug:Item6701: Fix small warning issue if plugin is run by a shell script
2011-02-03: TWikibug:Item6646: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.1
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
TWiki:Plugins.Benchmark: GoodStyle nn%, FormattedSearch nn%, RecentVisitorPlugin nn%
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/RecentVisitorPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/RecentVisitorPluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/RecentVisitorPluginAppraisal

Related Topics: VarRECENTVISITOR, TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 RecentVisitorPlugin.md5 r7 r6 r5 r4 r3 manage 0.2 K 2012-11-22 - 08:31 PeterThoeny  
Compressed Zip archivetgz RecentVisitorPlugin.tgz r7 r6 r5 r4 r3 manage 7.2 K 2012-11-22 - 08:31 PeterThoeny  
Compressed Zip archivezip RecentVisitorPlugin.zip r7 r6 r5 r4 r3 manage 10.0 K 2012-11-22 - 08:31 PeterThoeny  
Unknown file formatEXT RecentVisitorPlugin_installer r2 r1 manage 3.5 K 2012-11-22 - 08:31 PeterThoeny  
Edit | Attach | Watch | Print version | History: r9 < r8 < r7 < r6 < r5 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r9 - 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-2016 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.