README

Laravel Matomo

A simple and elegant Laravel package that seamlessly integrates Matomo Analytics tracking code into your Blade views. Settings are stored in the database via spatie/laravel-settings, allowing runtime configuration without .env files.

Installation

Install the package via Composer:

composer require jeffersongoncalves/laravel-matomo

Publish the settings migration:

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

Run the migration:

php artisan migrate

Usage

Add the tracking script to your Blade layout (typically before </head>):

@include('matomo::script')

Configuration

All settings are stored in the database. You can update them via code:

use JeffersonGoncalves\Matomo\Settings\MatomoSettings;

$settings = app(MatomoSettings::class);

$settings->domains = 'example.com';
$settings->site_id = '1';
$settings->host_analytics = 'analytics.example.com';
$settings->file = 'matomo.php';
$settings->script = 'matomo.js';

$settings->save();

Available Settings

Setting	Default	Description
`domains`	`''`	Domain(s) for tracking
`site_id`	`'1'`	Site ID in Matomo
`host_analytics`	`''`	Matomo server URL (without protocol)
`file`	`'matomo.php'`	PHP tracking file
`script`	`'matomo.js'`	JS tracking file

Content Security Policy

When your app sets a CSP nonce through Laravel's Vite (Vite::useCspNonce(), as laravel-security-headers does), every <script> this package renders carries it, so a script-src 'self' 'nonce-{nonce}' policy works without 'unsafe-inline'. Scripts loaded afterwards from the vendor's own CDN still need that host in script-src (and its API in connect-src).

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.

jeffersongoncalves / laravel-matomo

Package info

Security

Fund package maintenance!

Statistics