README

A Laravel middleware package for sending analytics data to the Mattitja Analytics API. The package automatically registers middleware for web routes and sends data synchronously to the analytics service.

Installation

composer require mattitjaab/mattitja-analytics

Configuration

Publish the configuration file (optional):

php artisan vendor:publish --tag=mattitja-analytics-config

Add your site key to your .env file:

MATTITJA_ANALYTICS_SITE_KEY=your-site-key
MATTITJA_ANALYTICS_ENABLED=true

Usage

The package automatically registers middleware for the web group and starts collecting analytics data immediately after installation and configuration.

Manual middleware registration

You can also add the middleware manually for specific routes:

// In routes/web.php
Route::middleware(['mattitja-analytics'])->group(function () {
    // Your routes here
});

Configuration Options

Basic Settings

• MATTITJA_ANALYTICS_SITE_KEY - Your site key from Mattitja Analytics (required)
• MATTITJA_ANALYTICS_ENABLED - Enable/disable tracking (default: true)
• MATTITJA_ANALYTICS_BOTS - Track bots (default: false)

Privacy Settings

• MATTITJA_ANALYTICS_RESPECT_DNT - Respect Do Not Track header (default: true)

Filtering

You can configure paths and IP addresses to ignore in the config file.

Data Sent

The package sends the following data to https://analytics.mattitja.cloud/api/send:

• k - Site key
• u - Full URL of the visited page
• r - Referrer URL (if available)
• ip - Visitor's complete IP address
• ua - User agent string

Security

• Data is sent synchronously directly from middleware
• IP addresses are NOT anonymized (needed for geolocation)
• Bot traffic is filtered out by default
• Do Not Track header is respected by default

Development

Run tests:

composer test

License

MIT License