PHPackages simplestats-io/filament-plugin - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Admin Panels](/categories/admin) 4. / 5. simplestats-io/filament-plugin ActiveLibrary[Admin Panels](/categories/admin) simplestats-io/filament-plugin ============================== Filament v5 dashboard plugin for SimpleStats analytics. View your visitors, registrations, and revenue directly in your Filament panel. v1.2.4(2mo ago)4548↑833.3%1MITPHPPHP ^8.2CI passing Since Apr 12Pushed 2mo ago1 watchersCompare [ Source](https://github.com/simplestats-io/filament-plugin)[ Packagist](https://packagist.org/packages/simplestats-io/filament-plugin)[ Docs](https://github.com/simplestats-io/filament-plugin)[ RSS](/packages/simplestats-io-filament-plugin/feed)WikiDiscussions main Synced 3w ago READMEChangelog (7)Dependencies (5)Versions (8)Used By (0) Filament Plugin for SimpleStats.io ================================== [](#filament-plugin-for-simplestatsio) [![Latest Version on Packagist](https://camo.githubusercontent.com/0d66b342a8eedd05ff303131fdb8f002ca514490a5ca26bbb5613b455108091d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73696d706c6573746174732d696f2f66696c616d656e742d706c7567696e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/simplestats-io/filament-plugin)[![Tests](https://github.com/simplestats-io/filament-plugin/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/simplestats-io/filament-plugin/actions/workflows/run-tests.yml)[![Fix PHP code style issues](https://github.com/simplestats-io/filament-plugin/actions/workflows/fix-php-code-style-issues.yml/badge.svg?branch=main)](https://github.com/simplestats-io/filament-plugin/actions/workflows/fix-php-code-style-issues.yml)[![License](https://camo.githubusercontent.com/ae7d3a87e76be0089b22787e9ef8ec852da558a4087fc005015d0b3dc91d4658/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f73696d706c6573746174732d696f2f66696c616d656e742d706c7567696e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/simplestats-io/filament-plugin)[![Laravel Compatibility](https://camo.githubusercontent.com/d9f8bc472c0a4ad489000a63e8790dd33c233ffd02d8562cdd872f4d185e4722/68747470733a2f2f62616467652e6c61726176656c2e636c6f75642f62616467652f73696d706c6573746174732d696f2f66696c616d656e742d706c7567696e)](https://packagist.org/packages/simplestats-io/filament-plugin) The official [Filament v5](https://filamentphp.com) plugin for [SimpleStats.io](https://simplestats.io). View your analytics directly inside your Filament panel: visitors, registrations, revenue, top sources, and top countries. [![screenshot](https://camo.githubusercontent.com/6148b2cede8504c93b5a604a168752eeb8344477d0914760601bda70c94fee3a/68747470733a2f2f73696d706c6573746174732e696f2f696d616765732f73637265656e73686f745f66696c616d656e742e6a7067)](https://camo.githubusercontent.com/6148b2cede8504c93b5a604a168752eeb8344477d0914760601bda70c94fee3a/68747470733a2f2f73696d706c6573746174732e696f2f696d616765732f73637265656e73686f745f66696c616d656e742e6a7067) Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 12+ - Filament 5+ - A SimpleStats.io account with an API token Installation ------------ [](#installation) Install via Composer: ``` composer require simplestats-io/filament-plugin ``` Optionally publish the config file: ``` php artisan vendor:publish --tag="simplestats-filament-config" ``` Add your API token to `.env`: ``` SIMPLESTATS_API_TOKEN=your-api-token-here ``` Setup ----- [](#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 ------------- [](#configuration) All configuration is optional. The plugin works out of the box with just an API token. ### Plugin Options [](#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 [](#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 ----------------- [](#dashboard-widgets) The plugin provides seven widgets on a single dashboard page: WidgetDescription**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 ----------- [](#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 ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Zacharias Creutznacher](https://github.com/sairahcaz) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE) for more information. ### Health Score 45 — FairBetter than 91% of packages Maintenance85 Actively maintained with recent releases Popularity23 Limited adoption so far Community10 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 97% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 7 Last Release 85d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/cf347b32c0d1fceabbcbce7626ad662faa34738396fd9f774231d55370823713?d=identicon)[Sairahcaz](/maintainers/Sairahcaz) --- Top Contributors [![Sairahcaz](https://avatars.githubusercontent.com/u/7384870?v=4)](https://github.com/Sairahcaz "Sairahcaz (32 commits)")[![Pr4w](https://avatars.githubusercontent.com/u/746512?v=4)](https://github.com/Pr4w "Pr4w (1 commits)") --- Tags analyticsfilamentlaraveldashboardanalyticsfilamentsimplestats-iorevenue-attribution ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/simplestats-io-filament-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/simplestats-io-filament-plugin/health.svg)](https://phpackages.com/packages/simplestats-io-filament-plugin) ``` ### Alternatives [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.8k](/packages/rawilk-profile-filament-plugin)[backstage/mails View logged mails and events in a beautiful Filament UI. 16121.5k](/packages/backstage-mails)[stephenjude/filament-jetstream A Laravel starter kit built with Filament inspired by Jetstream. 17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-two-factor-authentication Filament Two Factor Authentication: Google 2FA + Passkey Authentication 84215.9k9](/packages/stephenjude-filament-two-factor-authentication)[marcelweidum/filament-passkeys Use passkeys in your filamentphp app 6649.5k2](/packages/marcelweidum-filament-passkeys)[mradder/filament-logger Audit logging, activity tracking, exports, alerts, and dashboards for Filament admin panels. 2318.8k](/packages/mradder-filament-logger) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)