Pagemachine

Mauricio Altamirano

<p>Pagemetrics for Matomo adds privacy-friendly, server-side analytics to WordPress by<br />
leveraging the <code>pagemachine/matomo-tracking</code> PHP library. When enabled, the<br />
plugin sends page view and optional download events from your WordPress site<br />
directly to a Matomo instance without loading Matomo’s JavaScript tracker.</p>
<p>Key benefits:</p>
<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>
<p>Looking for expert help with Matomo or server-side tracking? <strong>Pagemachine</strong> offers<br />
consulting, implementation and ongoing support via our <strong>Pagemetrics</strong> solution.<br />
More info: <a href="https://pagemetrics.eu/" rel="nofollow ugc">Pagemetrics.eu</a></p>
<h3>Developer Hooks</h3>
<p>Page view tracking:</p>
<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>
<p>Download tracking:</p>
<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>
<p>AI assistant bot tracking:</p>
<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>
<p>General:</p>
<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 …

Marvin Blum

<p>Pirsch is a simple, privacy-friendly, open-source web analytics tool. It’s lightweight, cookie-free and easily integrates into your WordPress installation, without using JavaScript. It does not collect data that can be uniquely assigned to a user, but instead shows aggregated statistics. Find out more <a href="https://docs.pirsch.io/privacy/" rel="nofollow ugc">here</a> on how that works.</p>
<h3>Terms and Conditions, Privacy Policy</h3>
<p>Please refer to our website for our <a href="https://pirsch.io/terms" rel="nofollow ugc">terms and conditions</a> and <a href="https://pirsch.io/privacy" rel="nofollow ugc">privacy policy</a>. Responsible for this plugin is <a href="https://pirsch.io/legal" rel="nofollow ugc">Emvi Software GmbH</a>.</p>


Pirsch Analytics

The official Wordpress Plugin for Pirsch Analytics.

Pagemetrics for Matomo vs Pirsch Analytics