Version: 1.0, 26 September 2005
Prerequisites: Requires
UserAuth; last tested on PmWiki version: 2.0.beta54
Status:
NOTE: This script is the light version of PresenceAwareness
Question answered by this recipe
Can I see who is online on my wiki and what it's doing?
Answer
Yes with this plugin, you can.
Notes
Description
- This script enables your wiki to see who is online, it use XAJAX a PHP class that implement AJAX in an easy way
- Not logged visitors, was shown in users list with their IP address, logged users with Username.
Installation
- First of all, download and install UserAuth user-based authentication plugin;
- Now download and install presence-light-v1.0.tar.gz;Δ
- Include the plugin from your config.php file, after UserAuth include: require_once("cookbook/presence-list.php");
- Load your PmWiki once to create the default .onlineusers file
The .onlineusers file is stored in the "local" directory. On Unix-like systems this directory needs to be owned by the web server user for the users file to be automatically created.
- (:xajax:) is the markup to see the online users list, put it somewhere in your pages, I suggest Sidebar;
Download
presence-light provides:
cookbook/presence-list.php
cookbook/presence/class.userslist.php
cookbook/presence/xajax.inc.php
cookbook/presence/presence.css
Releases
- September 26, 2005 - Version 1.0
Comments
- 2005-11-17 - causes a javascript error: 'document.body' is null or not an object on line 41 char 284
tested on PmWiki 2.0.12
Blues November 17, 2005, at 09:38 AM
- 2006-04-09 - doesn't validate as XHTML 1.1: I've changed presence-list.php, line 24:
from "\n<script type="text/javascript"> to "\n<script type=\"text/javascript\">
to validate.
aleppax AT aleppax.it April 9, 2006
- 2006-07-22 - now it's validate as XHTML. THX for you comment, but I just found some Java Script bugs. I'am not experienced enough to correct the bugs but AFAIK it should be corrected in the released v1.1 of PresenceAwareness It could be helpful to get a modified PresenceAwarenessLight version as well, because IE shows errors and also in Firefox JavaScript Console.
Holger July 21, 2006, at 06:25 PM
- 2007-03-13 - Any way to get this working with the built-in AuthUser instead of UserAuth?
Lordmundi March 23, 2007
- 2007-05-24 - Please keep the functionality to work with UserAuth2 and maybe add support for AuthUser?
IchBin May 23, 2007, at 11:39 PM
See Also
- PresenceAwareness - Full version of this plugin
- UserAuth - User-based authentication
- WhosWhere - Keep track of and display Who's Where and what they're doing on your site.
F.A.Q.
- Q: Why don't I see online users? I have installed all the plugins!
- A: Probably presence-list.php cannot create ".onlineusers" file in the "local" directory.
You can create this file and set it to be writable.
- Q: May it be that the client browser must be capable of (successfully) executing javascript for the client to be noticed by the module? With my IE5.0 there are js errors and the client is not detected! (PmWiki 2.1.beta25, presence-light v1.0) ThomasP
User notes? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.
