Installation

Installation

Rich Statistics requires WordPress 6.0 or higher and PHP 8.0 or higher. It works on single-site and multisite installations.

Option 1 — WordPress.org plugin directory

1. In your WordPress admin, go to Plugins → Add New.
2. Search for Rich Statistics.
3. Click Install Now, then Activate.

Or install from the command line via WP-CLI:

wp plugin install rich-statistics --activate

This is the recommended installation method.

Option 2 — Manual upload

Download the ZIP from the WordPress.org plugin page and upload it via Plugins → Add New → Upload Plugin.

System Requirements

Requirement	Minimum	Recommended
WordPress	6.0	Latest
PHP	8.0	8.2+
MySQL / MariaDB	MySQL 5.7 / MariaDB 10.3	MySQL 8.0+
Browser (admin)	Any modern browser	Chrome/Firefox/Edge latest

Database tables

On activation, the plugin creates five tables in your WordPress database (using $wpdb->prefix, e.g. wp_rsa_events on a standard install, or wp_2_rsa_events for subsite 2 on multisite):

Table	Purpose
rsa_events	One row per accepted pageview — page path, referrer domain, browser, OS, language, timezone, viewport, time on page, UTM parameters
rsa_sessions	Session-level data — entry/exit page, session UUID (tab-scoped only), session start/end timestamps, cumulative time on page
rsa_clicks	Individual click events with coordinates, element info, session ID, and timestamp (heatmap and click tracking — Premium)
rsa_heatmap	Daily-aggregated click coordinate buckets for the heatmap overlay (percentage x/y, page path, date — Premium)
rsa_wc_events	WooCommerce interaction events — product_view, add_to_cart, order_complete with product IDs, quantities, order totals (Premium)

All tables are dropped cleanly on plugin uninstall if the Remove data on uninstall option is checked in Rich Statistics → Preferences.

Consent banner

Starting with v2.4.27, you can optionally display a consent banner to visitors. To enable it:

1. Go to Rich Statistics → Preferences → Consent Banner.
2. Check Enable consent banner.
3. Customize the banner text, colors, and border radius to match your site.
4. Choose whether to Auto-consent (pre-check all categories for first-time visitors).

The banner supports three tracking categories: Analytics (pageviews, referrers, campaigns), Behavior (clicks, heatmaps), and Technical. Visitors can Accept, Reject, or Customize their choices. A persistent Privacy Settings button remains visible so visitors can change their preferences at any time.

Multisite notes

When network-activated, a network admin menu item appears under Network Admin → Analytics. A network administrator can disable tracking on any sub-site from that screen. Each sub-site's data is stored with its blog ID so network-wide and per-site reports are both available.

Upgrading to Premium

There is no separate premium ZIP to install. The upgrade happens as a standard WordPress plugin update:

1. In your WordPress admin, go to Rich Statistics → Upgrade (added by the Freemius SDK).

2. Click Upgrade to Premium. You are taken to a Freemius-hosted checkout page.

3. Complete the purchase. Your license activates automatically on your site.

4. A standard WordPress update notification appears. Click Update Now.

5. Premium features are now active — no re-installation, no ZIP download.

   License management: Go to Rich Statistics → Account (the Freemius account menu) to view your license status, deactivate to move it to another site, or cancel. Each license covers one production site.

   Freemius opt-in on first activation. The Freemius SDK makes outbound requests to api.freemius.com on first activation to power its opt-in screen and license verification. This is standard behavior for all Freemius-powered plugins. You can skip the opt-in — it does not affect plugin functionality.