📖 Documentation
Weblytics Pro — Documentation
Everything you need to install, configure, and get the most out of Weblytics Pro.
Overview
Weblytics Pro is a privacy-first WordPress analytics and SEO toolkit. It consists of five components:
- Core — Shared library used by all other plugins (settings framework, licence check, REST helpers).
- Insights — Traffic analytics: visitors, page views, referrers, devices, browsers, countries, UTM campaigns, landing pages, and events. Tracked server-side with zero frontend JavaScript.
- Finder — SEO keyword tracking: discovers which keywords your pages rank for, monitors position changes, and provides optimisation suggestions.
- Hub — Centralised dashboard that aggregates data from all connected sites. Installed on the Hub server (data.weblyticspro.co.uk).
- Licence Server — Handles licence key generation, validation, and Stripe billing. Runs on the main weblyticspro.co.uk site.
Installation
Requirements
- WordPress 6.4 or later
- PHP 8.1 or later
- MySQL 8.0 / MariaDB 10.6 or later
Step 1 — Install the Core plugin
Upload weblytics-pro-core to your wp-content/plugins/ directory and activate it. This plugin provides shared infrastructure for all other Weblytics Pro plugins.
Step 2 — Install Insights and/or Finder
Upload weblytics-pro-insights and/or weblytics-pro-finder to wp-content/plugins/ and activate them. Each plugin will create its database tables automatically on activation.
Step 3 — Enter your licence key
Go to Weblytics Pro → Settings in your WordPress admin. Enter the licence key you received after purchasing. The key is validated against the Weblytics Pro licence server.
Step 4 — Connect to the Hub
In the same Settings page, enter your Hub URL (https://data.weblyticspro.co.uk) and site API key. This enables real-time data forwarding to the central dashboard.
Hub Setup (for administrators)
The Hub is a separate WordPress installation that runs the weblytics-pro-hub plugin.
- Install WordPress on your Hub server.
- Upload and activate
weblytics-pro-core and weblytics-pro-hub.
- Go to Weblytics Hub → Sites to register client sites.
- For each site, generate an API key and choose which features to enable (Finder, Insights, or both).
- Give the site owner their API key so they can connect.
Insights — Traffic Analytics
Once active, Insights begins tracking immediately. No configuration needed. Data is collected server-side on every page view using PHP — no cookies or JavaScript tracking is used.
What is tracked
| Metric | Description |
|---|
| Visitors | Unique daily visitors based on anonymised IP hashing |
| Page views | Total pages loaded |
| Bounce rate | Percentage of single-page sessions |
| Referrers | Where traffic comes from (Google, social media, direct, etc.) |
| Devices | Desktop, mobile, tablet breakdown |
| Browsers | Chrome, Firefox, Safari, Edge, etc. |
| Countries | Visitor locations based on IP geolocation |
| Landing pages | The first page a visitor sees |
| UTM campaigns | Source, medium, and campaign from URL parameters |
| Events | Custom events (outbound clicks, file downloads, etc.) |
Viewing your data
In your WordPress admin, go to Weblytics Pro → Insights to see your local analytics. To see aggregated data across all sites, log in to the Hub dashboard.
Finder — SEO Keyword Tracking
Finder connects to Google Search Console (via the Weblytics Pro proxy, so no manual API setup is needed) and retrieves keyword ranking data for your site.
- Keyword discovery — See which search queries bring visitors to your site.
- Position tracking — Monitor ranking changes over time.
- Page-level data — See which keywords each page ranks for.
- Recommendations — Get suggestions for improving rankings.
Billing & Licence Keys
Subscriptions are managed via Stripe. After purchasing:
- You receive a licence key by email.
- Enter the key in Weblytics Pro → Settings on each WordPress site.
- The key is validated on each admin page load. If your subscription lapses, you have a 7-day grace period before features are disabled.
To manage your subscription, cancel, or update payment details, use the Stripe customer portal link sent in your confirmation email.
FAQ
Q: Does Weblytics Pro slow down my site?
A: No. There is no frontend JavaScript. Tracking is done server-side in PHP and adds less than 1ms to page load time.
Q: Do I need a cookie consent banner?
A: No. Weblytics Pro does not use cookies, local storage, or any form of client-side tracking. No consent is required under GDPR or PECR.
Q: Can I export my data?
A: Yes. The Hub provides CSV export for all analytics data. You can also query your WordPress database directly since all data is stored in standard tables.
Q: What happens if I cancel?
A: Your data remains in your database. The plugins continue to work in read-only mode (you can view historical data but new tracking stops after the grace period).