Real-Time Widget for Matomo

This plugin adds a native widget to the WordPress dashboard that connects to your Matomo On-Premise installation to display vital metrics in real-time. Unlike other plugins that use iframes (often blocked for security) or synchronous PHP requests (which slow down the admin area), this widget uses a 100% JavaScript (Client-Side) architecture. Your WordPress server performs no requests; the browser queries your Matomo API directly. Key Features:

• Zero Server Impact: All processing is done in the client's browser.
• Pure Real-Time: Visitor counters and logs update automatically every 10 seconds.
• Smart Hybrid Chart: Combines historical data (cached) with real-time data from the current day for total accuracy.
• Performance Monitor: Detailed chart of load times (Network, Server, DOM…) and visit duration metrics.
• "Black Box" Tooltips: Detailed, accessible information on hover, with visual differentiation for Searches, Downloads, Outlinks and Events.
• Live Desktop Notifications: Get a system alert when someone visits your site or when a specific traffic threshold is reached.
• Audio Alerts: Optional sound notification for new visits.

1.4.1

• New: Support for modern social networks (Bluesky, Threads, Mastodon and X/Twitter).
• Improvement: Integrated official high-definition SVG icons for social referrers.
• Improvement: Added 't.co' and 'x.com' detection for better X (Twitter) tracking.
• Improvement: Code optimization for faster log rendering.
• Translation: Updated strings for better internationalization support.

1.4.0

• Fix: Renamed all functions, classes, and database options to use a unique 5-letter prefix (rtwfm_) to prevent conflicts with other plugins and comply with WordPress.org guidelines.
• Fix: Updated all JavaScript constants and localized variables to use the new prefix.
• Fix: Standardized text domain and internal identifiers.

1.3.0

• Update: Bumped Chart.js to version 4.5.1 (UMD).
• Refactor: Optimized JavaScript architecture for better performance.
• Improvement: Semantic icons for all visitor actions (Events, Searches, Downloads).
• Fix: Better handling of localized strings in JavaScript.

1.2.0

• New: Added get_site_icon_url() to use the Site Icon (Favicon) in desktop alerts instead of the generic WP logo.
• Improvement: Smart logic to handle modern browser 'Autoplay' policies (audio unlock via interaction).
• Improvement: Updated test script in settings to reflect the real environment.
• Fix: Added error handling (try/catch) in notifications to prevent the widget from crashing on mobile browsers (Illegal constructor error).

1.1.0

• New: "Clean Uninstall" option in settings to remove the token and database configuration upon plugin deletion.
• New: uninstall.php file to handle data cleanup.
• Updated: Compatibility tested up to WordPress 6.9.

1.0.0

• Initial release.
• Support for Hybrid Charts (Chart.js).
• Performance Monitor.
• Visitor Log with semantic icons (Pageview, Download, Outlink, Search, Event).