{"id":267959,"date":"2025-12-18T16:10:00","date_gmt":"2025-12-18T16:10:00","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/real-time-widget-for-matomo\/"},"modified":"2026-01-14T19:12:48","modified_gmt":"2026-01-14T19:12:48","slug":"real-time-widget-for-matomo","status":"publish","type":"plugin","link":"https:\/\/cl.wordpress.org\/plugins\/real-time-widget-for-matomo\/","author":13615078,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.4.2","stable_tag":"1.4.2","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Real-Time Widget for Matomo","header_author":"JRMora","header_description":"A lightweight, real-time dashboard widget for Matomo. Includes native desktop notifications and sound alerts.","assets_banners_color":"e7e8eb","last_updated":"2026-01-14 19:12:48","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/jrmora.com\/","header_plugin_uri":"https:\/\/jrmora.com\/widget-matomo-visitas-tiempo-real-wordpress-sin-plugins\/","header_author_uri":"https:\/\/jrmora.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":227,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.4.0":{"tag":"1.4.0","author":"jrmora","date":"2025-12-18 16:09:32"},"1.4.1":{"tag":"1.4.1","author":"jrmora","date":"2026-01-09 01:07:54"},"1.4.2":{"tag":"1.4.2","author":"jrmora","date":"2026-01-14 19:12:48"}},"upgrade_notice":{"1.4.2":"<p>This version stabilizes the new icon system, ensuring compatibility with the latest Matomo file structures (Morpheus icons) and fixing previous display errors in social source logos.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3423080,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3423080,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3423080,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3423080,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.0","1.4.1","1.4.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3423080,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3423080,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3423080,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3423080,"resolution":"4","location":"assets","locale":""}},"screenshots":{"1":"Main widget view with real-time counters and hybrid visits chart.","2":"Detailed visitor log with source icons and action tooltips.","3":"Performance evolution chart (Network, Server, DOM, etc.).","4":"Configuration page with notification settings and \"Clean Uninstall\" option."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[232,434,151654,3518,162],"plugin_category":[36,43],"plugin_contributors":[252048],"plugin_business_model":[],"class_list":["post-267959","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-dashboard","plugin_tags-matomo","plugin_tags-realtime","plugin_tags-widget","plugin_category-analytics","plugin_category-customization","plugin_contributors-jrmora","plugin_committers-jrmora"],"banners":{"banner":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/banner-772x250.png?rev=3423080","banner_2x":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/banner-1544x500.png?rev=3423080","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/icon-128x128.png?rev=3423080","icon_2x":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/icon-256x256.png?rev=3423080","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/screenshot-1.png?rev=3423080","caption":"Main widget view with real-time counters and hybrid visits chart."},{"src":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/screenshot-2.png?rev=3423080","caption":"Detailed visitor log with source icons and action tooltips."},{"src":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/screenshot-3.png?rev=3423080","caption":"Performance evolution chart (Network, Server, DOM, etc.)."},{"src":"https:\/\/ps.w.org\/real-time-widget-for-matomo\/assets\/screenshot-4.png?rev=3423080","caption":"Configuration page with notification settings and \"Clean Uninstall\" option."}],"raw_content":"<!--section=description-->\n<p>This plugin adds a native widget to the WordPress dashboard that connects to your <strong>Matomo On-Premise<\/strong> installation to display vital metrics in real-time.<\/p>\n\n<p>Unlike other plugins that use iframes (often blocked for security) or synchronous PHP requests (which slow down the admin area), this widget uses a <strong>100% JavaScript (Client-Side) architecture<\/strong>.<\/p>\n\n<p>Your WordPress server performs no requests; the browser queries your Matomo API directly.<\/p>\n\n<p><strong>Key Features:<\/strong><\/p>\n\n<ul>\n<li><strong>Zero Server Impact:<\/strong> All processing is done in the client's browser.<\/li>\n<li><strong>Pure Real-Time:<\/strong> Visitor counters and logs update automatically every 10 seconds.<\/li>\n<li><strong>Smart Hybrid Chart:<\/strong> Combines historical data (cached) with real-time data from the current day for total accuracy.<\/li>\n<li><strong>Performance Monitor:<\/strong> Detailed chart of load times (Network, Server, DOM\u2026) and visit duration metrics.<\/li>\n<li><strong>\"Black Box\" Tooltips:<\/strong> Detailed, accessible information on hover, with visual differentiation for Searches, Downloads, Outlinks, and Events.<\/li>\n<li><strong>Privacy-Friendly:<\/strong> IP masking and visitor ID hashing included.<\/li>\n<li><strong>Native Notifications:<\/strong> Desktop alerts and optional sound when new visits arrive or traffic thresholds are met.<\/li>\n<\/ul>\n\n<h3>Copyright<\/h3>\n\n<p>Real-Time Widget for Matomo is distributed under the terms of the GNU GPL v2 or later.<\/p>\n\n<p>This plugin bundles the following third-party resources:<\/p>\n\n<ul>\n<li><p>Sound effect 'alerta.mp3' (Original: Text Tone 5.mp3) by dVidrio02\nSource: https:\/\/freesound.org\/people\/dVidrio02\/sounds\/191730\/\nLicense: Creative Commons 0 (Public Domain).<\/p><\/li>\n<li><p>Chart.js v4.5.1\nSource: https:\/\/www.chartjs.org\/\nLicense: MIT License.<\/p><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Go to <strong>Settings &gt; Matomo Widget<\/strong> and enter your Matomo API URL, Site ID, and Auth Token.<\/li>\n<li>Go to your Dashboard and enjoy the real-time data.<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>1.4.2<\/h4>\n\n<ul>\n<li>New: Advanced icon detection engine using native Matomo (Morpheus) icons.<\/li>\n<li>New: Specific mapping for Bluesky (bsky.app), Yandex, and major search engines.<\/li>\n<li>Fixed: Icon URL construction for search engines and social networks.<\/li>\n<li>Fixed: Full restoration of action tooltips and date formats in the visitor log.<\/li>\n<li>Improvement: Smarter icon fallbacks with a 3-step validation logic.<\/li>\n<\/ul>\n\n<h4>1.4.1<\/h4>\n\n<ul>\n<li>New: Detection for social networks (Bluesky, Threads, Mastodon, X).<\/li>\n<li>Improvement: Minor performance tweaks in the rendering engine.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Major: Internal renaming of all functions and variables to the <code>rtwfm_<\/code> prefix for better compatibility.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Major: Structural refactoring and security hardening.<\/li>\n<li>Update: Chart.js updated to v4.5.1.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>New: Added support for Outlinks, Downloads, and Search events in the visitor log.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>New: \"Clean Uninstall\" option to wipe data on deletion.<\/li>\n<li>New: <code>uninstall.php<\/code> integration.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Lightweight widget for Matomo On-Premise showing real-time stats, hybrid charts, and performance metrics without server impact.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/267959","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=267959"}],"author":[{"embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jrmora"}],"wp:attachment":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=267959"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=267959"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=267959"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=267959"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=267959"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=267959"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}