Filament Matomo

#Filament Matomo

Filament plugin for Matomo Analytics with Settings Page — manage tracking configuration directly from your Filament panel via spatie/laravel-settings.

#Requirements

PHP 8.2 or higher
Laravel 11.28 or higher
Filament 5.x
jeffersongoncalves/laravel-matomo ^2.0

#Version Compatibility

Branch	Filament	PHP
1.x	^3.0	^8.2
2.x	^4.0	^8.2
3.x	^5.0	^8.2

#Installation

You can install the package via composer:

Install the package via Composer:

composer require jeffersongoncalves/filament-matomo

This package depends on jeffersongoncalves/laravel-matomo which provides the core Matomo integration for Laravel. It will be automatically installed as a dependency.

Publish and run the settings migration from laravel-matomo:

php artisan vendor:publish --tag=matomo-settings-migrations
php artisan migrate

#Usage

use JeffersonGoncalves\Filament\Matomo\MatomoPlugin;

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

Once registered, the plugin will:

Inject the Matomo tracking script into the <head> of your Filament panels automatically
Add a Settings Page where you can manage all Matomo tracking configuration directly from the admin panel

#Disabling the Settings Page

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

MatomoPlugin::make()
    ->settingsPage(false),

#Available Settings

Setting	Description
Domains	Domain(s) to track
Site ID	Your Matomo Site ID
Matomo Host	Matomo server URL (without protocol)
PHP Tracking File	PHP tracking endpoint (default: `matomo.php`)
JS Tracking File	JavaScript tracking file (default: `matomo.js`)

#Translations

The plugin includes translations for English and Brazilian Portuguese (pt_BR). You can publish the translations to customize them:

php artisan vendor:publish --tag=filament-matomo-translations

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