#Filament Fathom

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.

#Version Compatibility

#Requirements

• PHP 8.2 or higher
• Laravel 11.0 or higher
• Filament 5.x

#Installation

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 migrate

Register the plugin in your Filament PanelProvider:

use JeffersonGoncalves\Filament\Fathom\FathomPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([
            FathomPlugin::make(),
        ]);
}

#Settings Page

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

#Disabling the Settings Page

If you only want the automatic script injection without the settings page:

FathomPlugin::make()->settingsPage(false)

#Testing

composer test

#Changelog

Please see CHANGELOG for more information on what has changed recently.

#Contributing

Please see CONTRIBUTING for details.

#Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

#Credits

• Jefferson Gonçalves
• All Contributors

#License

The MIT License (MIT). Please see License File for more information.