Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/matomo-org/matomo.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefan Giehl <stefan@matomo.org>2021-01-05 03:41:51 +0300
committerGitHub <noreply@github.com>2021-01-05 03:41:51 +0300
commitda9c6159702a228c1d50b65b87dd416730c092b0 (patch)
tree668f98c9bdba618df86556fa0afc014a8591e244
parent6f60a5ebfa306e66055cf76d0f98d1b5f2f127be (diff)
Adds missing report documentations (#16878)
* Fix report documentation not shown when switching between related reports * Adds report documentation for DevicesDetection reports * Adds some more report documentations * Adds documentation to Event reports * Adds documentation to Content reports * Adds documentation to VisitorFrequency report * Adds documentation to Goals reports * Adds documentation to VisitsSummary report * fixes & test updates * fix typo Co-authored-by: Lukas Winkler <git@lw1.at> * small tweaks to some docs * revising some of the report documentation * fix translation file * updates expected test files Co-authored-by: Lukas Winkler <git@lw1.at> Co-authored-by: diosmosis <diosmosis@users.noreply.github.com>
-rw-r--r--plugins/API/Reports/Get.php2
-rw-r--r--plugins/API/lang/en.json1
-rw-r--r--plugins/Actions/Reports/Get.php2
-rw-r--r--plugins/Actions/lang/en.json1
-rw-r--r--plugins/Contents/Reports/GetContentNames.php3
-rw-r--r--plugins/Contents/Reports/GetContentPieces.php3
-rw-r--r--plugins/Contents/lang/en.json2
-rwxr-xr-xplugins/Contents/tests/System/expected/test_Contents_Contents.getContentNames_lastN__API.getProcessedReport_day.xml1
-rwxr-xr-xplugins/Contents/tests/System/expected/test_Contents_Contents.getContentPieces_lastN__API.getProcessedReport_day.xml1
-rw-r--r--plugins/CoreHome/javascripts/dataTable.js11
-rw-r--r--plugins/CustomDimensions/tests/System/expected/test___API.getReportMetadata_day.xml36
-rw-r--r--plugins/DevicesDetection/Reports/GetBrand.php2
-rw-r--r--plugins/DevicesDetection/Reports/GetBrowserVersions.php2
-rw-r--r--plugins/DevicesDetection/Reports/GetBrowsers.php2
-rw-r--r--plugins/DevicesDetection/Reports/GetModel.php2
-rw-r--r--plugins/DevicesDetection/Reports/GetOsFamilies.php2
-rw-r--r--plugins/DevicesDetection/Reports/GetOsVersions.php2
-rw-r--r--plugins/DevicesDetection/Reports/GetType.php2
-rw-r--r--plugins/DevicesDetection/lang/en.json8
-rw-r--r--plugins/Ecommerce/tests/System/expected/test_ecommerceOrderWithItems_Metadata_Goals.Get_NormalGoal__API.getProcessedReport_day.xml1
-rw-r--r--plugins/Events/Reports/GetAction.php2
-rw-r--r--plugins/Events/Reports/GetCategory.php2
-rw-r--r--plugins/Events/Reports/GetName.php2
-rw-r--r--plugins/Events/lang/en.json3
-rw-r--r--plugins/ExampleUI/Reports/GetPlanetRatios.php1
-rw-r--r--plugins/ExampleUI/Reports/GetPlanetRatiosWithLogos.php1
-rw-r--r--plugins/ExampleUI/Reports/GetTemperatures.php1
-rw-r--r--plugins/ExampleUI/Reports/GetTemperaturesEvolution.php1
-rw-r--r--plugins/Goals/Reports/Get.php2
-rw-r--r--plugins/Goals/Reports/GetDaysToConversion.php1
-rw-r--r--plugins/Goals/Reports/GetVisitsUntilConversion.php1
-rw-r--r--plugins/Goals/lang/en.json5
-rw-r--r--plugins/MultiSites/Reports/GetAll.php2
-rw-r--r--plugins/MultiSites/Reports/GetOne.php2
-rw-r--r--plugins/MultiSites/lang/en.json4
-rw-r--r--plugins/PagePerformance/Reports/Get.php2
-rw-r--r--plugins/PagePerformance/lang/en.json1
-rw-r--r--plugins/Referrers/Reports/Get.php2
-rw-r--r--plugins/Referrers/lang/en.json1
-rw-r--r--plugins/Resolution/Reports/GetResolution.php2
-rw-r--r--plugins/Resolution/lang/en.json3
-rw-r--r--plugins/UserId/Reports/GetUsers.php2
-rw-r--r--plugins/UserId/lang/en.json1
-rw-r--r--plugins/VisitFrequency/Reports/Get.php4
-rw-r--r--plugins/VisitFrequency/lang/en.json3
-rw-r--r--plugins/VisitsSummary/Reports/Get.php2
-rw-r--r--plugins/VisitsSummary/lang/en.json1
-rw-r--r--tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_flat__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_flat__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_flat__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_DataComparisonTest_processedReport__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_OneVisitorTwoVisits_showColumns_onlyOne__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_month.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_Goals.getDaysToConversion_firstSite_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_MultiSites.getAll_firstSite_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitFrequency.get_firstSite_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitsSummary.get_firstSite_lastN__API.getProcessedReport_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getGlossaryReports.xml183
-rw-r--r--tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getReportMetadata_day.xml42
-rw-r--r--tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getMetadata_day.xml1
-rw-r--r--tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getProcessedReport_day.xml1
65 files changed, 347 insertions, 34 deletions
diff --git a/plugins/API/Reports/Get.php b/plugins/API/Reports/Get.php
index 5c85086f6e..52397251c1 100644
--- a/plugins/API/Reports/Get.php
+++ b/plugins/API/Reports/Get.php
@@ -32,7 +32,7 @@ class Get extends Report
$this->categoryId = 'API';
$this->name = Piwik::translate('General_MainMetrics');
- $this->documentation = '';
+ $this->documentation = Piwik::translate('API_MainMetricsReportDocumentation');
$this->processedMetrics = array();
foreach ($this->reportsToMerge as $report) {
diff --git a/plugins/API/lang/en.json b/plugins/API/lang/en.json
index cc43b92313..5b93cfff98 100644
--- a/plugins/API/lang/en.json
+++ b/plugins/API/lang/en.json
@@ -11,6 +11,7 @@
"UserAuthentication": "User authentication",
"UsingTokenAuth": "If you want to %1$s request data within a script, a crontab, etc. %2$s you need to add the URL parameter %3$s to the API calls URLs that require authentication.",
"Glossary": "Glossary",
+ "MainMetricsReportDocumentation": "This report gives you an overview over the most important metrics across all categories and plugins.",
"LearnAboutCommonlyUsedTerms2": "Learn about the commonly used terms to make the most of Matomo Analytics.",
"EvolutionMetricName": "%s Evolution"
}
diff --git a/plugins/Actions/Reports/Get.php b/plugins/Actions/Reports/Get.php
index 0fa9429673..8e08749201 100644
--- a/plugins/Actions/Reports/Get.php
+++ b/plugins/Actions/Reports/Get.php
@@ -18,7 +18,7 @@ class Get extends Base
parent::init();
$this->name = Piwik::translate('General_Actions') . ' - ' . Piwik::translate('General_MainMetrics');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('Actions_MainMetricsReportDocumentation');
$this->order = 1;
$this->processedMetrics = array(
new AveragePageGenerationTime()
diff --git a/plugins/Actions/lang/en.json b/plugins/Actions/lang/en.json
index af73c89f44..2616af09ba 100644
--- a/plugins/Actions/lang/en.json
+++ b/plugins/Actions/lang/en.json
@@ -41,6 +41,7 @@
"ExitPagesReportDocumentation": "This report contains information about the exit pages that occurred during the specified period. An exit page is the last page that a user views during their visit. %s The exit URLs are displayed as a folder structure.",
"ExitPageTitles": "Exit page titles",
"ExitPageTitlesReportDocumentation": "This report contains information about the titles of exit pages that occurred during the specified period.",
+ "MainMetricsReportDocumentation": "This report provides a very basic overview of what actions your visitors take on your website.",
"OneSearch": "1 search",
"OutlinkDocumentation": "An outlink is a link that leads the visitor away from your website (to another domain).",
"OutlinksReportDocumentation": "This report shows a hierarchical list of outlink URLs that were clicked by your visitors.",
diff --git a/plugins/Contents/Reports/GetContentNames.php b/plugins/Contents/Reports/GetContentNames.php
index 5042e5d014..8056f45297 100644
--- a/plugins/Contents/Reports/GetContentNames.php
+++ b/plugins/Contents/Reports/GetContentNames.php
@@ -24,8 +24,7 @@ class GetContentNames extends Base
parent::init();
$this->name = Piwik::translate('Contents_ContentName');
- $this->dimension = null;
- // TODO $this->documentation = Piwik::translate('ContentsDocumentation');
+ $this->documentation = Piwik::translate('Contents_ContentNameReportDocumentation');
$this->dimension = new ContentName();
$this->order = 35;
$this->actionToLoadSubTables = 'getContentNames';
diff --git a/plugins/Contents/Reports/GetContentPieces.php b/plugins/Contents/Reports/GetContentPieces.php
index ccf89c0196..4225c4d446 100644
--- a/plugins/Contents/Reports/GetContentPieces.php
+++ b/plugins/Contents/Reports/GetContentPieces.php
@@ -24,8 +24,7 @@ class GetContentPieces extends Base
parent::init();
$this->name = Piwik::translate('Contents_ContentPiece');
- $this->dimension = null;
- // TODO $this->documentation = Piwik::translate('ContentsDocumentation');
+ $this->documentation = Piwik::translate('Contents_ContentPieceReportDocumentation');
$this->dimension = new ContentPiece();
$this->order = 36;
$this->actionToLoadSubTables = 'getContentPieces';
diff --git a/plugins/Contents/lang/en.json b/plugins/Contents/lang/en.json
index e4bef887a0..5dd2ed0038 100644
--- a/plugins/Contents/lang/en.json
+++ b/plugins/Contents/lang/en.json
@@ -7,8 +7,10 @@
"ContentInteractions": "Content Interactions",
"InteractionRate": "Interaction Rate",
"ContentName": "Content Name",
+ "ContentNameReportDocumentation": "This report shows the names of the content your visitors viewed and interacted with.",
"ContentNames": "Content Names",
"ContentPiece": "Content Piece",
+ "ContentPieceReportDocumentation": "This report shows the pieces of content your visitors viewed and interacted with.",
"ContentPieces": "Content Pieces",
"ContentTarget": "Content Target",
"ContentTargets": "Content Targets",
diff --git a/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentNames_lastN__API.getProcessedReport_day.xml b/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentNames_lastN__API.getProcessedReport_day.xml
index 40bfde0e6c..2e6b89c715 100755
--- a/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentNames_lastN__API.getProcessedReport_day.xml
+++ b/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentNames_lastN__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Contents</module>
<action>getContentNames</action>
<dimension>Content Name</dimension>
+ <documentation>This report shows the names of the content your visitors viewed and interacted with.</documentation>
<onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
<metrics>
<nb_impressions>Impressions</nb_impressions>
diff --git a/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentPieces_lastN__API.getProcessedReport_day.xml b/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentPieces_lastN__API.getProcessedReport_day.xml
index 8d194b3c67..60e5b513c9 100755
--- a/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentPieces_lastN__API.getProcessedReport_day.xml
+++ b/plugins/Contents/tests/System/expected/test_Contents_Contents.getContentPieces_lastN__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Contents</module>
<action>getContentPieces</action>
<dimension>Content Piece</dimension>
+ <documentation>This report shows the pieces of content your visitors viewed and interacted with.</documentation>
<onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
<metrics>
<nb_impressions>Impressions</nb_impressions>
diff --git a/plugins/CoreHome/javascripts/dataTable.js b/plugins/CoreHome/javascripts/dataTable.js
index a39014d4c6..db7f781bf3 100644
--- a/plugins/CoreHome/javascripts/dataTable.js
+++ b/plugins/CoreHome/javascripts/dataTable.js
@@ -1692,7 +1692,18 @@ $.extend(DataTable.prototype, UIControl.prototype, {
if (scope) {
var $doc = domElem.find('.reportDocumentation');
if ($doc.length) {
+ // hackish solution to get binded html of p tag within the help node
+ // at this point the ng-bind-html is not yet converted into html when report is not
+ // initially loaded. Using $compile doesn't work. So get and set it manually
+ var helpParagraph = $('p[ng-bind-html]', $doc);
+
+ if (helpParagraph.length) {
+ var $parse = angular.element(document).injector().get('$parse');
+ helpParagraph.html($parse(helpParagraph.attr('ng-bind-html')));
+ }
+
scope.inlineHelp = $.trim($doc.html());
+
}
scope.featureName = $.trim(relatedReportName);
setTimeout(function (){
diff --git a/plugins/CustomDimensions/tests/System/expected/test___API.getReportMetadata_day.xml b/plugins/CustomDimensions/tests/System/expected/test___API.getReportMetadata_day.xml
index b17db7581b..d3fbfe272a 100644
--- a/plugins/CustomDimensions/tests/System/expected/test___API.getReportMetadata_day.xml
+++ b/plugins/CustomDimensions/tests/System/expected/test___API.getReportMetadata_day.xml
@@ -6,6 +6,7 @@
<module>MultiSites</module>
<action>getAll</action>
<dimension>Website</dimension>
+ <documentation>This report gives you an informational overview for each of your websites, containing the most general metrics about your visitors.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_actions>Actions</nb_actions>
@@ -39,6 +40,7 @@
<module>MultiSites</module>
<action>getOne</action>
<dimension>Website</dimension>
+ <documentation>This report gives you an informational overview for a specific website, containing the most general metrics about your visitors.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_actions>Actions</nb_actions>
@@ -72,6 +74,7 @@
<name>Visits Summary</name>
<module>VisitsSummary</module>
<action>get</action>
+ <documentation>This report provides a very general overview of how your visitors behave.</documentation>
<metrics>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
<nb_visits>Visits</nb_visits>
@@ -338,6 +341,7 @@
<module>DevicesDetection</module>
<action>getType</action>
<dimension>Device type</dimension>
+ <documentation>This report shows the types of devices your visitors were using. This report will always show all device types Matomo is able to detect, even if there were no visits with a specific type.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -377,6 +381,7 @@
<module>DevicesDetection</module>
<action>getModel</action>
<dimension>Device model</dimension>
+ <documentation>This report shows the devices your visitors are using. Each model is displayed combined with the device brand as some model names are used by multiple brands.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -416,6 +421,7 @@
<module>DevicesDetection</module>
<action>getBrand</action>
<dimension>Device brand</dimension>
+ <documentation>This report shows the brands / manufacturers of the devices your visitors were using. In most cases this information is only available for non-desktop devices.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -455,6 +461,7 @@
<module>Resolution</module>
<action>getResolution</action>
<dimension>Resolution</dimension>
+ <documentation>This report shows the screen resolutions your visitors used when viewing your website.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -495,6 +502,7 @@
<module>DevicesDetection</module>
<action>getOsVersions</action>
<dimension>Operating system version</dimension>
+ <documentation>This report shows you the operating systems your visitors are using. Each version and distribution is shown separately.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -535,7 +543,7 @@
<module>DevicesDetection</module>
<action>getBrowsers</action>
<dimension>Browser</dimension>
- <documentation>This report contains information about what kind of browser your visitors were using. Each browser version is listed separately.</documentation>
+ <documentation>This report contains information about what kind of browser your visitors were using.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -582,6 +590,7 @@
<module>DevicesDetection</module>
<action>getBrowserVersions</action>
<dimension>Browser version</dimension>
+ <documentation>This report contains information about what kind of browser your visitors were using. Each browser version is listed separately.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -663,6 +672,7 @@
<module>DevicesDetection</module>
<action>getOsFamilies</action>
<dimension>Operating system family</dimension>
+ <documentation>This report shows you the operating systems your visitors are using grouped by operating system family. An operating system family consists of different versions or distributions.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -880,6 +890,7 @@
<module>UserId</module>
<action>getUsers</action>
<dimension>UserId</dimension>
+ <documentation>This report shows visits and other general metrics for every individual User ID.</documentation>
<metrics>
<label>Label</label>
<nb_visits>Visits</nb_visits>
@@ -1048,6 +1059,7 @@
<name>Actions - Main metrics</name>
<module>Actions</module>
<action>get</action>
+ <documentation>This report provides a very basic overview of what actions your visitors take on your website.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>
@@ -1499,6 +1511,7 @@
<module>Events</module>
<action>getCategory</action>
<dimension>Event Category</dimension>
+ <documentation>This report shows the categories of each tracked event and how many times they occurred. You can view the event actions and names that were tracked along with each event category in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventCategory>Event Category</Events_EventCategory>
@@ -1534,6 +1547,7 @@
<module>Events</module>
<action>getAction</action>
<dimension>Event Action</dimension>
+ <documentation>This report shows you the number of times each event action occurred. You can view the event categories and names that were tracked along with each event action in the row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventAction>Event Action</Events_EventAction>
@@ -1569,6 +1583,7 @@
<module>Events</module>
<action>getName</action>
<dimension>Event Name</dimension>
+ <documentation>This report shows you the names associated with each tracked event and how many times they occurred. You can view the event actions and categories that were tracked along with each event name in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventName>Event Name</Events_EventName>
@@ -1604,6 +1619,7 @@
<module>Contents</module>
<action>getContentNames</action>
<dimension>Content Name</dimension>
+ <documentation>This report shows the names of the content your visitors viewed and interacted with.</documentation>
<onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
<metrics>
<nb_impressions>Impressions</nb_impressions>
@@ -1629,6 +1645,7 @@
<module>Contents</module>
<action>getContentPieces</action>
<dimension>Content Piece</dimension>
+ <documentation>This report shows the pieces of content your visitors viewed and interacted with.</documentation>
<onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
<metrics>
<nb_impressions>Impressions</nb_impressions>
@@ -1728,6 +1745,7 @@
<name>Returning Visits</name>
<module>VisitFrequency</module>
<action>get</action>
+ <documentation>This report shows general metrics like visits for returning visitors side by side with the same metrics for new visitors. Learn how returning visitors perform overall compared to new visitors.</documentation>
<metrics>
<nb_visits_returning>Returning Visits</nb_visits_returning>
<nb_actions_returning>Actions by Returning Visits</nb_actions_returning>
@@ -1758,6 +1776,7 @@
<name>Performance overview</name>
<module>PagePerformance</module>
<action>get</action>
+ <documentation>This report provides an overview of how fast your webpages become visible to your visitors. This includes both how long it takes for browsers to download your webpages and how long it takes for browsers to display them.</documentation>
<onlineGuideUrl>https://matomo.org/faq/how-to/how-do-i-see-page-performance-reports/</onlineGuideUrl>
<metrics>
<avg_time_network>Avg. network time</avg_time_network>
@@ -1859,6 +1878,7 @@
<name>Referrers Overview</name>
<module>Referrers</module>
<action>get</action>
+ <documentation>This report shows what acquisition channels your visitors used to get to your website, and the number of visits each channel type is responsible for.</documentation>
<metrics>
<Referrers_visitorsFromSearchEngines>Visitors from Search Engines</Referrers_visitorsFromSearchEngines>
<Referrers_visitorsFromSearchEngines_percent>Percent of Visitors from Search Engines</Referrers_visitorsFromSearchEngines_percent>
@@ -2179,6 +2199,7 @@
<name>Goals</name>
<module>Goals</module>
<action>get</action>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2201,6 +2222,7 @@
<module>Goals</module>
<action>getVisitsUntilConversion</action>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2222,6 +2244,7 @@
<module>Goals</module>
<action>getDaysToConversion</action>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2245,6 +2268,7 @@
<parameters>
<idGoal>0</idGoal>
</parameters>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2270,6 +2294,7 @@
<idGoal>0</idGoal>
</parameters>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2287,6 +2312,7 @@
<idGoal>0</idGoal>
</parameters>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2303,6 +2329,7 @@
<parameters>
<idGoal>1</idGoal>
</parameters>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2328,6 +2355,7 @@
<idGoal>1</idGoal>
</parameters>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2345,6 +2373,7 @@
<idGoal>1</idGoal>
</parameters>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2359,6 +2388,7 @@
<name>Data tables</name>
<module>ExampleUI</module>
<action>getTemperatures</action>
+ <documentation>This is an example documentation of a report.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2390,6 +2420,7 @@
<name>Temperatures evolution over time</name>
<module>ExampleUI</module>
<action>getTemperaturesEvolution</action>
+ <documentation>This is an example evolution report</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2422,6 +2453,7 @@
<name>Pie graph</name>
<module>ExampleUI</module>
<action>getPlanetRatios</action>
+ <documentation>This report shows a sample Pie chart</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2454,6 +2486,7 @@
<name>Advanced tag cloud: with logos and links</name>
<module>ExampleUI</module>
<action>getPlanetRatiosWithLogos</action>
+ <documentation>This report shows a sample tab cloud.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2485,6 +2518,7 @@
<name>Main metrics</name>
<module>API</module>
<action>get</action>
+ <documentation>This report gives you an overview over the most important metrics across all categories and plugins.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>
diff --git a/plugins/DevicesDetection/Reports/GetBrand.php b/plugins/DevicesDetection/Reports/GetBrand.php
index 7fc5a20066..c01a9e2afb 100644
--- a/plugins/DevicesDetection/Reports/GetBrand.php
+++ b/plugins/DevicesDetection/Reports/GetBrand.php
@@ -19,7 +19,7 @@ class GetBrand extends Base
parent::init();
$this->dimension = new DeviceBrand();
$this->name = Piwik::translate('DevicesDetection_DeviceBrand');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('DevicesDetection_DeviceBrandReportDocumentation');
$this->order = 4;
$this->hasGoalMetrics = true;
$this->subcategoryId = 'DevicesDetection_Devices';
diff --git a/plugins/DevicesDetection/Reports/GetBrowserVersions.php b/plugins/DevicesDetection/Reports/GetBrowserVersions.php
index 4be7c15705..bcfc0b799c 100644
--- a/plugins/DevicesDetection/Reports/GetBrowserVersions.php
+++ b/plugins/DevicesDetection/Reports/GetBrowserVersions.php
@@ -20,7 +20,7 @@ class GetBrowserVersions extends Base
parent::init();
$this->dimension = new BrowserVersion();
$this->name = Piwik::translate('DevicesDetection_BrowserVersion');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('DevicesDetection_WidgetBrowserVersionsDocumentation');
$this->order = 6;
$this->subcategoryId = 'DevicesDetection_Software';
}
diff --git a/plugins/DevicesDetection/Reports/GetBrowsers.php b/plugins/DevicesDetection/Reports/GetBrowsers.php
index 4b0b35fec9..1b511a8be1 100644
--- a/plugins/DevicesDetection/Reports/GetBrowsers.php
+++ b/plugins/DevicesDetection/Reports/GetBrowsers.php
@@ -20,7 +20,7 @@ class GetBrowsers extends Base
parent::init();
$this->dimension = new BrowserName();
$this->name = Piwik::translate('DevicesDetection_Browsers');
- $this->documentation = Piwik::translate('DevicesDetection_WidgetBrowsersDocumentation', '<br />');
+ $this->documentation = Piwik::translate('DevicesDetection_WidgetBrowsersDocumentation');
$this->order = 5;
$this->subcategoryId = 'DevicesDetection_Software';
$this->hasGoalMetrics = true;
diff --git a/plugins/DevicesDetection/Reports/GetModel.php b/plugins/DevicesDetection/Reports/GetModel.php
index 6fb6682ee2..cf79fd8caa 100644
--- a/plugins/DevicesDetection/Reports/GetModel.php
+++ b/plugins/DevicesDetection/Reports/GetModel.php
@@ -19,7 +19,7 @@ class GetModel extends Base
parent::init();
$this->dimension = new DeviceModel();
$this->name = Piwik::translate('DevicesDetection_DeviceModel');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('DevicesDetection_DeviceModelReportDocumentation');
$this->order = 2;
$this->hasGoalMetrics = true;
$this->subcategoryId = 'DevicesDetection_Devices';
diff --git a/plugins/DevicesDetection/Reports/GetOsFamilies.php b/plugins/DevicesDetection/Reports/GetOsFamilies.php
index 0ac56d7250..1efe491621 100644
--- a/plugins/DevicesDetection/Reports/GetOsFamilies.php
+++ b/plugins/DevicesDetection/Reports/GetOsFamilies.php
@@ -20,7 +20,7 @@ class GetOsFamilies extends Base
parent::init();
$this->dimension = new Os();
$this->name = Piwik::translate('DevicesDetection_OperatingSystemFamilies');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('DevicesDetection_OperatingSystemFamiliesReportDocumentation');
$this->order = 8;
$this->subcategoryId = 'DevicesDetection_Software';
diff --git a/plugins/DevicesDetection/Reports/GetOsVersions.php b/plugins/DevicesDetection/Reports/GetOsVersions.php
index 8dcc2f5fab..39f7625d05 100644
--- a/plugins/DevicesDetection/Reports/GetOsVersions.php
+++ b/plugins/DevicesDetection/Reports/GetOsVersions.php
@@ -20,7 +20,7 @@ class GetOsVersions extends Base
parent::init();
$this->dimension = new OsVersion();
$this->name = Piwik::translate('DevicesDetection_OperatingSystemVersions');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('DevicesDetection_OperatingSystemVersionsReportDocumentation');
$this->order = 2;
$this->subcategoryId = 'DevicesDetection_Software';
diff --git a/plugins/DevicesDetection/Reports/GetType.php b/plugins/DevicesDetection/Reports/GetType.php
index 22fe00de34..6ebb6b4b11 100644
--- a/plugins/DevicesDetection/Reports/GetType.php
+++ b/plugins/DevicesDetection/Reports/GetType.php
@@ -20,7 +20,7 @@ class GetType extends Base
parent::init();
$this->dimension = new DeviceType();
$this->name = Piwik::translate('DevicesDetection_DeviceType');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('DevicesDetection_DeviceTypeReportDocumentation');
$this->order = 0;
$this->hasGoalMetrics = true;
$this->subcategoryId = 'DevicesDetection_Devices';
diff --git a/plugins/DevicesDetection/lang/en.json b/plugins/DevicesDetection/lang/en.json
index 934c11a1fe..0f3bab1421 100644
--- a/plugins/DevicesDetection/lang/en.json
+++ b/plugins/DevicesDetection/lang/en.json
@@ -25,18 +25,23 @@
"Device": "Device",
"DeviceBrand": "Device brand",
"DeviceBrands": "Device brands",
+ "DeviceBrandReportDocumentation": "This report shows the brands / manufacturers of the devices your visitors were using. In most cases this information is only available for non-desktop devices.",
"DeviceDetection": "Device detection",
"DeviceModel": "Device model",
"DeviceModels": "Device models",
+ "DeviceModelReportDocumentation": "This report shows the devices your visitors are using. Each model is displayed combined with the device brand as some model names are used by multiple brands.",
"DevicesDetection": "Visitor Devices",
"DeviceType": "Device type",
"DeviceTypes": "Device types",
+ "DeviceTypeReportDocumentation": "This report shows the types of devices your visitors were using. This report will always show all device types Matomo is able to detect, even if there were no visits with a specific type.",
"FeaturePhone": "Feature phone",
"OperatingSystemFamilies": "Operating System families",
"OperatingSystemFamily": "Operating system family",
+ "OperatingSystemFamiliesReportDocumentation": "This report shows you the operating systems your visitors are using grouped by operating system family. An operating system family consists of different versions or distributions.",
"OperatingSystemCode": "Operating system code",
"OperatingSystems": "Operating systems",
"OperatingSystemVersions": "Operating System versions",
+ "OperatingSystemVersionsReportDocumentation": "This report shows you the operating systems your visitors are using. Each version and distribution is shown separately.",
"PluginDescription": "Provides extended information about user devices, such as Brand (manufacturer), Model (device version), device type (tv, consoles, smart phones, desktop, etc) and more.",
"SmartDisplay": "Smart display",
"Smartphone": "Smartphone",
@@ -58,6 +63,7 @@
"XVisitsFromDevices": "%1$s visits from %2$s devices",
"Wearable": "Wearable",
"WidgetBrowsers": "Visitor Browser",
- "WidgetBrowsersDocumentation": "This report contains information about what kind of browser your visitors were using. Each browser version is listed separately."
+ "WidgetBrowsersDocumentation": "This report contains information about what kind of browser your visitors were using.",
+ "WidgetBrowserVersionsDocumentation": "This report contains information about what kind of browser your visitors were using. Each browser version is listed separately."
}
} \ No newline at end of file
diff --git a/plugins/Ecommerce/tests/System/expected/test_ecommerceOrderWithItems_Metadata_Goals.Get_NormalGoal__API.getProcessedReport_day.xml b/plugins/Ecommerce/tests/System/expected/test_ecommerceOrderWithItems_Metadata_Goals.Get_NormalGoal__API.getProcessedReport_day.xml
index 4e7fbd5d8a..5424967814 100644
--- a/plugins/Ecommerce/tests/System/expected/test_ecommerceOrderWithItems_Metadata_Goals.Get_NormalGoal__API.getProcessedReport_day.xml
+++ b/plugins/Ecommerce/tests/System/expected/test_ecommerceOrderWithItems_Metadata_Goals.Get_NormalGoal__API.getProcessedReport_day.xml
@@ -10,6 +10,7 @@
<parameters>
<idGoal>1</idGoal>
</parameters>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
diff --git a/plugins/Events/Reports/GetAction.php b/plugins/Events/Reports/GetAction.php
index aac77c196e..e459c35478 100644
--- a/plugins/Events/Reports/GetAction.php
+++ b/plugins/Events/Reports/GetAction.php
@@ -19,7 +19,7 @@ class GetAction extends Base
parent::init();
$this->dimension = new EventAction();
$this->name = Piwik::translate('Events_EventActions');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('Events_EventActionsReportDocumentation');
$this->metrics = array('nb_events', 'sum_event_value', 'min_event_value', 'max_event_value', 'nb_events_with_value');
if (Common::getRequestVar('secondaryDimension', false) == 'eventCategory') {
$this->actionToLoadSubTables = 'getCategoryFromNameId';
diff --git a/plugins/Events/Reports/GetCategory.php b/plugins/Events/Reports/GetCategory.php
index 520bf16962..1052ea5a3b 100644
--- a/plugins/Events/Reports/GetCategory.php
+++ b/plugins/Events/Reports/GetCategory.php
@@ -19,7 +19,7 @@ class GetCategory extends Base
parent::init();
$this->dimension = new EventCategory();
$this->name = Piwik::translate('Events_EventCategories');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('Events_EventCategoriesReportDocumentation');
$this->metrics = array('nb_events', 'sum_event_value', 'min_event_value', 'max_event_value', 'nb_events_with_value');
if (Common::getRequestVar('secondaryDimension', false) == 'eventName') {
$this->actionToLoadSubTables = 'getNameFromCategoryId';
diff --git a/plugins/Events/Reports/GetName.php b/plugins/Events/Reports/GetName.php
index 9c009743f6..2d9fafc1f0 100644
--- a/plugins/Events/Reports/GetName.php
+++ b/plugins/Events/Reports/GetName.php
@@ -19,7 +19,7 @@ class GetName extends Base
parent::init();
$this->dimension = new EventName();
$this->name = Piwik::translate('Events_EventNames');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('Events_EventNamesReportDocumentation');
$this->metrics = array('nb_events', 'sum_event_value', 'min_event_value', 'max_event_value', 'nb_events_with_value');
if (Common::getRequestVar('secondaryDimension', false) == 'eventCategory') {
$this->actionToLoadSubTables = 'getCategoryFromNameId';
diff --git a/plugins/Events/lang/en.json b/plugins/Events/lang/en.json
index 9cc8e7f0bf..fdbcdbb6e6 100644
--- a/plugins/Events/lang/en.json
+++ b/plugins/Events/lang/en.json
@@ -8,10 +8,13 @@
"Event": "Event",
"EventAction": "Event Action",
"EventActions": "Event Actions",
+ "EventActionsReportDocumentation": "This report shows you the number of times each event action occurred. You can view the event categories and names that were tracked along with each event action in the row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.",
"EventCategories": "Event Categories",
+ "EventCategoriesReportDocumentation": "This report shows the categories of each tracked event and how many times they occurred. You can view the event actions and names that were tracked along with each event category in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.",
"EventCategory": "Event Category",
"EventName": "Event Name",
"EventNames": "Event Names",
+ "EventNamesReportDocumentation": "This report shows you the names associated with each tracked event and how many times they occurred. You can view the event actions and categories that were tracked along with each event name in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.",
"EventUrl": "Event URL",
"EventUrls": "Event URLs",
"Events": "Events",
diff --git a/plugins/ExampleUI/Reports/GetPlanetRatios.php b/plugins/ExampleUI/Reports/GetPlanetRatios.php
index 9051702a03..c1e9a4ae01 100644
--- a/plugins/ExampleUI/Reports/GetPlanetRatios.php
+++ b/plugins/ExampleUI/Reports/GetPlanetRatios.php
@@ -26,6 +26,7 @@ class GetPlanetRatios extends Base
parent::init();
$this->name = 'Pie graph';
+ $this->documentation = 'This report shows a sample Pie chart';
$this->subcategoryId = $this->name;
$this->order = 112;
}
diff --git a/plugins/ExampleUI/Reports/GetPlanetRatiosWithLogos.php b/plugins/ExampleUI/Reports/GetPlanetRatiosWithLogos.php
index 6f04eb2c94..fbee4427cb 100644
--- a/plugins/ExampleUI/Reports/GetPlanetRatiosWithLogos.php
+++ b/plugins/ExampleUI/Reports/GetPlanetRatiosWithLogos.php
@@ -25,6 +25,7 @@ class GetPlanetRatiosWithLogos extends Base
parent::init();
$this->name = Piwik::translate('Advanced tag cloud: with logos and links');
+ $this->documentation = 'This report shows a sample tab cloud.';
$this->subcategoryId = 'Tag clouds';
$this->order = 113;
}
diff --git a/plugins/ExampleUI/Reports/GetTemperatures.php b/plugins/ExampleUI/Reports/GetTemperatures.php
index 93ff8ce27b..83e9a1913a 100644
--- a/plugins/ExampleUI/Reports/GetTemperatures.php
+++ b/plugins/ExampleUI/Reports/GetTemperatures.php
@@ -27,6 +27,7 @@ class GetTemperatures extends Base
parent::init();
$this->name = Piwik::translate('ExampleUI_GetTemperaturesDataTable');
+ $this->documentation = 'This is an example documentation of a report.';
$this->subcategoryId = 'ExampleUI_GetTemperaturesDataTable';
$this->order = 110;
}
diff --git a/plugins/ExampleUI/Reports/GetTemperaturesEvolution.php b/plugins/ExampleUI/Reports/GetTemperaturesEvolution.php
index 890359711f..a2b9aeb3ee 100644
--- a/plugins/ExampleUI/Reports/GetTemperaturesEvolution.php
+++ b/plugins/ExampleUI/Reports/GetTemperaturesEvolution.php
@@ -33,6 +33,7 @@ class GetTemperaturesEvolution extends Base
parent::init();
$this->name = Piwik::translate('ExampleUI_GetTemperaturesEvolution');
+ $this->documentation = 'This is an example evolution report';
$this->order = 111;
}
diff --git a/plugins/Goals/Reports/Get.php b/plugins/Goals/Reports/Get.php
index 0ec4280685..c29bdf4426 100644
--- a/plugins/Goals/Reports/Get.php
+++ b/plugins/Goals/Reports/Get.php
@@ -35,7 +35,7 @@ class Get extends Base
$this->name = Piwik::translate('Goals_Goals');
$this->processedMetrics = array('conversion_rate');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('Goals_OverviewReportDocumentation');
$this->order = 1;
$this->orderGoal = 50;
$this->metrics = array('nb_conversions', 'nb_visits_converted', 'revenue');
diff --git a/plugins/Goals/Reports/GetDaysToConversion.php b/plugins/Goals/Reports/GetDaysToConversion.php
index a6029ef862..1761e9a242 100644
--- a/plugins/Goals/Reports/GetDaysToConversion.php
+++ b/plugins/Goals/Reports/GetDaysToConversion.php
@@ -22,6 +22,7 @@ class GetDaysToConversion extends Base
parent::init();
$this->name = Piwik::translate('Goals_DaysToConv');
+ $this->documentation = Piwik::translate('Goals_DaysToConvReportDocumentation');
$this->dimension = new DaysToConversion();
$this->constantRowsCount = true;
$this->processedMetrics = false;
diff --git a/plugins/Goals/Reports/GetVisitsUntilConversion.php b/plugins/Goals/Reports/GetVisitsUntilConversion.php
index 5f6d916c80..cd0a04d70b 100644
--- a/plugins/Goals/Reports/GetVisitsUntilConversion.php
+++ b/plugins/Goals/Reports/GetVisitsUntilConversion.php
@@ -22,6 +22,7 @@ class GetVisitsUntilConversion extends Base
parent::init();
$this->name = Piwik::translate('Goals_VisitsUntilConv');
+ $this->documentation = Piwik::translate('Goals_VisitsUntilConvReportDocumentation');
$this->dimension = new VisitsUntilConversion();
$this->constantRowsCount = true;
$this->processedMetrics = array();
diff --git a/plugins/Goals/lang/en.json b/plugins/Goals/lang/en.json
index f3d9e34b42..b772c0ba32 100644
--- a/plugins/Goals/lang/en.json
+++ b/plugins/Goals/lang/en.json
@@ -41,6 +41,7 @@
"ConversionsOverview": "Conversions Overview",
"ConversionsOverviewBy": "Conversions overview by type of visit",
"DaysToConv": "Days to Conversion",
+ "DaysToConvReportDocumentation": "This report shows how many days pass before your visitors convert a goal.",
"Details": "Goal details",
"DefaultGoalConvertedOncePerVisit": "(default) Goal can only be converted once per visit",
"DefaultRevenueLabel": "Goal default revenue",
@@ -108,6 +109,7 @@
"GoalsAdjective": "Goals %s",
"VisitPageTitle": "Visit a given Page Title",
"VisitsUntilConv": "Visits to Conversion",
+ "VisitsUntilConvReportDocumentation": "This report shows the number of visits made before a visitor converts a goal.",
"VisitUrl": "Visit a given URL (page or group of pages)",
"VisitDurationMatchAttr": "Stay for a certain amount of time",
"VisitDuration": "visit duration is",
@@ -121,6 +123,7 @@
"EventValueAsRevenueHelp2": "Note: If both a default goal revenue and event value are defined, the event value will be used. If this option is enabled and no event value is sent in a request, the default revenue will be used (if defined).",
"AtLeastMinutes": "at least %1$s minutes. Use decimals to match seconds, for example, %2$s to match 30 seconds.",
"TimeInMinutes": "Time in Minutes",
- "ClickToViewThisGoal": "Click to view this goal."
+ "ClickToViewThisGoal": "Click to view this goal.",
+ "OverviewReportDocumentation": "This report gives an overview of how well your visitors convert a specific goal."
}
}
diff --git a/plugins/MultiSites/Reports/GetAll.php b/plugins/MultiSites/Reports/GetAll.php
index 9856f9b7fd..a4de704ba9 100644
--- a/plugins/MultiSites/Reports/GetAll.php
+++ b/plugins/MultiSites/Reports/GetAll.php
@@ -18,7 +18,7 @@ class GetAll extends Base
parent::init();
$this->dimension = new Website();
$this->name = Piwik::translate('General_AllWebsitesDashboard');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('MultiSites_AllWebsitesDashboardDocumentation');
$this->constantRowsCount = false;
$this->order = 4;
}
diff --git a/plugins/MultiSites/Reports/GetOne.php b/plugins/MultiSites/Reports/GetOne.php
index 370476fcbf..555cf92b05 100644
--- a/plugins/MultiSites/Reports/GetOne.php
+++ b/plugins/MultiSites/Reports/GetOne.php
@@ -18,7 +18,7 @@ class GetOne extends Base
parent::init();
$this->dimension = new Website();
$this->name = Piwik::translate('General_SingleWebsitesDashboard');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('MultiSites_SingleWebsitesDashboardDocumentation');
$this->constantRowsCount = false;
$this->order = 5;
}
diff --git a/plugins/MultiSites/lang/en.json b/plugins/MultiSites/lang/en.json
index b32987bdb0..05ede79a98 100644
--- a/plugins/MultiSites/lang/en.json
+++ b/plugins/MultiSites/lang/en.json
@@ -3,6 +3,8 @@
"Evolution": "Evolution",
"LoadingWebsites": "Loading websites",
"PluginDescription": "View and compare all your websites and apps in this useful 'All Websites' dashboard. ",
- "TopLinkTooltip": "Compare Web Analytics stats for all of your Websites."
+ "TopLinkTooltip": "Compare Web Analytics stats for all of your Websites.",
+ "SingleWebsitesDashboardDocumentation": "This report gives you an informational overview for a specific website, containing the most general metrics about your visitors.",
+ "AllWebsitesDashboardDocumentation": "This report gives you an informational overview for each of your websites, containing the most general metrics about your visitors."
}
} \ No newline at end of file
diff --git a/plugins/PagePerformance/Reports/Get.php b/plugins/PagePerformance/Reports/Get.php
index 1c313dea61..b1e09152cf 100644
--- a/plugins/PagePerformance/Reports/Get.php
+++ b/plugins/PagePerformance/Reports/Get.php
@@ -29,7 +29,7 @@ class Get extends \Piwik\Plugin\Report
$this->order = 5;
$this->name = Piwik::translate('PagePerformance_Overview');
- $this->documentation = '';
+ $this->documentation = Piwik::translate('PagePerformance_OverviewDocumentation');
$this->onlineGuideUrl = 'https://matomo.org/faq/how-to/how-do-i-see-page-performance-reports/';
$this->processedMetrics = Metrics::getAllPagePerformanceMetrics();
$this->metrics = Metrics::getAllPagePerformanceMetrics();
diff --git a/plugins/PagePerformance/lang/en.json b/plugins/PagePerformance/lang/en.json
index c875ca7c44..0292ab6c94 100644
--- a/plugins/PagePerformance/lang/en.json
+++ b/plugins/PagePerformance/lang/en.json
@@ -31,6 +31,7 @@
"PluginDescription": "Adds some page performance reports",
"PerformanceTable": "Table with performance metrics",
"Overview": "Performance overview",
+ "OverviewDocumentation": "This report provides an overview of how fast your webpages become visible to your visitors. This includes both how long it takes for browsers to download your webpages and how long it takes for browsers to display them.",
"Performance": "Performance",
"HelpNote": "Some of those metrics might not always be available. You can find more information in our %1$sonline guide%2$s.",
"RowActionTitle": "Open page performance report",
diff --git a/plugins/Referrers/Reports/Get.php b/plugins/Referrers/Reports/Get.php
index d705f9ea26..987f213a3f 100644
--- a/plugins/Referrers/Reports/Get.php
+++ b/plugins/Referrers/Reports/Get.php
@@ -38,7 +38,7 @@ class Get extends Base
parent::init();
$this->name = Piwik::translate('Referrers_ReferrersOverview');
- $this->documentation = '';
+ $this->documentation = Piwik::translate('Referrers_ReferrersOverviewDocumentation');
$this->processedMetrics = [
// none
];
diff --git a/plugins/Referrers/lang/en.json b/plugins/Referrers/lang/en.json
index 53780f41c0..87e375b838 100644
--- a/plugins/Referrers/lang/en.json
+++ b/plugins/Referrers/lang/en.json
@@ -44,6 +44,7 @@
"ReferrerNames": "Referrer Names",
"Referrers": "Referrers",
"ReferrersOverview": "Referrers Overview",
+ "ReferrersOverviewDocumentation": "This report shows what acquisition channels your visitors used to get to your website, and the number of visits each channel type is responsible for.",
"ReferrerTypes": "Channel Types",
"ReferrerURLs": "Referrer URLs",
"SearchEngines": "Search Engines",
diff --git a/plugins/Resolution/Reports/GetResolution.php b/plugins/Resolution/Reports/GetResolution.php
index 76ba087c85..4072f56eb8 100644
--- a/plugins/Resolution/Reports/GetResolution.php
+++ b/plugins/Resolution/Reports/GetResolution.php
@@ -20,7 +20,7 @@ class GetResolution extends Base
parent::init();
$this->dimension = new Resolution();
$this->name = Piwik::translate('Resolution_WidgetResolutions');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('Resolution_WidgetResolutionsDocumentation');
$this->order = 8;
$this->subcategoryId = 'DevicesDetection_Devices';
diff --git a/plugins/Resolution/lang/en.json b/plugins/Resolution/lang/en.json
index f79da0653f..2a7bba39aa 100644
--- a/plugins/Resolution/lang/en.json
+++ b/plugins/Resolution/lang/en.json
@@ -7,6 +7,7 @@
"Resolutions": "Resolutions",
"WidgetGlobalVisitors": "Visitor Configuration",
"WidgetGlobalVisitorsDocumentation": "This report shows the most common overall configurations that your visitors had. A configuration is the combination of an operating system, a browser type and a screen resolution.",
- "WidgetResolutions": "Screen Resolution"
+ "WidgetResolutions": "Screen Resolution",
+ "WidgetResolutionsDocumentation": "This report shows the screen resolutions your visitors used when viewing your website."
}
} \ No newline at end of file
diff --git a/plugins/UserId/Reports/GetUsers.php b/plugins/UserId/Reports/GetUsers.php
index 58c3216c70..406eb7a9d2 100644
--- a/plugins/UserId/Reports/GetUsers.php
+++ b/plugins/UserId/Reports/GetUsers.php
@@ -27,7 +27,7 @@ class GetUsers extends Base
$this->name = Piwik::translate('UserId_UserReportTitle');
$this->subcategoryId = 'UserId_UserReportTitle';
- $this->documentation = '';
+ $this->documentation = Piwik::translate('UserId_UserReportDocumentation');
$this->dimension = new UserId();
$this->metrics = array('label', 'nb_visits', 'nb_actions', 'nb_visits_converted');
$this->supportsFlatten = false;
diff --git a/plugins/UserId/lang/en.json b/plugins/UserId/lang/en.json
index f849012bdb..4fccd61bd4 100644
--- a/plugins/UserId/lang/en.json
+++ b/plugins/UserId/lang/en.json
@@ -2,6 +2,7 @@
"UserId": {
"UserId": "UserId",
"UserReportTitle": "User IDs",
+ "UserReportDocumentation": "This report shows visits and other general metrics for every individual User ID.",
"PluginDescription": "Shows user reports"
}
} \ No newline at end of file
diff --git a/plugins/VisitFrequency/Reports/Get.php b/plugins/VisitFrequency/Reports/Get.php
index 8418e7bbef..124c7b4e8b 100644
--- a/plugins/VisitFrequency/Reports/Get.php
+++ b/plugins/VisitFrequency/Reports/Get.php
@@ -27,9 +27,9 @@ class Get extends \Piwik\Plugin\Report
protected function init()
{
parent::init();
- $this->categoryId = 'General_Actions';
+ $this->categoryId = 'General_Actions';
$this->name = Piwik::translate('VisitFrequency_ColumnReturningVisits');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('VisitFrequency_VisitFrequencyReportDocumentation');
$this->processedMetrics = array(
new ReturningMetric(new AverageTimeOnSite(), API::RETURNING_COLUMN_SUFFIX),
new ReturningMetric(new ActionsPerVisit(), API::RETURNING_COLUMN_SUFFIX),
diff --git a/plugins/VisitFrequency/lang/en.json b/plugins/VisitFrequency/lang/en.json
index 6cdd0764cf..4dcf2b4435 100644
--- a/plugins/VisitFrequency/lang/en.json
+++ b/plugins/VisitFrequency/lang/en.json
@@ -33,6 +33,7 @@
"ReturnVisits": "returning visits",
"SubmenuFrequency": "Frequency",
"WidgetGraphReturning": "Returning Visits Over Time",
- "WidgetOverview": "Frequency Overview"
+ "WidgetOverview": "Frequency Overview",
+ "VisitFrequencyReportDocumentation": "This report shows general metrics like visits for returning visitors side by side with the same metrics for new visitors. Learn how returning visitors perform overall compared to new visitors."
}
} \ No newline at end of file
diff --git a/plugins/VisitsSummary/Reports/Get.php b/plugins/VisitsSummary/Reports/Get.php
index e8fc974e98..2e667caa14 100644
--- a/plugins/VisitsSummary/Reports/Get.php
+++ b/plugins/VisitsSummary/Reports/Get.php
@@ -36,7 +36,7 @@ class Get extends \Piwik\Plugin\Report
parent::init();
$this->categoryId = 'General_Visitors';
$this->name = Piwik::translate('VisitsSummary_VisitsSummary');
- $this->documentation = ''; // TODO
+ $this->documentation = Piwik::translate('VisitsSummary_VisitsSummaryReportDocumentation');
$this->processedMetrics = array(
new BounceRate(),
new ActionsPerVisit(),
diff --git a/plugins/VisitsSummary/lang/en.json b/plugins/VisitsSummary/lang/en.json
index fc9d3c4777..fe9bc4cf4d 100644
--- a/plugins/VisitsSummary/lang/en.json
+++ b/plugins/VisitsSummary/lang/en.json
@@ -22,6 +22,7 @@
"PluginDescription": "Reports general analytics metrics: visits, unique visitors, number of actions, bounce rate, etc.",
"VisitsSummary": "Visits Summary",
"VisitsSummaryDocumentation": "This is an overview of the visit evolution.",
+ "VisitsSummaryReportDocumentation": "This report provides a very general overview of how your visitors behave.",
"WidgetLastVisits": "Visits Over Time",
"WidgetOverviewGraph": "Visits Overview (with graph)",
"WidgetVisits": "Visits Overview"
diff --git a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_flat__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_flat__API.getProcessedReport_day.xml
index c19a197eb4..2e47868d6e 100644
--- a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_flat__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_flat__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Events</module>
<action>getAction</action>
<dimension>Event Action</dimension>
+ <documentation>This report shows you the number of times each event action occurred. You can view the event categories and names that were tracked along with each event action in the row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventAction>Event Action</Events_EventAction>
diff --git a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_lastN__API.getProcessedReport_day.xml
index e3970b7085..a1161a7921 100644
--- a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getAction_lastN__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Events</module>
<action>getAction</action>
<dimension>Event Action</dimension>
+ <documentation>This report shows you the number of times each event action occurred. You can view the event categories and names that were tracked along with each event action in the row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventAction>Event Action</Events_EventAction>
diff --git a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_flat__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_flat__API.getProcessedReport_day.xml
index 8daa941cd1..73d49cd636 100644
--- a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_flat__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_flat__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Events</module>
<action>getCategory</action>
<dimension>Event Category</dimension>
+ <documentation>This report shows the categories of each tracked event and how many times they occurred. You can view the event actions and names that were tracked along with each event category in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventCategory>Event Category</Events_EventCategory>
diff --git a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_lastN__API.getProcessedReport_day.xml
index aa720728fd..950776e01d 100644
--- a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getCategory_lastN__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Events</module>
<action>getCategory</action>
<dimension>Event Category</dimension>
+ <documentation>This report shows the categories of each tracked event and how many times they occurred. You can view the event actions and names that were tracked along with each event category in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventCategory>Event Category</Events_EventCategory>
diff --git a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_flat__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_flat__API.getProcessedReport_day.xml
index f32cfb8594..23a59720ae 100644
--- a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_flat__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_flat__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Events</module>
<action>getName</action>
<dimension>Event Name</dimension>
+ <documentation>This report shows you the names associated with each tracked event and how many times they occurred. You can view the event actions and categories that were tracked along with each event name in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventName>Event Name</Events_EventName>
diff --git a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_lastN__API.getProcessedReport_day.xml
index e134d7ef78..9aadafb4fa 100644
--- a/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_CustomEvents_Events.getName_lastN__API.getProcessedReport_day.xml
@@ -9,6 +9,7 @@
<module>Events</module>
<action>getName</action>
<dimension>Event Name</dimension>
+ <documentation>This report shows you the names associated with each tracked event and how many times they occurred. You can view the event actions and categories that were tracked along with each event name in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventName>Event Name</Events_EventName>
diff --git a/tests/PHPUnit/System/expected/test_DataComparisonTest_processedReport__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_DataComparisonTest_processedReport__API.getProcessedReport_day.xml
index f5ea70ec54..669768bc41 100644
--- a/tests/PHPUnit/System/expected/test_DataComparisonTest_processedReport__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_DataComparisonTest_processedReport__API.getProcessedReport_day.xml
@@ -8,6 +8,7 @@
<name>Visits Summary</name>
<module>VisitsSummary</module>
<action>get</action>
+ <documentation>This report provides a very general overview of how your visitors behave.</documentation>
<metrics>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
<nb_visits>Visits</nb_visits>
diff --git a/tests/PHPUnit/System/expected/test_OneVisitorTwoVisits_showColumns_onlyOne__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_OneVisitorTwoVisits_showColumns_onlyOne__API.getProcessedReport_day.xml
index dba7ff2e2a..11ad8114f3 100644
--- a/tests/PHPUnit/System/expected/test_OneVisitorTwoVisits_showColumns_onlyOne__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_OneVisitorTwoVisits_showColumns_onlyOne__API.getProcessedReport_day.xml
@@ -8,6 +8,7 @@
<name>Visits Summary</name>
<module>VisitsSummary</module>
<action>get</action>
+ <documentation>This report provides a very general overview of how your visitors behave.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
</metrics>
diff --git a/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_day.xml
index a5a008b823..6f84562905 100644
--- a/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_day.xml
@@ -7,6 +7,7 @@
<name>Actions - Main metrics</name>
<module>Actions</module>
<action>get</action>
+ <documentation>This report provides a very basic overview of what actions your visitors take on your website.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>
diff --git a/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_month.xml b/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_month.xml
index 4dbb7749c0..3618178ddb 100644
--- a/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_month.xml
+++ b/tests/PHPUnit/System/expected/test_SiteSearch_Actions.get_firstSite_lastN__API.getProcessedReport_month.xml
@@ -7,6 +7,7 @@
<name>Actions - Main metrics</name>
<module>Actions</module>
<action>get</action>
+ <documentation>This report provides a very basic overview of what actions your visitors take on your website.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>
diff --git a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_Goals.getDaysToConversion_firstSite_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_Goals.getDaysToConversion_firstSite_lastN__API.getProcessedReport_day.xml
index 5ead103051..d733732a84 100644
--- a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_Goals.getDaysToConversion_firstSite_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_Goals.getDaysToConversion_firstSite_lastN__API.getProcessedReport_day.xml
@@ -8,6 +8,7 @@
<module>Goals</module>
<action>getDaysToConversion</action>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
diff --git a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_MultiSites.getAll_firstSite_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_MultiSites.getAll_firstSite_lastN__API.getProcessedReport_day.xml
index c45e075247..109e6fb23b 100644
--- a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_MultiSites.getAll_firstSite_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_Conversions_MultiSites.getAll_firstSite_lastN__API.getProcessedReport_day.xml
@@ -8,6 +8,7 @@
<module>MultiSites</module>
<action>getAll</action>
<dimension>Website</dimension>
+ <documentation>This report gives you an informational overview for each of your websites, containing the most general metrics about your visitors.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_actions>Actions</nb_actions>
diff --git a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitFrequency.get_firstSite_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitFrequency.get_firstSite_lastN__API.getProcessedReport_day.xml
index e1323cb324..80df1b28b0 100644
--- a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitFrequency.get_firstSite_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitFrequency.get_firstSite_lastN__API.getProcessedReport_day.xml
@@ -8,6 +8,7 @@
<name>Returning Visits</name>
<module>VisitFrequency</module>
<action>get</action>
+ <documentation>This report shows general metrics like visits for returning visitors side by side with the same metrics for new visitors. Learn how returning visitors perform overall compared to new visitors.</documentation>
<metrics>
<nb_visits_returning>Returning Visits</nb_visits_returning>
<nb_actions_returning>Actions by Returning Visits</nb_actions_returning>
diff --git a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitsSummary.get_firstSite_lastN__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitsSummary.get_firstSite_lastN__API.getProcessedReport_day.xml
index cd964f981f..ec2d3adaf1 100644
--- a/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitsSummary.get_firstSite_lastN__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_TwoVisitors_twoWebsites_differentDays_VisitsSummary.get_firstSite_lastN__API.getProcessedReport_day.xml
@@ -8,6 +8,7 @@
<name>Visits Summary</name>
<module>VisitsSummary</module>
<action>get</action>
+ <documentation>This report provides a very general overview of how your visitors behave.</documentation>
<metrics>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
<nb_visits>Visits</nb_visits>
diff --git a/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getGlossaryReports.xml b/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getGlossaryReports.xml
index 622d25675b..a2e62006ff 100644
--- a/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getGlossaryReports.xml
+++ b/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getGlossaryReports.xml
@@ -1,10 +1,22 @@
<?xml version="1.0" encoding="utf-8" ?>
<result>
<row>
+ <name>Actions - Main metrics (Actions)</name>
+ <documentation>This report provides a very basic overview of what actions your visitors take on your website.</documentation>
+ </row>
+ <row>
+ <name>Advanced tag cloud: with logos and links (UI Framework)</name>
+ <documentation>This report shows a sample tab cloud.</documentation>
+ </row>
+ <row>
<name>All Channels (Referrers)</name>
<documentation>This report shows all your Referrers in one unified report, listing all Websites, Search keywords and Campaigns used by your visitors to find your website.</documentation>
</row>
<row>
+ <name>All Websites dashboard (All Websites)</name>
+ <documentation>This report gives you an informational overview for each of your websites, containing the most general metrics about your visitors.</documentation>
+ </row>
+ <row>
<name>Browser Plugins (Visitors)</name>
<documentation>This report shows which browser plugins your visitors had enabled. This information might be important for choosing the right way to deliver your content.</documentation>
</row>
@@ -17,10 +29,14 @@
<documentation>This report shows which language the visitor's browsers are using. (e.g. &quot;English&quot;)</documentation>
</row>
<row>
- <name>Browsers (Visitors)</name>
+ <name>Browser version (Visitors)</name>
<documentation>This report contains information about what kind of browser your visitors were using. Each browser version is listed separately.</documentation>
</row>
<row>
+ <name>Browsers (Visitors)</name>
+ <documentation>This report contains information about what kind of browser your visitors were using.</documentation>
+ </row>
+ <row>
<name>Campaigns (Referrers)</name>
<documentation>This report shows which campaigns led visitors to your website.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-campaigns/</onlineGuideUrl>
@@ -38,6 +54,16 @@
<documentation>This report shows the most common overall configurations that your visitors had. A configuration is the combination of an operating system, a browser type and a screen resolution.</documentation>
</row>
<row>
+ <name>Content Name (Actions)</name>
+ <documentation>This report shows the names of the content your visitors viewed and interacted with.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Content Piece (Actions)</name>
+ <documentation>This report shows the pieces of content your visitors viewed and interacted with.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
+ </row>
+ <row>
<name>Continent (Visitors)</name>
<documentation>This report shows which continent your visitors were in when they accessed your website.</documentation>
</row>
@@ -51,6 +77,27 @@
<onlineGuideUrl>https://matomo.org/docs/custom-variables/</onlineGuideUrl>
</row>
<row>
+ <name>Data tables (UI Framework)</name>
+ <documentation>This is an example documentation of a report.</documentation>
+ </row>
+ <row>
+ <name>Days to Conversion (Goals)</name>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Device brand (Visitors)</name>
+ <documentation>This report shows the brands / manufacturers of the devices your visitors were using. In most cases this information is only available for non-desktop devices.</documentation>
+ </row>
+ <row>
+ <name>Device model (Visitors)</name>
+ <documentation>This report shows the devices your visitors are using. Each model is displayed combined with the device brand as some model names are used by multiple brands.</documentation>
+ </row>
+ <row>
+ <name>Device type (Visitors)</name>
+ <documentation>This report shows the types of devices your visitors were using. This report will always show all device types Matomo is able to detect, even if there were no visits with a specific type.</documentation>
+ </row>
+ <row>
<name>Downloads (Actions)</name>
<documentation>In this report, you can see which files your visitors have downloaded. &lt;br /&gt; What Matomo counts as a download is the click on a download link. Whether the download was completed or not isn't known to Matomo.</documentation>
</row>
@@ -63,6 +110,21 @@
<documentation>This report contains information about the entry pages that were used during the specified period. An entry page is the first page that a user views during their visit. &lt;br /&gt; The entry URLs are displayed as a folder structure.&lt;br /&gt;Use the plus and minus icons on the left to navigate.</documentation>
</row>
<row>
+ <name>Event Actions (Actions)</name>
+ <documentation>This report shows you the number of times each event action occurred. You can view the event categories and names that were tracked along with each event action in the row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Event Categories (Actions)</name>
+ <documentation>This report shows the categories of each tracked event and how many times they occurred. You can view the event actions and names that were tracked along with each event category in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Event Names (Actions)</name>
+ <documentation>This report shows you the names associated with each tracked event and how many times they occurred. You can view the event actions and categories that were tracked along with each event name in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
+ </row>
+ <row>
<name>Exit page titles (Actions)</name>
<documentation>This report contains information about the titles of exit pages that occurred during the specified period. Use the plus and minus icons on the left to navigate.</documentation>
</row>
@@ -71,6 +133,61 @@
<documentation>This report contains information about the exit pages that occurred during the specified period. An exit page is the last page that a user views during their visit. &lt;br /&gt; The exit URLs are displayed as a folder structure.&lt;br /&gt;Use the plus and minus icons on the left to navigate.</documentation>
</row>
<row>
+ <name>Goal 1 - Thank you - Days to Conversion (Goals)</name>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goal 1 - Thank you - Visits to Conversion (Goals)</name>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goal 2 - Hello - Days to Conversion (Goals)</name>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goal 2 - Hello - Visits to Conversion (Goals)</name>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goal Goal 1 - Thank you (Goals)</name>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goal Goal 2 - Hello (Goals)</name>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goal triggered js (Goals)</name>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goals (Goals)</name>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goals Overview (Goals)</name>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goals Overview - Days to Conversion (Goals)</name>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Goals Overview - Visits to Conversion (Goals)</name>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
<name>Keywords (Referrers)</name>
<documentation>This report shows which keywords users were searching for before they were referred to your website. &lt;br /&gt;&lt;br /&gt; By clicking on a row in the table, you can see the distribution of search engines that were queried for the keyword.&lt;br /&gt;&lt;br /&gt;Note: This report lists most keywords as not defined, because most search engines do not send the exact keyword used on the search engine.</documentation>
</row>
@@ -83,6 +200,18 @@
<documentation>In this report, you can see how many visits had a certain total duration. Initially, the report is shown as a tag cloud, more common durations are displayed in a larger font.&lt;br /&gt;Please note, that you can view the report in other ways than as a tag cloud. Use the controls at the bottom of the report to do so.</documentation>
</row>
<row>
+ <name>Main metrics (API)</name>
+ <documentation>This report gives you an overview over the most important metrics across all categories and plugins.</documentation>
+ </row>
+ <row>
+ <name>Operating System families (Visitors)</name>
+ <documentation>This report shows you the operating systems your visitors are using grouped by operating system family. An operating system family consists of different versions or distributions.</documentation>
+ </row>
+ <row>
+ <name>Operating System versions (Visitors)</name>
+ <documentation>This report shows you the operating systems your visitors are using. Each version and distribution is shown separately.</documentation>
+ </row>
+ <row>
<name>Outlinks (Actions)</name>
<documentation>This report shows a hierarchical list of outlink URLs that were clicked by your visitors. An outlink is a link that leads the visitor away from your website (to another domain).&lt;br /&gt;Use the plus and minus icons on the left to navigate.</documentation>
</row>
@@ -109,10 +238,31 @@
<documentation>In this report, you can see how many visits involved a certain number of pageviews. Initially, the report is shown as a tag cloud, more common numbers of pages are displayed in a larger font.&lt;br /&gt;Please note, that you can view the report in other ways than as a tag cloud. Use the controls at the bottom of the report to do so.</documentation>
</row>
<row>
+ <name>Performance overview (Actions)</name>
+ <documentation>This report provides an overview of how fast your webpages become visible to your visitors. This includes both how long it takes for browsers to download your webpages and how long it takes for browsers to display them.</documentation>
+ <onlineGuideUrl>https://matomo.org/faq/how-to/how-do-i-see-page-performance-reports/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>Pie graph (UI Framework)</name>
+ <documentation>This report shows a sample Pie chart</documentation>
+ </row>
+ <row>
+ <name>Referrers Overview (Referrers)</name>
+ <documentation>This report shows what acquisition channels your visitors used to get to your website, and the number of visits each channel type is responsible for.</documentation>
+ </row>
+ <row>
<name>Region (Visitors)</name>
<documentation>This report shows which region your visitors were in when they accessed your website.&lt;br/&gt;In order to see data for this report, you must setup GeoIP in the Geolocation admin tab. The commercial &lt;a rel=&quot;noreferrer noopener&quot; target=&quot;_blank&quot; href=&quot;http://www.maxmind.com/?rId=piwik&quot;&gt;Maxmind&lt;/a&gt; GeoIP databases are more accurate than the free ones. To see how accurate they are, click &lt;a rel=&quot;noreferrer noopener&quot; target=&quot;_blank&quot; href=&quot;http://www.maxmind.com/en/city_accuracy?rId=piwik&quot;&gt;here&lt;/a&gt;.</documentation>
</row>
<row>
+ <name>Returning Visits (Actions)</name>
+ <documentation>This report shows general metrics like visits for returning visitors side by side with the same metrics for new visitors. Learn how returning visitors perform overall compared to new visitors.</documentation>
+ </row>
+ <row>
+ <name>Screen Resolution (Visitors)</name>
+ <documentation>This report shows the screen resolutions your visitors used when viewing your website.</documentation>
+ </row>
+ <row>
<name>Search Categories (Actions)</name>
<documentation>This report lists the Categories that visitors selected when they made a Search on your website.&lt;br/&gt;For example, Ecommerce websites typically have a &quot;Category&quot; selector so that visitors can restrict their searches to all products in a specific Category.</documentation>
<onlineGuideUrl>https://matomo.org/docs/site-search/</onlineGuideUrl>
@@ -127,6 +277,10 @@
<onlineGuideUrl>https://matomo.org/docs/site-search/</onlineGuideUrl>
</row>
<row>
+ <name>Single Website dashboard (All Websites)</name>
+ <documentation>This report gives you an informational overview for a specific website, containing the most general metrics about your visitors.</documentation>
+ </row>
+ <row>
<name>Site Search Keywords (Actions)</name>
<documentation>This report lists the Search Keywords that visitors searched for on your internal Search Engine.&lt;br/&gt;&lt;br/&gt;Tracking searches that visitors make on your website is a very effective way to learn more about what your audience is looking for, it can help find ideas for new content, new Ecommerce products that potential customers might be searching for, and generally improve the visitors' experience on your website.</documentation>
<onlineGuideUrl>https://matomo.org/docs/site-search/</onlineGuideUrl>
@@ -136,6 +290,18 @@
<documentation>In this table, you can see which websites referred visitors to your site. &lt;br /&gt; By clicking on a row in the table, you can see which URLs the links to your website were on.</documentation>
</row>
<row>
+ <name>Temperatures evolution over time (UI Framework)</name>
+ <documentation>This is an example evolution report</documentation>
+ </row>
+ <row>
+ <name>User IDs (Visitors)</name>
+ <documentation>This report shows visits and other general metrics for every individual User ID.</documentation>
+ </row>
+ <row>
+ <name>Visits Summary (Visitors)</name>
+ <documentation>This report provides a very general overview of how your visitors behave.</documentation>
+ </row>
+ <row>
<name>Visits by Day of Week (Visitors)</name>
<documentation>This graph shows the number of visits your website received on each day of the week.</documentation>
</row>
@@ -156,7 +322,22 @@
<documentation>This graph shows what time it was in the &lt;strong&gt; server's time zone &lt;/strong&gt; during the visits.</documentation>
</row>
<row>
+ <name>Visits to Conversion (Goals)</name>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
<name>Websites (Referrers)</name>
<documentation>In this table, you can see which websites referred visitors to your site. &lt;br /&gt; By clicking on a row in the table, you can see which URLs the links to your website were on.</documentation>
</row>
+ <row>
+ <name>triggered js - Days to Conversion (Goals)</name>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
+ <row>
+ <name>triggered js - Visits to Conversion (Goals)</name>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
+ <onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
+ </row>
</result> \ No newline at end of file
diff --git a/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getReportMetadata_day.xml b/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getReportMetadata_day.xml
index b3b4875076..78903904b3 100644
--- a/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getReportMetadata_day.xml
+++ b/tests/PHPUnit/System/expected/test_apiGetReportMetadata__API.getReportMetadata_day.xml
@@ -6,6 +6,7 @@
<module>MultiSites</module>
<action>getAll</action>
<dimension>Website</dimension>
+ <documentation>This report gives you an informational overview for each of your websites, containing the most general metrics about your visitors.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_actions>Actions</nb_actions>
@@ -39,6 +40,7 @@
<module>MultiSites</module>
<action>getOne</action>
<dimension>Website</dimension>
+ <documentation>This report gives you an informational overview for a specific website, containing the most general metrics about your visitors.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_actions>Actions</nb_actions>
@@ -72,6 +74,7 @@
<name>Visits Summary</name>
<module>VisitsSummary</module>
<action>get</action>
+ <documentation>This report provides a very general overview of how your visitors behave.</documentation>
<metrics>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
<nb_visits>Visits</nb_visits>
@@ -338,6 +341,7 @@
<module>DevicesDetection</module>
<action>getType</action>
<dimension>Device type</dimension>
+ <documentation>This report shows the types of devices your visitors were using. This report will always show all device types Matomo is able to detect, even if there were no visits with a specific type.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -377,6 +381,7 @@
<module>DevicesDetection</module>
<action>getModel</action>
<dimension>Device model</dimension>
+ <documentation>This report shows the devices your visitors are using. Each model is displayed combined with the device brand as some model names are used by multiple brands.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -416,6 +421,7 @@
<module>DevicesDetection</module>
<action>getBrand</action>
<dimension>Device brand</dimension>
+ <documentation>This report shows the brands / manufacturers of the devices your visitors were using. In most cases this information is only available for non-desktop devices.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -455,6 +461,7 @@
<module>Resolution</module>
<action>getResolution</action>
<dimension>Resolution</dimension>
+ <documentation>This report shows the screen resolutions your visitors used when viewing your website.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -495,6 +502,7 @@
<module>DevicesDetection</module>
<action>getOsVersions</action>
<dimension>Operating system version</dimension>
+ <documentation>This report shows you the operating systems your visitors are using. Each version and distribution is shown separately.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -535,7 +543,7 @@
<module>DevicesDetection</module>
<action>getBrowsers</action>
<dimension>Browser</dimension>
- <documentation>This report contains information about what kind of browser your visitors were using. Each browser version is listed separately.</documentation>
+ <documentation>This report contains information about what kind of browser your visitors were using.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -582,6 +590,7 @@
<module>DevicesDetection</module>
<action>getBrowserVersions</action>
<dimension>Browser version</dimension>
+ <documentation>This report contains information about what kind of browser your visitors were using. Each browser version is listed separately.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -663,6 +672,7 @@
<module>DevicesDetection</module>
<action>getOsFamilies</action>
<dimension>Operating system family</dimension>
+ <documentation>This report shows you the operating systems your visitors are using grouped by operating system family. An operating system family consists of different versions or distributions.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -880,6 +890,7 @@
<module>UserId</module>
<action>getUsers</action>
<dimension>UserId</dimension>
+ <documentation>This report shows visits and other general metrics for every individual User ID.</documentation>
<metrics>
<label>Label</label>
<nb_visits>Visits</nb_visits>
@@ -955,6 +966,7 @@
<name>Actions - Main metrics</name>
<module>Actions</module>
<action>get</action>
+ <documentation>This report provides a very basic overview of what actions your visitors take on your website.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>
@@ -1406,6 +1418,7 @@
<module>Events</module>
<action>getCategory</action>
<dimension>Event Category</dimension>
+ <documentation>This report shows the categories of each tracked event and how many times they occurred. You can view the event actions and names that were tracked along with each event category in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventCategory>Event Category</Events_EventCategory>
@@ -1441,6 +1454,7 @@
<module>Events</module>
<action>getAction</action>
<dimension>Event Action</dimension>
+ <documentation>This report shows you the number of times each event action occurred. You can view the event categories and names that were tracked along with each event action in the row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventAction>Event Action</Events_EventAction>
@@ -1476,6 +1490,7 @@
<module>Events</module>
<action>getName</action>
<dimension>Event Name</dimension>
+ <documentation>This report shows you the names associated with each tracked event and how many times they occurred. You can view the event actions and categories that were tracked along with each event name in each row's subtable. You can change which is shown by changing the secondary dimension with the link at the bottom of the report.</documentation>
<onlineGuideUrl>https://matomo.org/docs/event-tracking/</onlineGuideUrl>
<dimensions>
<Events_EventName>Event Name</Events_EventName>
@@ -1511,6 +1526,7 @@
<module>Contents</module>
<action>getContentNames</action>
<dimension>Content Name</dimension>
+ <documentation>This report shows the names of the content your visitors viewed and interacted with.</documentation>
<onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
<metrics>
<nb_impressions>Impressions</nb_impressions>
@@ -1536,6 +1552,7 @@
<module>Contents</module>
<action>getContentPieces</action>
<dimension>Content Piece</dimension>
+ <documentation>This report shows the pieces of content your visitors viewed and interacted with.</documentation>
<onlineGuideUrl>https://matomo.org/docs/content-tracking/</onlineGuideUrl>
<metrics>
<nb_impressions>Impressions</nb_impressions>
@@ -1635,6 +1652,7 @@
<name>Returning Visits</name>
<module>VisitFrequency</module>
<action>get</action>
+ <documentation>This report shows general metrics like visits for returning visitors side by side with the same metrics for new visitors. Learn how returning visitors perform overall compared to new visitors.</documentation>
<metrics>
<nb_visits_returning>Returning Visits</nb_visits_returning>
<nb_actions_returning>Actions by Returning Visits</nb_actions_returning>
@@ -1665,6 +1683,7 @@
<name>Performance overview</name>
<module>PagePerformance</module>
<action>get</action>
+ <documentation>This report provides an overview of how fast your webpages become visible to your visitors. This includes both how long it takes for browsers to download your webpages and how long it takes for browsers to display them.</documentation>
<onlineGuideUrl>https://matomo.org/faq/how-to/how-do-i-see-page-performance-reports/</onlineGuideUrl>
<metrics>
<avg_time_network>Avg. network time</avg_time_network>
@@ -1702,6 +1721,7 @@
<name>Referrers Overview</name>
<module>Referrers</module>
<action>get</action>
+ <documentation>This report shows what acquisition channels your visitors used to get to your website, and the number of visits each channel type is responsible for.</documentation>
<metrics>
<Referrers_visitorsFromSearchEngines>Visitors from Search Engines</Referrers_visitorsFromSearchEngines>
<Referrers_visitorsFromSearchEngines_percent>Percent of Visitors from Search Engines</Referrers_visitorsFromSearchEngines_percent>
@@ -2214,6 +2234,7 @@
<name>Goals</name>
<module>Goals</module>
<action>get</action>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2236,6 +2257,7 @@
<module>Goals</module>
<action>getVisitsUntilConversion</action>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2257,6 +2279,7 @@
<module>Goals</module>
<action>getDaysToConversion</action>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2280,6 +2303,7 @@
<parameters>
<idGoal>0</idGoal>
</parameters>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2305,6 +2329,7 @@
<idGoal>0</idGoal>
</parameters>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2322,6 +2347,7 @@
<idGoal>0</idGoal>
</parameters>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2338,6 +2364,7 @@
<parameters>
<idGoal>1</idGoal>
</parameters>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2363,6 +2390,7 @@
<idGoal>1</idGoal>
</parameters>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2380,6 +2408,7 @@
<idGoal>1</idGoal>
</parameters>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2396,6 +2425,7 @@
<parameters>
<idGoal>2</idGoal>
</parameters>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2421,6 +2451,7 @@
<idGoal>2</idGoal>
</parameters>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2438,6 +2469,7 @@
<idGoal>2</idGoal>
</parameters>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2454,6 +2486,7 @@
<parameters>
<idGoal>3</idGoal>
</parameters>
+ <documentation>This report gives an overview of how well your visitors convert a specific goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2479,6 +2512,7 @@
<idGoal>3</idGoal>
</parameters>
<dimension>Visits to Conversion</dimension>
+ <documentation>This report shows the number of visits made before a visitor converts a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2496,6 +2530,7 @@
<idGoal>3</idGoal>
</parameters>
<dimension>Days to Conversion</dimension>
+ <documentation>This report shows how many days pass before your visitors convert a goal.</documentation>
<onlineGuideUrl>https://matomo.org/docs/tracking-goals-web-analytics/</onlineGuideUrl>
<metrics>
<nb_conversions>Conversions</nb_conversions>
@@ -2510,6 +2545,7 @@
<name>Data tables</name>
<module>ExampleUI</module>
<action>getTemperatures</action>
+ <documentation>This is an example documentation of a report.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2541,6 +2577,7 @@
<name>Temperatures evolution over time</name>
<module>ExampleUI</module>
<action>getTemperaturesEvolution</action>
+ <documentation>This is an example evolution report</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2573,6 +2610,7 @@
<name>Pie graph</name>
<module>ExampleUI</module>
<action>getPlanetRatios</action>
+ <documentation>This report shows a sample Pie chart</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2605,6 +2643,7 @@
<name>Advanced tag cloud: with logos and links</name>
<module>ExampleUI</module>
<action>getPlanetRatiosWithLogos</action>
+ <documentation>This report shows a sample tab cloud.</documentation>
<metrics>
<nb_visits>Visits</nb_visits>
<nb_uniq_visitors>Unique visitors</nb_uniq_visitors>
@@ -2636,6 +2675,7 @@
<name>Main metrics</name>
<module>API</module>
<action>get</action>
+ <documentation>This report gives you an overview over the most important metrics across all categories and plugins.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>
diff --git a/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getMetadata_day.xml b/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getMetadata_day.xml
index 7e1c898ec6..026302dc29 100644
--- a/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getMetadata_day.xml
+++ b/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getMetadata_day.xml
@@ -5,6 +5,7 @@
<name>Actions - Main metrics</name>
<module>Actions</module>
<action>get</action>
+ <documentation>This report provides a very basic overview of what actions your visitors take on your website.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>
diff --git a/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getProcessedReport_day.xml b/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getProcessedReport_day.xml
index 33f240bdab..0379b24940 100644
--- a/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getProcessedReport_day.xml
+++ b/tests/PHPUnit/System/expected/test_apiGetReportMetadata_hideMetricsDoc__API.getProcessedReport_day.xml
@@ -7,6 +7,7 @@
<name>Actions - Main metrics</name>
<module>Actions</module>
<action>get</action>
+ <documentation>This report provides a very basic overview of what actions your visitors take on your website.</documentation>
<metrics>
<nb_pageviews>Pageviews</nb_pageviews>
<nb_uniq_pageviews>Unique Pageviews</nb_uniq_pageviews>