Widgets¶
You can add the Matomo widgets like any other widget to a dashboard. Please note, that the widgets have to be enabled in the site configuration and the permissions for editors have to be granted to be able to use these widgets.
Hint
Most widgets need an activated module in Matomo to work. If a module is not available, an error is displayed in the widget. The parameters of the underlying data providers can be adjusted. Have a look into the Widget configuration section.
The following widgets are available. A link to the corresponding page in Matomo is displayed via in icon in the header bar of the widget if the report is available.
Tip
Do you miss a widget? Open a feature request and with a little luck the widget is available in the next release.
Actions per day¶
This widget displays the number of actions per day for the last 28 days (including the current day). Actions are:
- Page views
- Downloads
- Clicks on outlinks
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.actionsPerDay.parameters
- period: day
- date: last28
Actions per month¶
This widget displays the number of actions per month for the last 12 months (including the current month). Actions are:
- Page views
- Downloads
- Clicks on outlinks
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.actionsPerMonth.parameters
- period: month
- date: last12
Bounce rate¶
The bounce rate for the current month shows this widget:
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.bounceRate.parameters
- period: month
- date: today
- matomo_widgets.bounceRate.subtitle
- in the current month
Browser plugins¶
This report shows which browser plugins your visitors had enabled:
- Matomo module
- DevicePlugins
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.browserPlugins.parameters
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_visits
- filter_sort_order: desc
Browsers¶
The browser share for the current month shows this widget:
- Matomo module
- DevicesDetection
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.browsers.limit
- 5
- matomo_widgets.browsers.parameters
- period: month
- date: today
- filter_sort_column: nb_visits
- filter_sort_order: desc
Campaigns¶
Displays a report of the campaigns for the current month:
- Matomo module
- Referrers
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.campaigns.parameters:
- period: month
- date: today
- filter_limit: 30
- filter_sort_column: nb_visits
- filter_sort_order: desc
Content names¶
The content name report is part of content tracking. The widget displays the names, impressions and interaction rate of the content the visitors viewed and interacted with.
- Matomo module
- Contents
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.campaigns.parameters:
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_impressions
- filter_sort_order: desc
Content pieces¶
The content piece report is part of content tracking. The widget displays the pieces, impressions and interaction rate of the content the visitors viewed and interacted with.
- Matomo module
- Contents
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.campaigns.parameters:
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_impressions
- filter_sort_order: desc
Countries¶
Shows a list of countries from which the website was visited in the current month:
- Matomo module
- UserCountry
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.country.parameters:
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_visits
- filter_sort_order: desc
Custom dimensions¶
With custom dimensions any custom data can be assigned to visitors or actions. Before a custom dimension can be used as a dashboard widget it has to be configured for a site.
The columns for a custom dimension widget depend on the scope of the custom dimension.
- Matomo module
- CustomDimensions
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.customDimension<idDimension>.parameters:
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_visits
- filter_sort_order: desc
The <idDimension>
is the id of the custom dimension as available in the
Matomo configuration.
Scope “action”¶
Scope “visit”¶
Link to Matomo¶
A call-to-action widget is used to show a link to the configured Matomo installation:
Operating system families¶
The operating system families used by the visitors for the current month:
- Matomo module
- DevicesDetection
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.osFamilies.limit:
- 5
- matomo_widgets.osFamilies.parameters:
- period: month
- date: today
- filter_sort_column: nb_visits
- filter_sort_order: desc
Site search keywords¶
Overview of the search keywords that visitors searched for on the internal search engine:
- Matomo module
- Actions
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.siteSearchKeywords.parameters:
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_visits
- filter_sort_order: desc
Site search keywords with no result¶
List of the site search keywords that did not return any search result:
- Matomo module
- Actions
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.siteSearchNoResultKeywords.parameters:
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_visits
- filter_sort_order: desc
Visits per day¶
This widget displays the number of visits per day for the last 28 days:
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.visitsPerDay.parameters:
- period: day
- date: last28
Visits per month¶
This widget displays the number of visits per month for the last 12 months:
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.visitsPerMonth.parameters:
- period: month
- date: last12