README

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

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.

jeffersongoncalves / filament-matomo

Maintainers

Details