Author
» Lester 'GaMerZ' Chan

EMail:
»

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

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

Documentation:
» http://dev.wp-plugins.org/wiki/wp-useronline

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

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

Updated:
» 2nd January 2007

Note:
» I have localize WP-UserOnline, if there is any bug or some text is not translated properly, please contact me immediately.

• 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 Root WordPress Folder
3. Delete file if exists:

   File: wp-useronline.php

4. Open wp-content/plugins Folder
5. Put:

   Folder: useronline

6. Delete file if exists:

   File: useronline.php

7. Open wp-content/plugins/useronline Folder
8. Delete file if exists:

   File: wp-useronline.php

9. Activate WP-UserOnline Plugin
10. 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.

• The AJAX feature might not work if your blog homepage directory is different from the directory you installed WordPress in. To solve this issue,
  1. Open useronline.php
  2. Find:

     echo "\t".'var useronline_ajax_url = \''.$useronline_ajax_url.'/wp-content/plugins/useronline/useronline.php\';'."\n";

  3. Replace:

     echo "\t".'var useronline_ajax_url = \''.$useronline_ajax_url.'/WORDPRESS_DIRECTORY/wp-content/plugins/useronline/useronline.php\';'."\n";

     Where WORDPRESS_DIRECTORY should be the directory name which you installed WordPress in. Note the backslash after your WordPress Directory, you need that.

• 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; ?>