The official Statamic v6 addon for SimpleStats.io. View your analytics directly inside the Statamic Control Panel: visitors, registrations, revenue, top referrers, top sources, and top countries.
- PHP 8.2+
- Statamic 6+
- A SimpleStats.io account with an API token
Install via Composer:
composer require simplestats-io/statamic-addonOptionally publish the config file:
php artisan vendor:publish --tag="simplestats-config"Add your API token to .env:
SIMPLESTATS_API_TOKEN=your-api-token-hereThat's it. A new SimpleStats entry appears under the Tools section of the Control Panel navigation. Open it to see your dashboard.
All configuration is optional. The addon works out of the box with just an API token.
If you published the config, you can override the defaults via environment variables:
// config/simplestats.php
return [
/*
|--------------------------------------------------------------------------
| SimpleStats API Credentials
|--------------------------------------------------------------------------
|
| Define your API credentials here. The API URL defaults to the hosted
| SimpleStats instance. If you are self-hosting, change it to your own
| URL. The API token is the same one used by the Laravel client package.
|
*/
'api_url' => env('SIMPLESTATS_API_URL', 'https://simplestats.io/api/v1'),
'api_token' => env('SIMPLESTATS_API_TOKEN'),
/*
|--------------------------------------------------------------------------
| Cache Duration
|--------------------------------------------------------------------------
|
| API responses are cached to avoid unnecessary requests on every page
| load. Multiple widgets sharing the same filters will reuse a single
| cached response. Set to 0 to disable caching.
|
*/
'cache_ttl' => 60,
];The addon provides a dedicated dashboard page in the Control Panel:
| Widget | Description |
|---|---|
| Stats Overview | KPI cards: Visitors, Registrations, CR, Net Revenue, ARPU, ARPV. |
| Visitors & Registrations | Line chart showing visitors and registrations over time. |
| Revenue | Line chart showing gross and net revenue over time. |
| Top Referrers | Table of top referrers with visitors, registrations, CR, DAU, and revenue. |
| Top Sources | Top traffic sources by UTM. |
| Top Countries | Top visitor countries. |
| Entry Pages | Top landing pages. |
A time range filter lets you switch between presets (Today, Last 7 Days, Last 30 Days, This Year, All Time, etc.).
If you are running a self-hosted SimpleStats instance, point the addon to your own API via .env:
SIMPLESTATS_API_URL=https://your-simplestats-instance.com/api/v1
SIMPLESTATS_API_TOKEN=your-api-token-herecomposer testPlease see CHANGELOG for more information on what has changed recently.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.
