WassUp Real Time Analytics
WassUp is a WordPress plugin to analyze your visitors traffic with accurate, real-time stats, lots of detailed chronological information, customizable tracking, live views, visitor and pageview counts, top stats, charts, IP geolocation, map, two aside widgets, and a dashboard widget.
Wassup does in-depth visitor tracking and shows you incredible details about your site’s latest hits…more than you can get from almost any other single plugin. It is very useful for SEO and statistics maniacs who want to see accurate, up-to-date stats displayed in a straightforward, easy to understand manner.
The aim of WassUp is the timely knowledge of what your visitors do when they surf your site. It is not intended to show grouped statistics over preset, long-term time periods like visitors per month, pageviews per quarter, and so on (there are many others tools to better gain that, like Google Analytics). WassUp’s flexible, easy-to-read views are the best for learning the details about your visitors’ latest activities. With it’s customizable filters and search capability, you can drill deeply into the data to learn even more about specific visitors, visitor types, etc.
DISCLAIMER: Use at your own risk. No warranty expressed or implied is provided.
WassUp comes with 4 admin screen panels for viewing your visitors’ activities and for customizing those views
There is a fancy “Visitors Details” screen that lets you to see almost everything about your visitors and what they do on your site and that includes search capability, view filters, plus a chart and top stats summary.
There is an ajax “Spy View” screen (like Digg Spy) that lets you monitor your visitors live, with optional geolocation on a Google!maps world map.
There is a “Current Visitors Online” screen that shows a summary of your online visitors in real-time.
There is an “Options” panel with lots of customizable settings for WassUp.
There is a nice Dashboard widget that shows a line chart of hits over time (24 hours default) and a count of current visitors online and their latest activities.
WassUp comes with two useful sidebar Widgets that lets you display your site’s latest data to your visitors
The “Online” widget shows counts of current visitors online and includes options to display logged-in usernames and country flags.
The “Top Stats” widgets lets you display trending or timed top items about your site based on the latest stats. You can list top search engine keywords, top external referrers, top url requests, top articles, top browsers, top OSes, and more.
The widgets are fully customizable.
WassUp’s advanced tracking features can:
Distinguish registered users from anonymous visitors, and administrators from other registered users.
Identify and label new browsers, robots, and feed readers, heuristically.
Track page requests that generate 404 (not found) redirects.
Detect some spiders that pretend to be regular visitors/browsers.
Expose spam and malware activity such as hack attempts, script injection, and xss exploit attempts.
WassUp works with two anti-spam functions to detect and omit (if you want) referrers spammers and comment spammers. It can also detect and omit malware activity such as unauthorized users’ login attempts, script injection, and xss exploit attempts.
For people with database size limitations, WassUp has a few options to manage the database table growth: you can empty it; you can delete old records automatically; and you can set a warning notice for when it exceeds a preset size limit.
WassUp gives a detailed chronology of your hits with a lot of information for each single user session:
ip / hostname
search engines used
SERP (search engine result page)
operating system / language / browser
pages viewed (chronologically and per user session)
complete user agent
name of user logged in
name of comment’s author
spam and hack attempts
Wassup admin console has flexible view filters that show:
records by time period
record count per page
records by entry type (spider, users logged in, comment authors, search engine, referrer)
search by keyword
expand/collapse informations (with ajax support)
usage chart (Google!chart)
top stats lists with aggregate data (top queries, requests, os, browsers)
There are many options to customize how data is tracked and displayed:
Enable/Disable recording (tracking)
Screen refresh frequency (minutes)
Screen resolution (browser width)
User permission levels
Top stats selections
Record or not logged-in users
Record or not spiders and bots
Record or not exploit attempts
Record or not comment spammers
Record or not referrer spammers
registered users to exclude from recording
IP or hostname to exclude from recording
There are tools to monitor and control Wassup’s table growth:
Empty table, manually
Delete old records, manually
Setup automatic delete of old records
Send an e-mail notice when table exceeds a preset size limit
Export table in SQL format
Database and server settings infos.
Wassup is compatible with WordPress 4.0+ and PHP 5.2+
To run Wassup with WordPress 2.2 – 3.9 or with PHP 4.3 – 5.1, you must install the full copy of Wassup with backward-compatibility feature available at http://github.com/michelem09/wassup/
WassUp is incompatible with static html caching plugins such as “WP Super-Cache”
WassUp is NOT a security plugin. It does not block unwanted visitors nor protect your site from malware attempts. You need a separate security plugin for that
For pre-release bugfixes and other changes to WassUp, you can download the development version of Wassup from GitHub:
For the latest browsers, os, and spider detection updates, you can download the
uadetector.class.php module separately on GitHub:
A. If your WordPress setup is up-to-date, you can install this plugin automatically from WordPress admin panel:
Navigate to Plugins >>
Type “WassUp” plugin name in the “Search Plugins” box.
Locate “Wassup Real-Time Analytics” and click
Activate it and you are done!
B. If you prefer to install the plugin manually or you are running an older version of WordPress, download the latest full release of WassUp (Real-Time Analytics) plugin directly from gitHub.com/michelem09/wassup/releases/ and save onto your local computer
If available, use WordPress’
Upload Plugin option in the plugins panel to complete your install:
Navigate to Plugins panel >>
Add New >>
Browse, then find and select the plugin zip file that you downloaded
Activate WassUp plugin and you are done!
Otherwise, unpack the plugin’s zip or gz file with your preferred unzip/untar program or use the command line:
tar xzvf wassup.tar.gz (linux), then follow these steps to complete your install:
Upload the entire “wassup” folder into your
/wp-content/plugins directory on your WordPress host using their Cpanel File manager or an ftp client software
Login to WordPress admin panel and navigate to Plugins page
Activate WassUp plugin and you are done!
Check your current visitors count under WassUp >>Current Visitors Online panel. If your site is busy, STOP! Don’t upgrade. Wait until there are no visitors or follow the “Safe Upgrade Instructions” below.
A. If your WordPress setup is up-to-date, you can upgrade this plugin automatically from WordPress admin panel:
Navigate to “Plugins” page, and under WassUp plugin name, click the
Update Now link.
B. If you prefer to manually upgrade OR you are running an older version of WordPress, follow these instructions:
Deactivate WassUp plugin under WordPress admin panel >>Plugins page
Manually delete the “wassup” folder from your plugins directory (
/wp-content/plugins/) on your WordPress host using their CPanel File manager or with an ftp client software. Do NOT click the
delete link in WordPress.
Click to Download the latest full release of Wassup Real-Time Analytics directly from gitHub.com/michelem09/wassup/releases/ and save onto your local computer.
Then follow the manual install instructions in section B:1-4 above.
**IMPORTANT Safe Upgrade Instructions
To safely upgrade WassUp when your site is busy, you must manually stop visitor recording beforehand, do the upgrade, then manually resume recording afterwards:
In WordPress admin panel, navigate to WassUp >>Options >>[Genernal Setup] tab. Uncheck the box for “Enable statistics recording” and save.
Navigate to Plugins page and click the “Update Now” link under “WassUp” plugin name or follow the manual upgrade instructions above
After the upgrade is done, go back to WassUp >>Options >>[General Setup] tab, and check the box for “Enable statistics recording” and save.
When you activate this plugin (as described in “Installation”), it works “as is”. You don’t have anything to do. Wait for visitors to hit your site and start seeing details (click the dashboard and go to WassUp page)
WassUp is incompatible with the following static page caching plugins: WP Super Cache, WP Cache, WP Fastest Cache, and WP Hyper Cache.
How do I add WassUp’s chart to my admin dashboard?
Check the box for “Enable widget/small chart in admin dashboard” under WassUp >>Options >>[General Setup] tab.
How do I display WassUp widgets on my site?
From the WordPress widgets panel, drag the “WassUp Online” widget or the “Wassup Top Stats” widget from the list of available widgets on the left into your theme’s “Sidebar” or “Footer” area on the right.
How do I view the real-time visitor geolocation map in WassUp?
Check the box for “Display a GEO IP Map in spy visitors view” under WassUp >>Options >>[General Setup] and save, then navigate to WassUp >>SPY Visitors panel to see the map.
The map has vanished and I get a message like: “Oops, something went wrong” or “Google has disabled use of the Maps API for this application”. How do I fix this?”
Try upgrading to the latest version of Wassup, or go to Wassup-Options and click the Reset-to-Default button if you have already upgraded, or sign up for your own Google!Maps API key from Google’s API console then enter the key in the indicated field under Wassup >>Options >>General Settings tab.
How do I exclude a visitor from being recorded?
Navigate to WassUp >>Options >>[Filters & Exclusions] tab and enter a visitor’s username, IP address, or hostname into the appropriate field and save.
How do I stop (temporarily) WassUp from recording new visits on my site?
Uncheck the box for “Enable statistics recording” under WassUp >>Options >>[General Setup] tab.
My popular web site is hosted on a shared server with restrictive database size limits. How do I prevent WassUp’s table from growing too big for my allocated quota?
Navigate to Wassup >> Options >> [Manage Files & Data] tab and enable the setting for “Auto Delete” of old records and/or check the box to receive an email alert when the table size limit is exceeded.
WassUp visitor counts are much lower than actual for my website. Why is there a discrepancy and how do I fix it?
How do I upgrade WassUp safely when my site has frequent visitors?
Read the “IMPORTANT safe upgrade instructions” in the installation section of this plugin’s README.txt file.
An unspecified error occurred during plugin upgrade. What do I do next?
Wait a few minutes. Do NOT re-attempt upgrade nor try to activate the plugin again! An activation error with no explanation is probably due to your browser timing out, not an upgrade failure. WassUp continues it’s upgrade in the background and will activate automatically when it is done. After a few minutes (5-10) has passed, revisit WordPress admin “Plugins” panel and verify that Wassup plugin has activated.
How do I uninstall WassUp cleanly?
Answer #1: From a single WordPress site: navigate to WordPress Plugins panel and deactivate WassUp plugin. Then, on the same page, click the “delete” link below WassUp name. This deletes both data and files permanently.
Answer #2: From WordPress multisite Network admin panel: navigate to “Plugins” panel and deactivate WassUp plugin. If Wassup is not “network activated”, navigate to the main site/parent domain “Plugins” panel and deactivate Wassup plugin there, then return to the Network admin’s “Plugins” panel. Click the “delete” link below WassUp name. This deletes both data and files permanently from all subsites in the multisite network.
Answer #3: From a subsite in WordPress multisite: navigate to WassUp >>Options >>[Uninstall] tab and check the box for “Permanently remove WassUp data and settings” and save. Next, go to the subsite’s Plugins panel and deactivate WassUp plugin. This deletes the subsite’s data permanently. No files are deleted (not needed).
Answer #4: From a WordPress 2.x site: navigate to WassUp >>Options >>[Uninstall] tab and check the box for “Permanently remove WassUp data and settings” and save. Next, go to WordPress “Plugins” panel and deactivate WassUp plugin. This deletes the data permanently. To delete the plugin files from WordPress 2.x, use an ftp client software on your PC or login to your host server’s “cpanel” and use “File Manager” to delete the folder “wassup” from the
/wp-content/plugins/ directory on your host server.
Visit Plugin Forum to find more answers to your WassUp questions.