Enable you to display how many users are online on your WordPress blog with detailed statistics.
PHP JavaScript
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
scb @ 95b23ac
.gitmodules
.travis.yml
README.md
admin.php
bots.php
core.php
deprecated.php
template-tags.php
uninstall.php
useronline.dev.js
useronline.js
widget.php
wp-stats.php
wp-useronline.php

README.md

WP-UserOnline

Contributors: GamerZ, scribu
Donate link: http://lesterchan.net/site/donation/
Tags: useronline, usersonline, wp-useronline, online, users, user, ajax, widget
Requires at least: 4.0
Tested up to: 4.7
Stable tag: 2.87.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Enable you to display how many users are online on your Wordpress blog with detailed statistics.

Description

This plugin enables you to display how many users are online on your Wordpress site, with detailed statistics of where they are and who they are (Members/Guests/Search Bots).

Usage (With Widget)

  1. Go to WP-Admin -> Appearance -> Widgets
  2. The widget name is UserOnline.
  3. Scroll down for instructions on how to create a UserOnline Page.

Usage (Without Widget)

  • Open wp-content/themes/<YOUR THEME NAME>/sidebar.php and add Anywhere:
<?php if (function_exists('users_online')): ?>
	<p>Users online: <div id="useronline-count"><?php users_online(); ?></div></p>
<?php endif; ?>

Build Status

Build Status

Development

https://github.com/lesterchan/wp-useronline

Credits

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, I will really appreciate it. If not feel free to use it without any obligations.

Screenshots

  1. Admin - Dashboard's Right Now
  2. UserOnline Page
  3. Admin - Settings Page

Frequently Asked Questions

Creating A UserOnline Page

  1. Go to WP-Admin -> Pages -> Add New
  2. Type any title you like in the post's title area
  3. If you ARE using nice permalinks, after typing the title, WordPress will generate the permalink to the page. You will see an 'Edit' link just beside the permalink.
  4. Click 'Edit' and type in useronline in the text field and click 'Save'.
  5. Type [page_useronline] in the post's content area
  6. Click 'Publish'

If you ARE NOT using nice permalinks, you need to go to WP-Admin -> Settings -> 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_users_online')): ?>
   <p>Most Users Ever Online Is <?php echo get_most_users_online(); ?> On <?php echo get_most_users_online_date(); ?></p>
<?php endif; ?>

To Display Users Browsing Site

  • Use:
<?php if (function_exists('get_users_browsing_site')): ?>
   <div id="useronline-browsing-site"><?php echo 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 echo get_users_browsing_page(); ?></div>
<?php endif; ?>

Error on activation: "Parse error: syntax error, unexpected..."

Make sure your host is running PHP 5. The only foolproof way to do this is to add this line to wp-config.php (after the opening <?php tag):

var_dump(PHP_VERSION);

Changelog

2.87.1

  • NEW: Bump to 4.7
  • NEW: New useronline_custom_template filter

2.87

  • NEW: Remove po/mo files from the plugin
  • NEW: Use translate.wordpress.org to translate the plugin
  • FIXED: Update SCB Framework
  • FIXED: Incompatible scbAdminPage::validate()

2.86

  • FIXED: Notices in Widget Constructor for WordPress 4.3

2.85

  • NEW: Uses WordPress native uninstall.php

2.84

  • NEW: Bump to 4.0

2.83

  • Show user agent when hovering over IP, instead of address lookup
  • Use local time for UserOnline Page
  • Fixed 'Strict Standards: Non-static method' warnings
  • Update scb Framework

2.82

  • show most recent visitors first
  • fix duplicate entry errors
  • fix ajax requests for SSL

2.81

  • fixed settings page
  • fixed "Return to default" buttons
  • show user list in admin only to users with 'manage_options' capability
  • added 'useronline_bots' filter

2.80

  • don't show url and referral links for users in the admin area
  • smarter detection via ajax requests
  • fix SQL errors

2.72

  • fix fatal error on upgrade

2.71

  • fix %USERONLINE_COUNT% problem

2.70

  • added option to link user names to their author page
  • allow displaying online users from a different page than the current page
  • bundle language files
  • more info

2.62 (2010-03-07)

  • fix integration with WP-Stats
  • fix error with get_admin_page_title()