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 four 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
rsa_sessions	Session-level data — entry page, session UUID (tab-scoped only), session start/end timestamps
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)

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

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.