romiltecsrl

<p>Romiltec Analytics Tracking provides seamless Matomo analytics integration for WordPress sites. The plugin automatically tracks Post IDs as Custom Dimension 1 on single post pages, allowing you to analyze individual content performance in your Matomo dashboard.</p>
<p>Perfect for publishers, bloggers, and content marketers who want detailed insights into their content performance using self-hosted Matomo analytics.</p>
<h4>Features</h4>
<ul>
<li>Automatic Post ID Tracking – Post IDs are automatically tracked as Custom Dimension 1 on single post pages</li>
<li>Matomo Integration – Full Matomo analytics integration with customizable URL and Site ID</li>
<li>Scroll Depth Tracking – Automatically tracks user scroll depth at 25%, 50%, 75%, and 100% milestones</li>
<li>Time on Page Tracking – Accurate time measurement with heartbeat timer (tracks active viewing time)</li>
<li>Performance Optimized – Lightweight and cache-safe implementation</li>
<li>Easy Configuration – Simple admin interface with validation</li>
<li>Translation Ready – Full internationalization support</li>
<li>Security First – Input sanitization and capability checks</li>
<li>No External Dependencies – Works with your self-hosted Matomo installation</li>
</ul>
<h4>How It Works</h4>
<ol>
<li>Install and activate the plugin</li>
<li>Configure your Matomo URL and Site ID in Settings > Romiltec Analytics</li>
<li>Set up Custom Dimension 1 in your Matomo dashboard</li>
<li>The plugin automatically tracks all pageviews and sends Post IDs for single posts</li>
</ol>
<h4>Requirements</h4>
<ul>
<li>Active Matomo analytics installation (self-hosted or cloud)</li>
<li>HTTPS recommended for security</li>
</ul>


Romiltec Analytics Tracking

Professional Matomo analytics integration with automatic Post ID tracking as custom dimensions.

Mauricio Altamirano

Pagemachine

<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 …

Romiltec Analytics Tracking vs Pagemetrics for Matomo