You can integrate Matomo with all popular CMS like WordPress, Drupal, Joomla, and Sharepoint: Matomo can work on a variety of platforms from PHP, Android, IOS, C#, Ruby, Node.js to Microsoft Silverlight. Check out the integration module for more details. For custom integration, you would need to use ‘Matomo Analytics for Enterprise’. Matomo Analytics module makes it easy to add Matomo tracking code into your Drupal website and start tracking your visitors behaviour instantly. Even the users who don’t have any technical experience will be able to achieve this with ease. You’ll need Matomo (Cloud or Self-hosted) and Drupal.
If you are not yet using Matomo On-Premise, Matomo Cloud or hosting your own instance of Matomo, please use the Matomo for WordPress plugin.
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.
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 self-hosted Matomo or a cloud-hosted Matomo by InnoCraft.
Requirements: PHP 7.0 (or higher), WordPress 5.0 (or higher), Matomo 3.0 (or higher)
Languages: 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
What is Matomo?
- Learn how to install your own Matomo instance: Requirements, Installation.
- If you need support about Matomo, please have a look at the Matomo forums.
- Finally, you can start setting up WP-Matomo.
You can use following shortcodes if activated:
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.
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.
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).
is equal to [wp-piwik module=”overview” title=”” period=”day” date=”yesterday”].
- Graphs powered by jqPlot (GPL 2.0 and MIT) and and jQuery Sparklines (New BSD License).
- All translators at Transifex and WordPress.
- Donations: Marco L., Rolf W., Tobias U., Lars K., Donna F., Kevin D., Ramos S., Thomas M., John C., Andreas G., Ben M., Myra R. I., Carlos U. R.-S., Oleg I., M. N., Daniel K., James L., Jochen K., Cyril P., Thomas K., Patrik K., Zach, Sebastian W., Peakkom, Patrik K., Kati K., Helmut O., Valerie S., Jochen D., Atlas R., Harald W., Jan M., Addy K., Hans-Georg E.-B., Yvonne K., Andrew D., Nicolas J., Andre M., Steve J., Jakub P., ditho.berlin, Robert R., Simon B., Grzegorz O., Bjarne O., Georg H., Tino S., Carola H., Bo K. C., Timothy T., Heinz L., the Matomo team itself, and all people flattering this.
- All users who send me mails containing criticism, commendation, feature requests and bug reports – you help me to make WP-Matomo much better!
Thank you all!
- First, you have to set up a running Matomo instance. You can get Matomo here and its documentation here.
- If you want to update your Matomo instance, you should set your WordPress blog to maintenance while the update process is running.
Install WP-Matomo on a simple WordPress blog
- Upload the full
wp-piwikdirectory into your
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- Open the new ‘Settings/WP-Matomo (WP-Piwik) Settings’ menu and follow the instructions to configure your Matomo connection. Save settings.
- If you have view access to multiple site stats and did not enable “auto config”, choose your blog and save settings again.
- Look at ‘Dashboard/WP-Matomo (WP-Piwik)’ to see your site stats.
Install WP-Matomo on a WordPress blog network (WPMU/WP multisite)
There are two differents methods to use WP-Matomo in a multisite environment:
- As a Site Specific Plugin it behaves like a plugin installed on a simple WordPress blog. Each user can enable, configure and use WP-Matomo on his own. Users can even use their own Matomo instances (and accordingly they have to).
- Using WP-Matomo as a Network Plugin equates to a central approach. A single Matomo instance is used and the site admin configures the plugin completely. Users are just allowed to see their own statistics, site admins can see each blog’s stats.
Site Specific Plugin
Just add WP-Matomo to your /wp-content/plugins folder and enable the Plugins page for individual site administrators. Each user has to enable and configure WP-Matomo on his own if he want to use the plugin.
The Network Plugin support is still experimental. Please test it on your own (e.g. using a local copy of your WP multisite) before you use it in an user context.
Add WP-Matomo to your /wp-content/plugins folder and enable it as Network Plugin. Users can access their own statistics, site admins can access each blog’s statistics and the plugin’s configuration.
Where can I find the Matomo URL and the Matomo auth token?
To use this plugin you will need your own Matomo instance. If you do not already have a Matomo setup, you have two simple options: use either a self-hosted Matomo or cloud-hosted Matomo by InnoCraft.
As soon as Matomo works, you’ll be able to configure WP-Matomo: The Matomo URL is the same URL you use to access your Matomo, e.g. for the demo site: http://demo.matomo.org. The auth token is some kind of a secret password, which allows WP-Matomo to get the necessary data from Matomo. To get your auth token, log in to Matomo, click at the preferences gear icon (top right) and click at “API” (left sidebar menu, near the bottom).
You can get a more detailed description here: https://matomo.org/blog/2015/05/wordpress-integration-wp-piwik-1-0/
I get this message: “WP-Matomo (WP-Piwik) was not able to connect to Matomo (Piwik) using our configuration”. How to proceed?
First, please make sure your configuration is valid, e.g., if you are using the right Matomo URL (see description above). Then, go to the “Support” tab and run the test script. This test script will try to get some information from Matomo and shows the full response. Usually, the response output gives a clear hint what’s wrong:
The response output contains…
* bool(false) and HTTP/1.1 403 ForbiddenThe power of nunchi pdf. : WP-Matomo is not allowed to connect to Matomo. Please check your Matomo server’s configuration. Maybe you are using a password protection via .htaccess or you are blocking requests from localhost/127.0.0.1. If you aren’t sure about this, please contact your web hoster for support.
* bool(false) and HTTP/1.1 404 Not Found: The Matomo URL is wrong. Try to copy & paste the URL you use to access Matomo itself via browser.
* bool(false) and no further HTTP response code: The Matomo server does not respond. Very often, this is caused by firewall or mod_security settings. Check your server logfiles to get further information. If you aren’t sure about this, please contact your web hoster for support.
PHP Compatibility Checker reports PHP7 compatbility issues with WP-Matomo.
The Compatibility Checker shows two false positives. WP-Matomo is 100% PHP7 compatible, you can ignore the report.
Overview shortcode shows no unique visitors using a yearly range.
See Matomo FAQ.
WP-Matomo only shows the first 100 sites of my multisite network. How can I get all other sites?
The Matomo API is limited to 100 sites by default. Add the following line to the section [General] of Matomo’s config/config.ini.php file:
Tracking does not work on HostGator!
Try to enable the “avoid mod_security” option (WP-Matomo settings, Tracking tab) or create a mod_security whitelist.
Can I contribute to WP-Matomo as a translator?
You like to contribute to WP-Matomo translations? Please use the Transifex translation community.
Of course, I will add missing languages if requested, and I will also upload the existing language files of older WP-Matomo releases.
Matomo Drupal Login
If you can’t (or don not want to) use transifex, you can also translate languages/wp-piwik.pot delivered with WP-Matomo.
Thank you very much! 🙂