Dashlytics — Matomo Analytics Dashboard Widget

A lightweight WordPress plugin that brings your Matomo analytics data into the WordPress dashboard. View visitors, page views, bounce rate and trends without switching tabs.

Highlights

• Dashboard widget with key metrics and trend charts
• Interactive charts — line, bar and pie views
• Flexible date range with date-picker support
• Custom accent color to match your brand
• Auto-detect Matomo for WordPress for one-click setup
• PDF and PNG export for quick reports
• WordPress-native security — REST endpoints with nonces and capability checks

Requirements

• WordPress 5.8 or later
• PHP 7.4 or later
• Matomo installation: self-hosted, Matomo Cloud, or the Matomo for WordPress plugin

Installation

1. Download the latest ZIP from the releases page.
2. In WordPress, go to Plugins → Add New → Upload Plugin and activate it.
3. Open Dashlytics in the admin menu.
4. Connect Matomo automatically (if Matomo for WordPress is installed) or enter URL, Site ID and API token manually.

Development

Architecture

Dashlytics is built as a modern WordPress plugin around two Svelte 4 SPAs:

• Dashboard Widget (app/DashboardWidget.svelte) — rendered via wp_dashboard_setup, built to app/public/build/dashboardwidget.js.
• Settings Page (app/DashlyticsSettings.svelte) — rendered on toplevel_page_dashlytics, built to app/public/build/settings.js and bundle.css.

The PHP backend (dashlytics-matomo.php) uses the singleton pattern, exposes a custom REST namespace dashlytics/v1, proxies Matomo API requests, validates nonces and checks the manage_options capability.

Build

cd app
npm install --legacy-peer-deps
npm run build
cd ..
bash build-plugin.sh

The resulting installable ZIP is written to dist/dashlytics-matomo-analytics-widget-{VERSION}.zip.

Automated Releases

Pushing a Git tag vX.Y.Z triggers .github/workflows/release.yml:

1. Runs PHPCS and the Svelte build.
2. Executes build-plugin.sh to create dist/dashlytics-matomo-analytics-widget-X.Y.Z.zip.
3. Creates a GitHub Release and attaches the ZIP automatically.

Example:

git tag -a v0.8.4 -m "Release 0.8.4"
git push origin refs/tags/v0.8.4

No manual ZIP upload is needed.

Dependency Notes

Package	Version	Purpose	Maintenance
chart.js	^4.4.x	Interactive charts	Current minor is stable
jspdf	^2.5.x	PDF report generation	Upgrade to jspdf@4.x requires separate QA
svelte	^4.2.x	UI framework	Migration to Svelte 5 is planned separately
rollup	^4.x	Bundler	Latest compatible minor

The plugin uses the dashlytics-matomo-analytics-widget text domain. Translation files (dashlytics-matomo-analytics-widget.pot, dashlytics-matomo-analytics-widget-de_DE.po/mo, dashlytics-matomo-analytics-widget-en_US.po/mo) are available under languages/.

Plugin Updates

Once the plugin is approved and published on WordPress.org, updates are delivered through the official WordPress.org plugin directory. The Plugin Update Checker has been removed from the distribution package for the WP.org submission.

License

GPL-2.0-or-later. See LICENSE for details.

Author

Developed by Matt Interfaces.

• Website: https://matt-interfaces.ch/wp-dashlytics
• Support: hoi@matt-interfaces.ch
• Support the project: https://matt-interfaces.ch/zahlen