jeffersongoncalves/filament-fathom

This Laravel package seamlessly integrates Fathom analytics into your Blade templates. Easily track website visits and user engagement directly within your Laravel application, providing valuable insights into your website's performance. This package simplifies the integration process, saving you ti

2.0.0 2025-07-17 15:03 UTC

This package is auto-updated.

Last update: 2025-07-17 15:14:35 UTC


README

Filament Fathom

Filament Fathom

Latest Version on Packagist GitHub Code Style Action Status Total Downloads

This Filament package seamlessly integrates Fathom analytics into your Filament admin panels. It automatically injects the Fathom tracking script into all Filament panels, allowing you to track admin user engagement and panel usage directly within your Laravel application. This package simplifies the integration process by automatically handling the script injection, saving you time and effort. With minimal configuration, you can leverage Fathom's powerful analytics features to gain valuable insights into your admin panel usage.

Requirements

  • PHP 8.2 or higher
  • Laravel 11.0 or higher
  • Filament 4.0 or higher

Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-fathom

This package depends on jeffersongoncalves/laravel-fathom which will be automatically installed as a dependency.

The service provider will be automatically discovered and registered by Laravel. No additional setup is required.

Usage

This package automatically integrates with your Filament admin panels. Once installed and configured, the Fathom tracking script will be automatically injected into all Filament panel pages.

  1. Publish the Fathom configuration file:
php artisan vendor:publish --tag=fathom-config
  1. Configure your Fathom site ID in the published configuration file or set the FATHOM_SITE_ID environment variable.

That's it! The package will automatically inject the Fathom analytics script into your Filament admin panels. No manual template modifications are required.

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

License

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