Author:
» Lester 'GaMerZ' Chan

EMail:
»

Website:
» http://www.lesterchan.net/

Features:
» Enable you to display how many users are online on your Wordpress blog with detailed statistics of where they are and who there are(Members/Guests/Search Bots).

Download:
» WP-UserOnline 2.10 For WordPress 2.1.x
» WP-UserOnline 2.06 For WordPress 2.0.x
» WP-UserOnline 1.00 For WordPress 1.5.2

Demo:
» http://www.lesterchan.net/wordpress/useronline/

Development:
» http://dev.wp-plugins.org/browser/wp-useronline/

Translations:
» http://dev.wp-plugins.org/browser/wp-useronline/i18n/

Support Forums:
» http://forums.lesterchan.net/index.php?board=21.0

Updated:
» 1st February 2007

Note:
» The Changelog, Installation, Upgrade, Usage Tab at the top of the page.

Donations:
» I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks as my school allowance, I will really appericiate it. If not feel free to use it without any obligations. Thank You. My Paypal account is

• Version 2.10 (01-02-2007)
  • NEW: Works For WordPress 2.1 Only
  • NEW: Renamed useronline-js.js to useronline-js.php To Enable PHP Parsing
• Version 2.06 (02-01-2007)
  • NEW: useronline.php Now Handles The AJAX Processing Instead Of index.php
  • NEW: Localize WP-UserOnline
  • FIXED: JavaScript onLoad Function Conflict By zeug
  • FIXED: AJAX Not Working On Servers Running On PHP CGI
  • FIXED: IP2Nation Will Now Work Whether Or Not WP-Stats Is Activated
• Version 2.05 (01-10-2006)
  • NEW: UserOnline Is Now Embedded Into A Page, And Hence No More Integrating Of UserOnline Page (Removed wp-useronline.php)
  • NEW: Changed In WP-UserOnline Structure: Members Mean Registered Users and Guests Mean Comment Authors
  • NEW: get_users_browsing_site(false) And get_users_browsing_page(false) Will Now Return An Array Containing Total Users, Total Members, Total Guests and Total Bots Online
  • NEW: Added Widget Title Option To WP-UserOnline Widget
  • FIXED: Invalid IP Error
  • FIXED: If Site URL Doesn't Match WP Option's Site URL, WP-UserOnline Will Not Work
• Version 2.04 (01-07-2006)
  • NEW: AJAX Is Now Used For Updating Users Online Every 1 Minute Without Refreshing The Page
  • NEW: You Can Now Place Users Online Count And Users Browsing Site Data On The Sidebar As A Widget
  • NEW: UserOnline Options Panel And The Code That WP-UserOnline Generated Is XHTML 1.0 Transitional
  • NEW: Added Useronline Options In WP Administration Panel Under 'Options -> Useronline'
  • NEW: If You Have ip2nation Plugin Installed, The User's/Guest's Country Flag Will Be Displayed
• Version 2.03 (01-04-2006)
  • NEW: Added get_users_browsing_site(); To Display Users Browsing The Site
  • FIXED: wp-stats.php Link
  • FIXED: Some Grammer Errors, Credit To xclouds (http://www.xclouds.com/)
• Version 2.02 (01-03-2006)
  • NEW: No More Install/Upgrade File, It Will Install/Upgrade When You Activate The Plugin.
  • FIXED: IP 'Unknown' Error, Credit To Brian Layman (http://www.knitchat.com/)
  • FIXED: ON DUPLICATE KEY Error, Credit To Brian Layman (http://www.knitchat.com/)
  • FIXED: DUPLICATE KEY Error By Using DELETE First, Credit To Jody Cairns (http://steelwhitetable.org/blog/)
• Version 2.01 (01-02-2006)
  • NEW: Added Users Browsing Page
  • NEW: Added Most Users Ever Online
  • FIXED: Added UNIQUE Key Instead Of Primary Key To Test Whether It Will Solve Duplicate Entry Errors
  • FIXED: Quotes Issue In Page Title
• Version 2.00 (01-01-2006)
  • NEW: Compatible With Only WordPress 2.0
  • NEW: Better Installer
  • NEW: GPL License Added
  • NEW: Page Title Added To wp-useronline.php
  • NEW: Added Extra Bots, Credit To Greg Perry (http://www.gregrperry.com/)
  • FIXED: Cleaner Codes

1. Open wp-content/plugins Folder
2. Put:

   Folder: useronline

3. Activate WP-UserOnline Plugin
4. Refer To Usage For Further Instructions

1. Deactivate WP-UserOnline Plugin
2. Open wp-content/plugins Folder
3. Put/Overwrite:

   Folder: useronline

4. Delete these file if exists:

   File: wp-useronline.php
   File: wp-content/plugins/useronline.php
   File: wp-content/plugins/useronline/wp-useronline.php
   File: wp-content/plugins/useronline/useronline-js.js

5. Activate WP-UserOnline Plugin
6. Refer To Usage For Further Instructions

1. Open wp-content/themes/<YOUR THEME NAME>/sidebar.php
2. Add Anywhere:

   <?php if (function_exists('useronline')): ?>
      <li>
         <h2>UserOnline</h2>
         <ul>
            <li><div id="useronline-count"><?php get_useronline(); ?></div></li>
         </ul>
      </li>
   <?php endif; ?>

1. Activate WP-UserOnline Widget Plugin
2. Go to 'WP-Admin -> Presentation -> Sidebar Widgets'
3. Drag the UserOnline Widget to your sidebar
4. You can configure the UserOnline Widget by clicking on the configure icon
5. Click 'Save changes'
6. Scroll down for instructions on how to create a UserOnline Page.

1. Go to 'WP-Admin -> Write -> Write Page'
2. Type any title you like in the post's title area
3. Type '[page_useronline]' in the post's content area (without the quotes)
4. Type 'useronline' in the post's slug area (without the quotes)
5. Click 'Publish'
6. If you ARE NOT using nice permalinks, you need to go to 'WP-Admin -> Options -> Useronline' and under 'UserOnline URL', you need to fill in the URL to the UserOnline Page you created above.

• To Display Most Number Of Users Online
• Use:

  <?php if (function_exists('get_most_useronline')): ?>
     <p>Most Users Ever Online Is <?php get_most_useronline(); ?> On <?php get_most_useronline_date(); ?></p>
  <?php endif; ?>

• To Display Users Browsing Site
• Use:

  <?php if (function_exists('get_users_browsing_site')): ?>
     <div id="useronline-browsing-site"><?php get_users_browsing_site(); ?></div>
  <?php endif; ?>

• To Display Users Browsing A Page
• Use:

  <?php if (function_exists('get_users_browsing_page')): ?>
     <div id="useronline-browsing-page"><?php get_users_browsing_page(); ?></div>
  <?php endif; ?>