| 1 |
=== Include Matomo === |
| 2 |
Contributors: jonashellmann |
| 3 |
Donate link: |
| 4 |
Tags: matomo, analytics, tracking |
| 5 |
Requires at least: 2.7 |
| 6 |
Tested up to: 4.9.5 |
| 7 |
Stable tag: trunk |
| 8 |
Requires PHP: 7.2 |
| 9 |
License: GPLv3 |
| 10 |
License URI: https://www.gnu.org/licenses/gpl-3.0.html |
| 11 |
|
| 12 |
This plugin includes Matomo into your Wordpress site. Therefore it adds the |
| 13 |
Matomo tracking to your site and it's capable of adding a Matomo campaign to |
| 14 |
your RSS feeds. |
| 15 |
|
| 16 |
== Description == |
| 17 |
|
| 18 |
Matomo, formerly called Piwik, is an self-hosted open-source tool to analyze |
| 19 |
your pages. It needs a tracking code to be included in the pages that should be |
| 20 |
monitored. Also campaigns can be created by using specific parameters in the |
| 21 |
URL. |
| 22 |
|
| 23 |
Therefore in this plugin You can configure the URL where Matomo is hosted and |
| 24 |
the site ID for tracking your Wordpress page. You can find it in the tracking |
| 25 |
code. You only need to fill in these both information. The rest of the tracking |
| 26 |
code is standartized and automatically inserted in the page. |
| 27 |
Also you can set a campaign name (pk_campaign) and source (pk_source) which |
| 28 |
will be adds to the links in your RSS feed. This helps you to analyze how many |
| 29 |
users enter your pages by using your RSS feed. |
| 30 |
|
| 31 |
== Installation == |
| 32 |
|
| 33 |
This section describes how to install the plugin and get it working. |
| 34 |
|
| 35 |
1. Upload the plugin files to the `/wp-content/plugins/include-matomo` directory, or install the plugin through the WordPress plugins screen directly. |
| 36 |
1. Activate the plugin through the 'Plugins' screen in WordPress. |
| 37 |
1. Use the 'Settings' -> 'Include Matomo' screen to configure the plugin. Look |
| 38 |
in the description to understand the configuration options. |
| 39 |
1. (Make your instructions match the desired user flow for activating and installing your plugin. Include any steps that might be needed for explanatory purposes) |
| 40 |
|
| 41 |
== Frequently Asked Questions == |
| 42 |
|
| 43 |
= Why can't I see page views in the Matomo backend? = |
| 44 |
|
| 45 |
Take a look at the source code of your Wordpress page and make sure that the |
| 46 |
Matomo code is actually included. It will only be injected if the URL to the |
| 47 |
Matomo installation AND the page ID are set. |
| 48 |
|
| 49 |
If it is injected you also should check if the page ID is set correctly. |
| 50 |
|
| 51 |
== Screenshots == |
| 52 |
|
| 53 |
1. Here you can see the settings page of 'Include Matomo'. You can find it |
| 54 |
under 'Settings' -> 'Include Matomo'. |
| 55 |
2. If you provide a Matomo URL and site ID this code is injected to your |
| 56 |
Wordpress page.. |
| 57 |
|
| 58 |
== Changelog == |
| 59 |
|
| 60 |
= 1.0 = |
| 61 |
* This is the initial version of the plugin. |
| 62 |
|
| 63 |
== Upgrade Notice == |
| 64 |
|
| 65 |
= 1.0 = |
| 66 |
No upgrade necessary at this point. Just install it. :-) |
| 67 |
|
