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 page 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
= Plugin Home =
- 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.phpmodule 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 Pluginoption in the plugins panel to complete your install:
- Navigate to Plugins panel >>
Browse, then find and select the plugin zip file that you downloaded
- Activate WassUp plugin and you are done!
- Navigate to Plugins panel >>
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/pluginsdirectory 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!
- Upload the entire “wassup” folder into your
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
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
deletelink in WordPress.
- 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] 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.
- My WordPress theme is not widget ready. Is it possible to display WassUp widget on my site?
Yes. Insert the template tag
wassup_sidebar()into your theme’s “sidebar.php” file to display Wassup widgets as a single combined widget on your site.
- 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] tab and save, then navigate to WassUp >>SPY Visitors panel to see the map.
- Can Wassup record visits on a web site that is not WordPress?
No. Wassup is a WordPress-only plugin and requires at least WordPress 2.2 to work.
- 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 text area for that “Recording Exclusion” type.
- 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.
- In WordPress multisite, how do I stop (temporarily) WassUp from recording new visitors on all sites in the network?
Answer #1: If plugin is “network activated”, login as network admin, go to the Network admin dashboard, navigate to WassUp >>Options >>[General Setup] tab and uncheck the box for “Enable Statistics Recording for network” and save.
Answer #2: If plugin is NOT “network activated”, login as network admin, go to the main site/parent domain admin dashboard, navigate to WassUp >>Options >>[General Setup] tab, then uncheck the box for “Enable Statistics Recording for network” and save.
- No data is displayed; or the “Visitor Details” panel show 0 records for the last 24 hours. How do I fix this?
Answer #1: Check the box for “Enable statistics recording” setting under WassUp >>Options >>[General Setup] tab and save.
Answer #2: Click the [Reset to Default] button under WassUp >>Options >>[General Setup] tab.
Answer #3: Navigate to WassUp >>Options >>[Manage File & Data] tab and uncheck the “MySQL Delayed Insert” setting and save.
Answer #4: Deactivate and Re-activate Wassup from WordPress plugins panel.
- 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?
- Is there any caching plugin that works with WassUp?
WP Widget Cache is the only caching plugin verified to work with WassUp.
- Why does WassUp stats sometimes show more page views than actual pages clicked by a person?
“Phantom” page views can occur when a user’s browser does automatic feed retrieval, link pre-fetching, a page refresh, or automatically adds your website to it’s “Top sites” window (Safari). WassUp tracks these because they are valid requests from the browser and are sometimes indistinguishable from user link clicks.
- 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.
thank you for this plugin
Tracking more visitors then most popular trackers.
Thanks for your work!
I had the same problem as others here, that the plugin stopped working with never wordpress versions.
I found in one of the other comments here that the author suggested, to delete and reinstall the plugin. THIS HELPED! Now it is working again.
I like this plugin, because it is a very lightweight statistic.
I had been us this plugin since six years on my earlier beginning with wordpress .
I only say many thanks to all plugin authors .
Yerinde, uyarılarıyla da(muhtemel hack teşebbüsü vs) pratik bir eklenti.
The plugin no longer works, no longer collects data, etc.
Shame, it was useful for seeing the bigger trend of visitors.
Contributors & Developers
“WassUp Real Time Analytics” is open source software. The following people have contributed to this plugin.Contributors
Interested in development?
- fixed an ‘unknown modifier’ preg_match error in ‘wassup.php’ module.
- fixed an IP validation loophole that could cause invalid/malformed forwarding IPs in client’s http_header to be stored as client IP.
- fixed code to stop recording of front-end ajax requests (‘/wp-admin/admin-ajax.php’ url) as “possible spam/malware” hits.
- updated code to restore ‘shutdown’ hook as the primary hook for ‘wassupAppend’ function.
- updated translation script to re-attempt language load with “language x2” as filename whenever the initial load (with “locale”) fails.
- updated translation template and language files to v1.9.2
- miscellaneous minor changes.
Urgent bugfix upgrade
- fixed fatal error on
wassup_options::is_recording_activethat occurred in some configurations
- fixed erroneous ‘hack attempt’ labels that occurred on sites without permalinks
- fixed a refresh timer bug that disabled dropdown selections in Visitor Details when refresh setting is 0.
- fixed a debug_mode bug that caused error notices to show as output for Wassup ajax action
- new functions(2) to reset error display in debug_mode
- improved spider detection.
- updated “compatibility.php” module for multisite compatibility tests
- miscellaneous minor bug fixes
- miscellaneous minor code changes.
Critical security, compatibility, and bugfix upgrade
- patched security loopholes (xss vulnerability) in the ‘Top stats’ widget and in
wassupURI::add_siteurlmethod (in Visitor Details/Online)
- improved security against xss attacks on interface and widgets.
- improved compliance with the latest WordPress.org plugin repository guidelines.
- improved browser/os detection.
- new module, ‘wassupadmin.php’ for WassUp admin panels and dashboard widget
- new module, ‘compatibility.php’ to check for WordPress and PHP compatibility and to load compatibility modules from
/lib/compat-lib/subfolder when available
- removed backward compatibility modules (‘/lib/compat-lib/’) and features from WordPress repository.
Wassup’s backward-compatibility feature remains in the full copy of Wassup available at http://github.com/michelem09/wassup/
- updated Google!Maps API link to use a common API key for Wassup-Spy (required by Google since 2016-06-22).
- updated WassUp ‘wp-cron’ scheduled tasks to terminate (and restart) at reset-to-default, recording stop/start, and at plugin deactivate/reactivate events.
- updated Wassup table export to omit all known spam/malware records from export by default…to avoid propagation of malware code when exported records are imported into other applications.
- updated translation template, ‘wassup.pot’.
- fixed problem with login page hits not being recorded.
- fixed errors caused by disabled ‘set_time_limit’ function in some configurations.
- miscellaneous bugfixes.
- miscellaneous text changes
- minor css changes for small screen devices.
Important compatibility and feature improvement upgrade
- improved MySQL performance and table management
- improved tracking filters.
- improved security with more input validation, deprecated function removal and escaped output.
- new multisite network capability.
- new multi-widget capability in widgets.
- new “FAQ” and “Donate” panels in Wassup-Options submenu
- new “top stats” popup-window in Visitor Details panel
- updated code for WordPress 4/PHP 5.6-mysqli compatibility
- updated css and validated as 100% W3C CSS3 compliant
- updated browser and os detection for new agents (Win10)
- updated translation template (wassup.pot)
- updated “readme.txt”
- 3 new classes added to code:
wassupDbfor MySQL table operations and caching,
wassupURIto format and clean urls/links for safe output, and
Wassup_Widgeta base widget for building Wassup widgets
- miscellaneous minor text changes
- miscellaneous minor bugfixes
- Removed deprecated WordPress methods, minor text changes.
- Changes to GEOIP API for Map geolocation, minor CSS changes.
- Migrated to Google Maps API v3
- New locales: English (United Kingdom) [complete], Persian [partial], Sinhalese [partial], Vietnamese [partial]
- New donate button in WassUp menu
- fixed CSS for WassUp menu.
- Security fix for xss attempts via useragent string.
- bugfixes, improved tracking, changes for WordPress compatibility.
- bugfixes, improved browser/agent detection.
- bugfix and minor changes.
Important feature improvement upgrade
- new table
wassup_metafor caching and stats collection.
- new admin interface style.
- new GEOIP API freegeoip.net for map geolocation in SPY view. Thanks to @AlexandreFiori for giving us access to his API.
- bugfixes, security fixes, and changes for WordPress compatibility.
- fixed a security loophole found in main.php module.
- new clickable refresh timer in “Visitor Details” submenu.
- initial sample record added to WassUp table for new installs.
- improved browser, OS, and search engine detection.
- more language translations added.