jonashellmann

This plugin lets you integrate your existing Matomo On-Premise into WordPress. If you don’t already have a working Matomo (either <a href="https://matomo.org/matomo-on-premise/" rel="nofollow ugc">On-Premise</a> or <a href="https://matomo.org/hosting/" rel="nofollow ugc">Matomo Cloud</a>), use the <a href="https://wordpress.org/plugins/matomo/" rel="ugc">Matomo Analytics</a> plugin instead.
Matomo, formerly called Piwik, is an self-hosted open-source tool to analyze your pages. It needs a tracking code to be included in the pages that should be monitored. Also campaigns can be created by using specific parameters in the URL.
Therefore in this plugin, you can configure the URL where Matomo is hosted and the site ID for tracking your WordPress page. You can find it in the tracking code. You only need to fill in these both information. The rest of the tracking code is standartized and automatically inserted in the page. Also, you can set a campaign name (pk_campaign) and source (pk_source) which will be adds to the links in your RSS feed. This helps you to analyze how many users enter your pages by using your RSS feed. 
If you like to, there is an additional field to deactivate the usage of cookies by Matomo.

Include Matomo Tracking, by Jonas Hellmann

Simple to setup

This plugin lets you integrate your existing Matomo On-Premise into WordPress. If you don't already have a working Matomo (either On-Premise or M …

Pagemachine

Mauricio Altamirano

Pagemetrics for Matomo adds privacy-friendly, server-side analytics to WordPress by 
leveraging the <code>pagemachine/matomo-tracking</code> PHP library. When enabled, the 
plugin sends page view and optional download events from your WordPress site 
directly to a Matomo instance without loading Matomo’s JavaScript tracker.
Key benefits:
<ul>
<li>Track page views on the server with full control over attributes such as title, URL and referrer.</li>
<li>Optional download tracking rewrites file links and records the click before redirecting visitors.</li>
<li>Optional AI assistant bot tracking detects crawls from ChatGPT, Claude, Perplexity and others and forwards them to Matomo’s dedicated AI Assistants report.</li>
<li>Multisite aware – network admins can define defaults, individual sites can override them.</li>
<li>Respects Do Not Track and Global Privacy Control headers through the underlying library.</li>
<li>Logs issues to the WordPress debug log when <code>WP_DEBUG</code> is enabled.</li>
</ul>
Looking for expert help with Matomo or server-side tracking? Pagemachine offers 
consulting, implementation and ongoing support via our Pagemetrics solution. 
More info: <a href="https://pagemetrics.eu/" rel="nofollow ugc">Pagemetrics.eu</a>
<h3>Developer Hooks</h3>
Page view tracking:
<ul>
<li><code>pm_matomo_tracking_should_track_request</code> — Return <code>false</code> to skip page view tracking for the current request.</li>
</ul>
Download tracking:
<ul>
<li><code>pm_matomo_tracking_should_rewrite_downloads</code> — Return <code>false</code> to keep original download URLs for the current post.</li>
<li><code>pm_matomo_tracking_is_download_url</code> — Decide whether a specific URL should be rewritten (receives URL and default extension list).</li>
<li><code>pm_matomo_tracking_download_extensions</code> — Adjust the list of file extensions that count as downloads.</li>
<li><code>pm_matomo_tracking_download_url</code> — Customize the generated redirect URL used for download tracking.</li>
<li><code>pm_matomo_tracking_download_redirect_status</code> — Change the HTTP status code used when redirecting to the original file.</li>
</ul>
AI assistant bot tracking:
<ul>
<li><code>pm_matomo_tracking_ai_bot_user_agents</code> — Extend or replace the list of User-Agent substrings used to detect AI bots.</li>
</ul>
General:
<ul>
<li><code>pm_matomo_tracking_log_message</code> — Listen to debug messages emitted while <code>WP_DEBUG</code> is enabled.</li>
</ul>
<h3>Example usages</h3>
<pre><code>// Skip tracking for administrators.
add_filter('pm_matomo_tracking_should_track_request', static function ($shouldTrack) {
 return current_user_can('manage_options') ? false : $shouldTrack;
});

// Keep original download URLs on the privacy policy page.
add_filter('pm_matomo_tracking_should_rewrite_downloads', static function ($shouldRewrite) {
 return is_page('privacy-policy') ? false : $shouldRewrite;
});

// Force CDN assets to be treated as downloads.
add_filter('pm_matomo_tracking_is_download_url', static function ($decision, $url) {
 return str_contains($url, 'cdn.example.com/assets/') ? true : $decision;
}, 10, 2);

// Add extra file types to download tracking.
add_filter('pm_matomo_tracking_download_extensions', static function ($extensions) {
 $extensions = array_merge($extensions, ['svg', 'heic']);
 return array_unique($extensions);
});

// Append a checksum to rewritten download URLs.
add_filter('pm_matomo_tracking_download_url', static function ($trackingUrl, $target, $label) {
 $checksum = substr(hash('sha256', $target . $label), 0, 12);
 return add_query_arg('pm_checksum', $checksum, $trackingUrl);
}, 10, 3);

// Use a 307 redirect instead of the default 302.
add_filter('pm_matomo_tracking_download_redirect_status', static function () {
 return 307;
});

// Add a custom bot to AI assistant tracking.
add_filter('pm_matomo_tracking_ai_bot_user_agents', static function (array $substrings): array {
 $substrings[] = 'MyCustomBot';
 return $substrings;
});

// Forward debug messages to the PHP error log while developing.
add_action('pm_matomo_tracking_log_message', static function ($level, $message) {
 if (!defined('WP_DEBUG') || WP_DEBUG !== true) {
 return;
 }

 // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
 error_log(sprintf('[Pagemetrics for Matomo][%s] %s', strtoupper((string) $level), $message));
}, 10, 2);
</code></pre>

Pagemetrics for Matomo

Pagemetrics for Matomo adds server-side, privacy-friendly analytics to WordPress. It tracks page views, downloads, and AI assistant bot crawls without …

Include Matomo Tracking, by Jonas Hellmann vs Pagemetrics for Matomo