Matomo Analytics Live Counter

This module is designed with shared hosting limitations in mind, utilizing a smart file-based caching system to eliminate redundant API requests and prevent server overhead.

Key Features
Real-Time Data: Display “Online Now” visitors, daily unique users, today’s pageviews, weekly, and monthly totals.
Zero Server Load (Smart Caching) Features a file-based JSON cache. The module reads stats instantly from a local file, performing only one background API request per cache interval (e.g., every 5 minutes).
Native Multilingual Support: Fully localized in English (en-GB), Ukrainian (uk-UA), and Russian (ru-RU). Supports automatic page language matching or forced language override.
Clean Design: Lightweight HTML/CSS structure that seamlessly inherits your active Joomla template styling with dark-mode support.

Technical Architecture

The module utilizes Joomla’s internal API engine and Matomo’s API.getBulkRequest to fetch all enabled metrics within a single, optimized POST cURL request.

[User Browser] ──> [Joomla 5 Website]
│
(Is local JSON cache valid?)
├──> YES ──> [Read Cache File] ──> (Render HTML instantly)
│
└──> NO ──> [Bulk API Request] ──> [Matomo Server]
│
(Update Local Cache)

Requirements
Joomla! 5.x.x
PHP 8.1 or higher
PHP cURL extension enabled
Matomo Analytics (Self-hosted or Cloud) with API access

Update
The extension is updated through the standard Joomla Update System, with all releases available for download at:
https://github.com/TommiLin/Matomo-Analytics-Live-Counter/releases

Author
Developed with ❤️ by TommiLin