Matomo plugin screenshot
Dark mode ready
Multilingual support
Supports v5.x

Matomo

Seamlessly integrates Matomo Analytics tracking code into your Filament panels.

Tags: Analytics
Supported versions:
4.x 3.x
Jefferson Gonçalves avatar Author: Jefferson Gonçalves

Documentation

Version:

Filament Matomo

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

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

#Requirements

#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

Register the plugin in your Filament PanelProvider:

use JeffersonGoncalves\Filament\Matomo\MatomoPlugin;

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

Once registered, the plugin will:

  1. Inject the Matomo tracking script into the <head> of your Filament panels automatically
  2. 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.