SimpleStats by Zacharias Creutznacher
CommunityThe official Filament v5 plugin for SimpleStats.io. View your analytics directly inside your Filament panel: visitors, registrations, revenue, top sources, and top countries.
Author:
Zacharias Creutznacher
Package health
Automated checks of this plugin's Composer package
15 checks
- Failed: GitHub Actions pinned to SHA — View details on Plumb
- Skipped: GitLab CI includes pinned to SHA
- Passed: Open security advisories
- Passed: Dependabot PR responsiveness — No open Dependabot PRs.
- Skipped: Renovate MR responsiveness
- Failed: Dependabot or Renovate configured — No dependency updater configuration found. View details on Plumb
- Skipped: Dependency update cooldown configured
- Failed: Provides a security policy — View details on Plumb
- Passed: Abandoned or archived — No consulted source marks the package abandoned (packagist, github).
- Passed: Commit and release recency — Active: last commit 162 days ago; last release 180 days ago.
-
Failed:
composer.lock not committed by library
—
composer.lockis present in the released dist archive. View details on Plumb - Passed: Dist archive is lean
-
Passed:
Current Laravel version supported
—
Package dependencies resolve together with current Laravel
13.0. -
Passed:
Current PHP version supported
—
Constraint
^8.2supports current PHP8.5. - Skipped: Current Symfony version supported
filament/
namespace. Review the source and install at your own risk. Found
malware or an unresolved security issue the author won't
address?
Report it
.
Documentation
- Requirements
- Installation
- Setup
- Configuration
- Dashboard Widgets
- Self-Hosted
- Testing
- Changelog
- Security Vulnerabilities
- Credits
- License
The official Filament v5 plugin for SimpleStats.io. View your analytics directly inside your Filament panel: visitors, registrations, revenue, top sources, and top countries.

#Requirements
- PHP 8.2+
- Laravel 12+
- Filament 5+
- A SimpleStats.io account with an API token
#Installation
Install via Composer:
composer require simplestats-io/filament-plugin
Optionally publish the config file:
php artisan simplestats-filament:install
Add your API token to .env:
SIMPLESTATS_API_TOKEN=your-api-token-here
#Setup
Register the plugin in your Filament PanelProvider:
use SimpleStatsIo\FilamentPlugin\SimplestatsPlugin;
public function panel(Panel $panel): Panel
{
return $panel
// ...
->plugin(SimplestatsPlugin::make());
}
That's it. Navigate to /admin/simplestats (or your panel path + /simplestats) to see your dashboard.
#Configuration
All configuration is optional. The plugin works out of the box with just an API token.
#Plugin Options
SimplestatsPlugin::make()
->apiToken('custom-token') // defaults to config/env
->apiUrl('https://simplestats.io/api/v1') // defaults to config/env
->cacheTtl(60) // cache duration in seconds
->navigationGroup('Analytics') // Filament nav group
->navigationLabel('Stats') // custom nav label
->navigationSort(5) // nav position
->navigationIcon('heroicon-o-chart-bar-square') // default icon
#Config File
If you published the config, you can set defaults via environment variables:
// config/simplestats-filament.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 and Livewire re-render. Multiple widgets sharing the same filters
| will reuse a single cached response. Set to 0 to disable caching.
|
*/
'cache_ttl' => 60,
];
#Dashboard Widgets
The plugin provides seven widgets on a single dashboard page:
| Widget | Description |
|---|---|
| Stats Overview | KPI cards: Visitors, Registrations, CR, Net Revenue, ARPU, ARPV. Includes sparklines. |
| Visitors & Registrations | Line chart showing visitors and registrations over time. |
| Revenue | Line chart showing gross and net revenue over time. |
| Top Referrers | Horizontal bar chart of top referrers. |
| Top Sources | Horizontal bar chart of top traffic sources. |
| Top Countries | Horizontal bar chart of top visitor countries. |
| Entry Pages | Horizontal bar chart of top landing pages. |
A time range filter lets you switch between presets (Today, Last 7 Days, Last 30 Days, This Year, All Time, etc.).
#Self-Hosted
If you are running a self-hosted SimpleStats instance, point the plugin to your own API:
SimplestatsPlugin::make()
->apiToken(config('simplestats-filament.api_token'))
->apiUrl('https://your-simplestats-instance.com/api/v1')
Or via .env:
SIMPLESTATS_API_URL=https://your-simplestats-instance.com/api/v1
#Testing
composer test
#Changelog
Please see CHANGELOG for more information on what has changed recently.
#Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
#Credits
#License
The MIT License (MIT). Please see License File for more information.
The author
With more than 15 years of experience in PHP full stack development, I am proud to introduce myself as a Laravel Expert! My portfolio is diverse and includes not only challenging projects, but also published packages on GitHub. I also have extensive experience working with Linux and Ansible. My development skills range from statistics tools and payment systems to customised Laravel applications, APIs and various backup solutions. I am also available as a consultant for scalable Laravel applications!
Featured Plugins
A selection of plugins curated by the Filament team
Soft Theme
A theme that gives panels a warm, approachable look with rounded shapes, gentle colors, and serif headings.
Filament
Compact Theme
A theme that makes data-heavy panels easier to scan by fitting more useful information on each screen.
Filament
Spotlight Pro
Browse your Filament Panel with ease. Filament Spotlight Pro adds a Spotlight like Command Palette to your Filament Panel.
Dennis Koch