PHPackages jeffersongoncalves/laravel-metrics-matomo - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Admin Panels](/categories/admin) 4. / 5. jeffersongoncalves/laravel-metrics-matomo ActiveLibrary[Admin Panels](/categories/admin) jeffersongoncalves/laravel-metrics-matomo ========================================= Laravel package to interact with Matomo Analytics Reporting API - fetch visits, pageviews, referrers, devices, and generate custom reports v1.0.1(2mo ago)511MITPHPPHP ^8.2CI passing Since Mar 3Pushed 1mo ago1 watchersCompare [ Source](https://github.com/jeffersongoncalves/laravel-metrics-matomo)[ Packagist](https://packagist.org/packages/jeffersongoncalves/laravel-metrics-matomo)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-laravel-metrics-matomo/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (9)Versions (3)Used By (1) [![Laravel Metrics Matomo](https://raw.githubusercontent.com/jeffersongoncalves/laravel-metrics-matomo/main/art/jeffersongoncalves-laravel-metrics-matomo.png)](https://raw.githubusercontent.com/jeffersongoncalves/laravel-metrics-matomo/main/art/jeffersongoncalves-laravel-metrics-matomo.png) Laravel Metrics Matomo ====================== [](#laravel-metrics-matomo) [![Latest Version on Packagist](https://camo.githubusercontent.com/0e08fa12bfd7e0724a196e87d2c3a2288ec45551edb3eeb6db759c31a625c4e7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6566666572736f6e676f6e63616c7665732f6c61726176656c2d6d6574726963732d6d61746f6d6f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/laravel-metrics-matomo)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/17e218d641f93779a7d749b828026a1f269ff41ec1bcd32f99682d2aabbc15ba/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6566666572736f6e676f6e63616c7665732f6c61726176656c2d6d6574726963732d6d61746f6d6f2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/jeffersongoncalves/laravel-metrics-matomo/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amain)[![PHPStan](https://camo.githubusercontent.com/7bf512219281e039b01aca920f36a7ec1260f89cd0e11ee35982d696536591ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6566666572736f6e676f6e63616c7665732f6c61726176656c2d6d6574726963732d6d61746f6d6f2f7068707374616e2e796d6c3f6272616e63683d6d61696e266c6162656c3d5048505374616e267374796c653d666c61742d737175617265)](https://github.com/jeffersongoncalves/laravel-metrics-matomo/actions?query=workflow%3APHPStan+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/4f3d9a5a2ebf6ebda0568ba3f39cf2c6000ec593d195883e85d53d87bded40b9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6566666572736f6e676f6e63616c7665732f6c61726176656c2d6d6574726963732d6d61746f6d6f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/laravel-metrics-matomo) Laravel package to interact with the [Matomo Analytics](https://matomo.org) Reporting API. Fetch visits, pageviews, referrers, devices, countries, live visitors, and generate custom reports for dashboards. Settings are stored in the database via [spatie/laravel-settings](https://github.com/spatie/laravel-settings) — no config files needed. Installation ------------ [](#installation) ``` composer require jeffersongoncalves/laravel-metrics-matomo ``` Run migrations to create the settings: ``` php artisan migrate ``` Configuration ------------- [](#configuration) After migration, the settings are seeded from environment variables: ``` MATOMO_API_TOKEN=your-token-auth MATOMO_SITE_ID=1 MATOMO_BASE_URL=https://your-matomo-instance.com MATOMO_TIMEZONE=UTC ``` You can also update settings programmatically: ``` use JeffersonGoncalves\MetricsMatomo\Settings\MatomoSettings; $settings = app(MatomoSettings::class); $settings->api_token = 'new-token'; $settings->site_id = 2; $settings->base_url = 'https://matomo.example.com'; $settings->timezone = 'America/Sao_Paulo'; $settings->save(); ``` Usage ----- [](#usage) ### Using the Facade [](#using-the-facade) ``` use JeffersonGoncalves\MetricsMatomo\Facades\Matomo; use JeffersonGoncalves\MetricsMatomo\Enums\Period; ``` ### Visits Summary [](#visits-summary) ``` // Today's summary $summary = Matomo::visitsSummary(); echo $summary->nbVisits; // 1234 echo $summary->nbUniqVisitors; // 567 echo $summary->nbActions; // 3456 echo $summary->bounceRate; // 16.0 echo $summary->avgTimeOnSite; // 120.5 // Monthly summary $summary = Matomo::visitsSummary(Period::Month, 'today'); // Specific date $summary = Matomo::visitsSummary(Period::Day, '2026-02-15'); ``` ### Top Pages [](#top-pages) ``` // Top 10 page URLs $pages = Matomo::pageUrls(limit: 10); foreach ($pages as $page) { echo $page->label . ': ' . $page->nbVisits . ' visits'; } // Page titles $titles = Matomo::pageTitles(Period::Month, 'today', limit: 20); // Entry and exit pages $entry = Matomo::entryPages(limit: 10); $exit = Matomo::exitPages(limit: 10); ``` ### Referrers [](#referrers) ``` // Referrer types (Direct, Search, Social, etc.) $types = Matomo::referrerTypes(); // Search engines $engines = Matomo::searchEngines(Period::Month, 'today'); // Keywords $keywords = Matomo::keywords(limit: 20); // Referring websites $sites = Matomo::websites(limit: 10); // Social networks $socials = Matomo::socials(); // Campaigns $campaigns = Matomo::campaigns(Period::Month, 'today'); ``` ### Geography [](#geography) ``` // Countries $countries = Matomo::countries(Period::Month, 'today'); foreach ($countries as $country) { echo $country->label . ': ' . $country->nbVisits; echo ' (' . $country->extra['code'] . ')'; // Country code } // Cities $cities = Matomo::cities(limit: 10); // Regions $regions = Matomo::regions(); // Continents $continents = Matomo::continents(); ``` ### Devices & Technology [](#devices--technology) ``` // Device types (Desktop, Mobile, Tablet) $devices = Matomo::deviceTypes(); // Browsers $browsers = Matomo::browsers(limit: 10); // Operating systems $os = Matomo::osFamilies(); // Screen resolutions $resolutions = Matomo::resolutions(limit: 10); ``` ### Events [](#events) ``` // Event categories $categories = Matomo::eventCategories(Period::Month, 'today'); // Event actions $actions = Matomo::eventActions(); // Event names $names = Matomo::eventNames(limit: 20); ``` ### Goals [](#goals) ``` // All goals summary $goals = Matomo::goals(Period::Month, 'today'); // Specific goal $goal = Matomo::goal(goalId: 1, period: Period::Month, date: 'today'); ``` ### Live Visitors (Real-time) [](#live-visitors-real-time) ``` // Counters for last 30 minutes $counters = Matomo::liveCounters(); echo $counters->visits; // 42 echo $counters->actions; // 156 echo $counters->visitors; // 38 echo $counters->visitsConverted; // 5 // Counters for last 60 minutes $counters = Matomo::liveCounters(lastMinutes: 60); // Last visitors details $visitors = Matomo::liveVisitors(count: 10); ``` ### Custom Reports (Query Builder) [](#custom-reports-query-builder) Build flexible reports using the fluent query builder: ``` use JeffersonGoncalves\MetricsMatomo\Enums\Period; // Custom query with segment $query = Matomo::query('VisitsSummary', 'get') ->period(Period::Month) ->date('2026-02-01') ->segment('referrerName==twitter.com') ->limit(50); $result = Matomo::report($query); // Date range query $query = Matomo::query('Actions', 'getPageUrls') ->dateRange('2026-01-01', '2026-01-31') ->sortBy('nb_visits', 'desc') ->limit(20) ->flat(); $result = Matomo::report($query); // Show/hide specific columns $query = Matomo::query('VisitsSummary', 'get') ->period(Period::Day) ->date('today') ->showColumns('nb_visits', 'nb_uniq_visitors', 'bounce_rate'); $result = Matomo::report($query); // With extra parameters $query = Matomo::query('Goals', 'get') ->period(Period::Month) ->date('today') ->param('idGoal', 1); $result = Matomo::report($query); ``` ### Using DateTime Objects [](#using-datetime-objects) ``` use Carbon\Carbon; $summary = Matomo::visitsSummary( period: Period::Day, date: Carbon::yesterday()->format('Y-m-d'), ); $query = Matomo::query('Actions', 'getPageUrls') ->dateRange(Carbon::now()->subDays(30), Carbon::now()); $result = Matomo::report($query); ``` Available Enums --------------- [](#available-enums) ### Period [](#period) `Day`, `Week`, `Month`, `Year`, `Range` ### Format [](#format) `Json`, `Xml`, `Csv`, `Tsv`, `Html`, `Rss` Available API Methods --------------------- [](#available-api-methods) CategoryMethods**Visits**`visitsSummary`**Pages**`pageUrls`, `pageTitles`, `entryPages`, `exitPages`, `downloads`, `outlinks`, `siteSearchKeywords`**Referrers**`referrerTypes`, `searchEngines`, `keywords`, `websites`, `socials`, `campaigns`**Geography**`countries`, `cities`, `regions`, `continents`**Devices**`deviceTypes`, `browsers`, `osFamilies`, `resolutions`**Events**`eventCategories`, `eventActions`, `eventNames`**Goals**`goals`, `goal`**Live**`liveCounters`, `liveVisitors`**Generic**`query`, `report`Testing ------- [](#testing) ``` composer test ``` Code Style ---------- [](#code-style) ``` composer format ``` Static Analysis --------------- [](#static-analysis) ``` composer analyse ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE) for more information. ### Health Score 40 — FairBetter than 88% of packages Maintenance89 Actively maintained with recent releases Popularity6 Limited adoption so far Community11 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 80% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 71d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves) --- Top Contributors [![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)") --- Tags analyticscomposerdashboardjeffersongoncalveslaravellaravel-packagematomometricsphpprivacyreportingself-hostedweb-analyticslaravelmatomoMetricsanalyticsvisitorsprivacyself hostedpageviews ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/jeffersongoncalves-laravel-metrics-matomo/health.svg) ``` [![Health](https://phpackages.com/badges/jeffersongoncalves-laravel-metrics-matomo/health.svg)](https://phpackages.com/packages/jeffersongoncalves-laravel-metrics-matomo) ``` ### Alternatives [spatie/laravel-responsecache Speed up a Laravel application by caching the entire response 2.8k8.2M51](/packages/spatie-laravel-responsecache)[bezhansalleh/filament-google-analytics Google Analytics integration for FilamentPHP 205144.8k5](/packages/bezhansalleh-filament-google-analytics)[andreaselia/analytics Analytics for the Laravel framework. 19719.5k2](/packages/andreaselia-analytics)[a2insights/filament-saas Filament Saas for A2Insights 161.1k](/packages/a2insights-filament-saas) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)