README

Filament Matomo

A simple and elegant Laravel package that seamlessly integrates Matomo Analytics tracking code into your Filament v4 panels.

Requirements

PHP 8.2 or higher
Laravel 11.0 or 12.0
Filament 4.0

Installation

You can 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.

Usage

Once installed, the package automatically integrates Matomo tracking into all your Filament panels. No additional setup is required in your Filament code.

Configuration

Publish the Matomo configuration file:

php artisan vendor:publish --tag=matomo-config

Configure your Matomo settings in the published config/matomo.php file:

return [
    'url' => env('MATOMO_URL', 'https://your-matomo-instance.com'),
    'site_id' => env('MATOMO_SITE_ID', 1),
    'enabled' => env('MATOMO_ENABLED', true),
];

Add the corresponding environment variables to your .env file:

MATOMO_URL=https://your-matomo-instance.com
MATOMO_SITE_ID=1
MATOMO_ENABLED=true

The tracking script will be automatically injected into the <head> section of all your Filament panels.

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