laravel-metrics-matomo
Laravel package to interact with Matomo Analytics Reporting API - fetch visits, pageviews, referrers, devices and generate custom reports for dashboards.
Ficha actualizada 22 sept 2026, 21:23 · upstream 22 sept 2026, 21:04 · release v1.1.2
Qué es laravel-metrics-matomo
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
This is a Laravel PHP package that provides a fluent interface to the Matomo Analytics Reporting API. It allows developers to fetch various analytics metrics such as visits summary, page views, referrer information, device types, countries, events, goals, and live visitor counters. The package stores settings in the database using Spatie's Laravel Settings facade, eliminating the need for configuration files. It supports multiple output formats including JSON, XML, CSV, TSV, HTML, and RSS.
- Fetch daily visits summary with bounce rate and average time on site
- Generate monthly reports showing top pages by traffic volume
- Analyze referrer sources to identify organic vs. paid traffic
- Track device types (desktop/mobile/tablet) for user behavior segmentation
- Monitor real-time visitor counts using live counters API
- Build custom dashboards with country, city, and region breakdowns
- Export analytics data in multiple formats (CSV, TSV, HTML)
- Uses Spatie Laravel Settings for configuration management without config files
- Supports fluent query builder for flexible report generation
- Provides live visitor counters with last N minutes/seconds window
- Includes comprehensive event tracking and goal analytics
- Offers multiple output formats including RSS feeds and HTML reports
- Fully tested with PHPUnit and includes static analysis via PHPStan
- Requires Matomo Analytics API token to be configured in environment variables or database settings
- Does not include Matomo's full reporting engine - only the public-facing Reporting API endpoints are exposed
- No built-in caching layer for large datasets; queries should use pagination and limit parameters
- Live visitor counters may have latency due to real-time data fetching from Matomo servers
- Event tracking requires proper implementation in your application's event listeners
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Install via composer: composer require jeffersongoncalves/laravel-metrics-matomo,Run migrations to create the settings table and API token table,Configure MATOMO_API_TOKEN, MATOMO_SITE_ID, MATOMO_BASE_URL, and MATOMO_TIMEZONE in .env file or database settings,Enable CORS if your Matomo instance requires it for frontend requests,Use Laravel Horizon or similar queue system to handle live visitor counter updates asynchronously,For production, consider implementing rate limiting on the API endpoint to prevent abuse
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.