braekling

<p><strong>Version 1.1.7 includes a security related fix, it is highly recommended to update to this or a later version.</strong></p>
<p>If you are not yet using Matomo On-Premise, Matomo Cloud or hosting your own instance of Matomo, please use the <a href="https://wordpress.org/plugins/matomo/" rel="ugc">Matomo for WordPress plugin</a>.</p>
<p>This plugin uses the Matomo API to show your Matomo statistics in your WordPress dashboard. It’s also able to add the Matomo tracking code to your blog and to do some modifications to the tracking code. Additionally, WP-Matomo supports WordPress networks and manages multiple sites and their tracking codes.</p>
<p>To use this plugin the Matomo web analytics application is required. If you do not already have a Matomo setup (e.g., provided by your web hosting service), you have two simple options: use either a <a href="http://matomo.org/" rel="nofollow ugc">self-hosted Matomo</a> or a <a href="https://www.innocraft.cloud/?pk_campaign=WP-Piwik" rel="nofollow ugc">cloud-hosted Matomo by InnoCraft</a>.</p>
<p><strong>Requirements:</strong> PHP 7.0 (or higher), WordPress 5.0 (or higher), Matomo 4.0 (or higher)</p>
<p><strong>Languages:</strong> English, Albanian, Chinese, Dutch, French, German, Greek, Hungarian, Italian, Polish, Portuguese (Brazil). Partially supported: Azerbaijani, Belarusian, Hindi, Lithuanian, Luxembourgish, Norwegian, Persian, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian</p>
<h4>What is Matomo?</h4>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/Qc2kooLNDiU?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span><br />
<a href="https://matomo.org/what-is-matomo/" rel="nofollow ugc">Learn more.</a></p>
<h4>First steps</h4>
<ul>
<li>Learn how to install your own Matomo instance: <a href="https://matomo.org/docs/requirements/" rel="nofollow ugc">Requirements</a>, <a href="https://matomo.org/docs/installation-optimization/" rel="nofollow ugc">Installation</a>.</li>
<li>If you need support about Matomo, please have a look at the <a href="https://forum.matomo.org/" rel="nofollow ugc">Matomo forums</a>.</li>
<li>Finally, you can start <a href="https://matomo.org/blog/2015/05/wordpress-integration-wp-piwik-1-0/" rel="nofollow ugc">setting up WP-Matomo</a>.</li>
</ul>
<h4>Shortcodes</h4>
<p>You can use following shortcodes if activated:</p>
<pre><code>[wp-piwik module="overview" title="" period="day" date="yesterday"]
</code></pre>
<p>Shows overview table like WP-Matomo’s overview dashboard. See Matomo API documentation on VisitsSummary.get to get more information on period and day. Multiple data arrays will be cumulated. If you fill the title attribute, its content will be shown in the table’s title.</p>
<pre><code>[wp-piwik module="opt-out" language="en" width="100%" height="200px"]
</code></pre>
<p>Shows the Matomo opt-out Iframe. You can change the Iframe’s language by the language attribute (e.g. de for German language) and its width and height using the corresponding attributes.</p>
<pre><code>[wp-piwik module="post" range="last30" key="sum_daily_nb_uniq_visitors"]
</code></pre>
<p>Shows the chosen keys value related to the current post. You can define a range (format: lastN, previousN or YYYY-MM-DD,YYYY-MM-DD) and the desired value’s key (e.g., sum_daily_nb_uniq_visitors, nb_visits or nb_hits – for details see Matomo’s API method Actions.getPageUrl using a range).</p>
<pre><code>[wp-piwik]
</code></pre>
<p>is equal to <em>[wp-piwik module=”overview” title=”” period=”day” date=”yesterday”]</em>.</p>
<h4>Credits and Acknowledgements</h4>
<ul>
<li>Graphs powered by <a href="https://www.chartjs.org" rel="nofollow ugc">Chart.js</a> (MIT License).</li>
<li>All translators at Transifex and WordPress.</li>
<li>Anyone who donates to the WP-Matomo project, including the Matomo team!</li>
<li>All users who send me mails containing criticism, commendation, feature requests and bug reports – you help me to make WP-Matomo much better!</li>
</ul>
<p>Thank you all!</p>


Connect Matomo – Analytics Dashboard for WordPress

This plugin does what it claims very easily.  But also gives a lot of options if you want to customize your tracking.

Well designed plugin

Adds Matomo (former Piwik) statistics to your WordPress dashboard and is also able to add the Matomo Tracking Code to your blog.

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 …

Connect Matomo – Analytics Dashboard for WordPress vs Pagemetrics for Matomo