Filament plugin for Fathom Analytics with a built-in settings page. Automatically injects the Fathom tracking script into all Filament panels and provides a settings page to manage tracking configuration directly from the admin panel.
| Branch | Filament | PHP | Laravel |
|---|---|---|---|
| 1.x | 3.x | ^8.2 | ^11.0 |
| 2.x | 4.x | ^8.2 | ^11.0 |
| 3.x | 5.x | ^8.2 | ^11.0 |
- PHP 8.2 or higher
- Laravel 11.0 or higher
- Filament 5.x
You can install the package via composer:
composer require jeffersongoncalves/filament-fathom:"^3.0"Publish and run the spatie/laravel-settings migrations:
php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="migrations"Publish and run the Fathom settings migrations:
php artisan vendor:publish --tag=fathom-settings-migrations
php artisan migrateRegister the plugin in your Filament PanelProvider:
use JeffersonGoncalves\Filament\Fathom\FathomPlugin;
public function panel(Panel $panel): Panel
{
return $panel
// ...
->plugins([
FathomPlugin::make(),
]);
}The plugin provides a settings page where you can configure:
- Website ID - Your Fathom site ID (e.g. ABCDEFGH)
- Canonical URL - Use canonical URL instead of actual URL for tracking
- Auto Tracking - Automatically track page views on page load
- SPA Mode - Single Page Application tracking mode (auto, history, hash)
- Honor Do Not Track - Respect the browser Do Not Track setting
If you only want the automatic script injection without the settings page:
FathomPlugin::make()->settingsPage(false)composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.