Analytics
The Analytics dashboard provides insight into licence trends, site activity, and product adoption over time. Use it to monitor growth, identify churn, and understand which products and versions your customers are running.
Prerequisite
Analytics tracking must be enabled. Navigate to LicenceForge > Settings and confirm that the wplf_analytics_enabled option is turned on. When disabled, no new data points are recorded, but existing data remains accessible.
Period Selector
A toggle at the top of the analytics screen lets you choose the reporting window. All stat cards and charts update to reflect the selected period.
| Period | Description |
|---|---|
| 7 days | Last 7 calendar days. Useful for spotting short-term anomalies. |
| 30 days (default) | Last 30 calendar days. The default view on page load. |
| 90 days | Last 90 calendar days. Best for identifying longer-term trends. |
Stat Cards
Four summary cards are shown at the top of the analytics screen. Each card displays the current value alongside the percentage change compared to the previous equivalent period.
| Card | Description |
|---|---|
| Active Licences | Total licences with a status of active at the end of the selected period. |
| Trials | Licences currently in a trial state. |
| Expired | Licences that transitioned to expired within the selected period. |
| Churn Rate % | Percentage of licences lost (expired, revoked, or refunded) relative to the active count at the start of the period. |
Charts
Two time-series charts are rendered below the stat cards.
New Licences Over Time
A bar or line chart plotting the number of newly created licences per day across the selected period. Hover over any data point to see the exact count and date.
Daily Active Sites
A line chart showing the number of unique sites that performed at least one licence validation per day. This metric reflects real-world usage rather than just licence counts.
Top Products Table
Below the charts, a table ranks your products by activity within the selected period.
| Column | Description |
|---|---|
| Product Name | The product's display name, linked to its product edit screen. |
| Active | Number of active licences for this product. |
| Trial | Number of trial licences for this product. |
| Total | Sum of all licence statuses (active, trial, expired, revoked). |
Version Distribution
The version distribution panel shows which versions of a product are currently in use across activated sites.
- Select a product from the dropdown at the top of the panel.
- A breakdown chart displays each version number and the percentage of active sites running it.
This is particularly useful when planning staggered rollouts or deciding when to drop support for an older version.
Version data source
Version numbers are reported by the client plugin during licence validation. If a site has not validated recently, its version data may be stale.
Data Retention
Analytics data is retained for 365 days. Records older than this threshold are automatically purged by the wplf_cleanup_analytics routine, which runs as part of the daily maintenance cron.
Storage impact
On high-traffic installations, analytics tables can grow substantially. If database size is a concern, consider reducing the query period or ensuring the maintenance cron is running correctly.
Configuration
Analytics behaviour is controlled by a single setting:
| Setting | Default | Description |
|---|---|---|
wplf_analytics_enabled |
true |
When enabled, every licence validation and activation event is recorded for analytics. Disabling this stops new data collection but does not delete existing records. |