Pular para o conteúdo
Jefferson Gonçalves
← Voltar para projetos

Filament Metrics Fathom

Filament plugin for Fathom Analytics metrics - dashboard widgets for pageviews, visitors, top pages, referrers, browsers, countries and devices.

Versão: v3 v4 v5 · branch: 3.x

Filament Metrics Fathom

#Filament Metrics Fathom

Buy Me A Coffee

Latest Version on Packagist GitHub Code Style Action Status Total Downloads License

A Filament plugin that integrates Fathom Analytics into your admin panel. Get real-time visitor counts, pageview charts, top pages, referrers, browsers, countries and device breakdowns — all from your Filament dashboard.

#Features

  • Settings page to configure Fathom API credentials directly from the panel
  • 7 ready-to-use dashboard widgets (stats, charts, tables)
  • Real-time visitor count with automatic polling (every 30s)
  • Caching built-in to respect Fathom API rate limits (10 req/min)
  • Multi-language support (English and Brazilian Portuguese)
  • Fully configurable: enable/disable settings page and widgets independently

#Version Compatibility

Plugin Filament Laravel PHP Livewire
1.x 3.x 10.x / 11.x 8.2+ 3.x
2.x 4.x 11.x+ 8.2+ 3.x
3.x 5.x 11.x+ 8.2+ 4.x

#Requirements

#Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-metrics-fathom:"^3.0"

Publish and run the settings migration from the base package:

php artisan vendor:publish --tag="metrics-fathom-settings"
php artisan migrate

#Setup

Register the plugin in your Filament panel provider:

use JeffersonGoncalves\Filament\MetricsFathom\FathomMetricsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(FathomMetricsPlugin::make());
}

#Configuration

You can enable or disable features individually:

FathomMetricsPlugin::make()
    ->settingsPage(false) // Disable the settings page
    ->widgets(false)      // Disable all widgets

#Widgets

The plugin provides 7 dashboard widgets:

Widget Description Type
Current Visitors Real-time visitor count with top pages Stats Overview (polls every 30s)
Pageviews Chart Visits & pageviews over the last 30 days Line Chart
Top Pages Most visited pages with visit/pageview counts Table
Top Referrers Traffic sources with visit/unique counts Table
Top Browsers Browser distribution Doughnut Chart
Top Countries Country distribution with visit/unique counts Table
Top Devices Device type distribution (desktop, mobile, tablet) Doughnut Chart

All widgets include:

  • Automatic error handling with user-friendly messages
  • "Not Configured" state when API token is missing
  • Built-in caching to respect Fathom API rate limits
  • Multi-language support (English and Portuguese)

#Translations

The plugin supports English (en) and Brazilian Portuguese (pt_BR). You can publish the translations:

php artisan vendor:publish --tag="filament-metrics-fathom-translations"

#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.

Nova versão disponível.