Matomo 3.2.1 - Analytics Platform

We are proud to announce Piwik 3.2.1: a new minor release of Piwik Analytics.

What’s new?

This release brings more than 100 improvements to usability, security, performance and reliability.

Security improvements include the ability to restrict using Piwik for a set of whitelisted IP addresses. To use Piwik faster, when you use Piwik try pressing the question mark key ? to show a list of available keyboard shortcuts. Importing logs with Piwik? Log Analytics has seen a few interesting new features in this release. Or if you use Piwik behind a proxy, with this new release all possible proxy setups are supported. As with most of our releases, new device models are now detected (iPhone X, Huawei and Samsung devices), as well as new social media, new search engines and bots. And we keep fighting spammers and added new referrer spammers thanks to the community suggestions. Finally, new free and premium plugins have been released on the Marketplace! Learn all the details below.

111 tickets have been closed by 25 contributors!

After You Update

Use the forums if you have any question or feedback (free support),
or contact the Business Support Team to make the most of your Piwik Analytics and get professional support (paid support).
Please help us spread the word about Piwik! Maybe you can write about the project on your blog, website, twitter, talk about Piwik Analytics at conferences, or let your friends and colleagues know what is Piwik. Already 1,000,000+ websites have liberated their web analytics, and with your help we can grow the community!
To improve Piwik in your language consider contributing to translations.
Support our efforts by donating to the project.

Database upgrade

This release does not contain any major database upgrade.

Platform Changes

Piwik is an open analytics platform. In an effort to help Piwik developers learn about improvements and changes in the core APIs, we document the changes since the last release.

In this 3.2.1 release there are New APIs, New features, and an easier way to change the text color in the top bar in your custom Piwik theme.

Read more in Platform Changelog for Developers to see all changes to the platform and APIs.

Note: the Marketplace showcases more than 63 plugins already compatible with Piwik 3 but we think this is just the beginning. Piwik is your universal data analytics platform!

New and updated SDKs (Tracking API Clients)

The Piwik team offers official SDKs (Tracking API Clients) for measuring your mobile apps and any other kind of apps.

New and updated guides and FAQs

New:

Updated:

URL Builder – Marketing Campaign Tracking. You can now generate campaign tracking URLs with up to 5 campaign dimension parameters.`
List of Features in Piwik Analytics
How do I get reporting data for dates in the past when I create a new report?
How do I measure form field usages for text fields, checkboxes, radio buttons, multiselect fields?
How do I get reporting data for dates in the past when I create a new report?
How do I measure form field usages for text fields, checkboxes, radio buttons, multiselect fields?
Session recording: Can I record my than 5000 sessions at once?
How do I configure Piwik when the server is installed behind a proxy?

New plugins

By the Piwik team and InnoCraft:

By third party developers:

Need help upgrading Piwik?

Read the Updating Piwik user guide or for more help contact the Piwik experts.

List of 111 tickets closed in Piwik 3.2.1

piwik/piwik

#8942 New plugin: provide simple UI to invalidate old reports [by @sgiehl]
#4577 Ability to restrict user login to specific IP addresses
#12233 Use consistent HTML email body for all scheduled reports (HTML, PDF & CSV) [by @diosmosis, @mattab]
#12283 Show shortcut help screen when pressing `?` [by @sgiehl, @mattab]
#6880 Various bugs when using SSL and/or a reverse proxy
#7898 Piwik setup in a sub path URL behind a proxy
#12172 When embedding dashboard in an iframe, some widgets don’t apply the selected Segment [by @sgiehl]
#12182 Actions tracked without a URL but with action_name should be displayed in the Visitor log [by @sgiehl]
#12171 Formats numbers in the real time widget [by @AMcNeice, @mattab]
#12143 UI: Backspace eats extra characters [by @Morerice, @sgiehl]
#12113 issue with Widgetized dashboards: only [object Object] displayed [by @sgiehl]
#12201 Customizable LESS var for header/menu links color [by @tsteur, @mattab]
#12207 Issue the CORS header (Access-Control-Allow-Origin) also on Tracking API requests [by @mattab]
#12262 Add visitor details events [by @tsteur]
#10605 Sometimes the datatable footer controls can be hidden [by @sgiehl]
#11710 Document how to view our UI demo page in developer guides
#11873 Convert period selector to angular & allow plugins to add periods to the frontend [by @diosmosis, @mattab]
#12290 Integrity Check wants to delete whole piwik directory [by @sgiehl]
#2466 SEO Report average keyword position for google keywords
#3613 New Report: the Top IP Addresses
#4381 Include segment codes, where applicable, in all API results
#6330 Widget – Table content disappears when « Display a table with more metrics » icon is clicked
#11131 Action URL segment could filter both (Page URLs OR Event URLs) [by @mattab, @sgiehl]
#5230 Keyboard shortcuts for Piwik app [by @sgiehl]
#12045 Make it possible to configure max visits for visitor profile
#12236 New « Event URL » segment `eventUrl` to segment on any Segment URL [by @mattab]
#12242 Add possibility to restrict piwik access by ip [by @tsteur, @mattab]
#12267 In log importer, allow filtering logs by host & datetime (new submodule commit + tests). [by @diosmosis, @mattab]
#12268 Add possibility to ignore certain files in File integrity check [by @sgiehl]
#12294 Show message if visitor log shows no data because the data was purged [by @tsteur, @mattab]
#12223 Fixes seriespicker regression (changes to dashboard weren’t saved anymore) [by @sgiehl]
#12288 Small performance improvements in ArchiveProcessor [by @tsteur, @mattab]
#12289 Improve serialize dataTable performance [by @tsteur, @mattab]
#12220 use same padding for all widget content [by @fdellwing, @mattab]
#11866 In Tracking code page, clarify that at least two domains need to be set in the Websites before one can enable « Enable cross domain tracking » feature
#12254 Make all new segments « Pre-processed » when browser_archiving_disabled_enforce=1 [by @mattab]
#12286 Mention that old report data can be invalidated using the new InvalidateReports plugin [by @mattab]
#12270 make HTML in safemode-page valid [by @Findus23, @sgiehl]
#12329 Updates device detector to 3.9.1 [by @sgiehl]
#12330 Moved UI tests from core to custom alerts plugin [by @sgiehl]
#12257 Log on DEBUG level all SQL archiving queries [by @mattab]
#12203 Fix addTracker does not return the tracker instance [by @tsteur]
#12272 Prevent error Key « url » for array with keys XXX does not exist [by @mattab, @sgiehl]
#11566 Create a FAQ about tracking Internal newsletters
#12180 [automatic translation update] Updated 615 strings in 7 languages (de, el, fi, ja, nl, pl, tr) [by @sgiehl]
#12241 [automatic translation update] Updated 495 strings in 11 languages (pl, el, fa, it, ja, ko, nl, sv, tr, zh-cn, zh-tw) [by @sgiehl]
#12328 [automatic translation update] Updated 887 strings in 13 languages (cs, de, es, fr, it, ja, nb, sq, sv, tr, el, pl, zh-tw) [by @sgiehl]
#11771 added $_COOKIE to RequestSet environment [by @MichaelHeerklotz, @tsteur]
#12011 Configuration for Piwik behind nginx reverse proxy with path rewrite [by @user121216, @mattab]
#12087 Upgrade travis to trusty environment [by @mneudert, @sgiehl]
#12161 Even more HTTPS links [by @Findus23, @sgiehl]
#12179 Do not show bundles in premium feature widgets [by @tsteur, @mattab]
#12205 Date:getUtcOffset() returns in seconds, not in minutes [by @sgiehl]
#12214 Ignore Java detection on Edge as it doesn’t work [by @sgiehl, @mattab]
#12219 Command in update screen should include piwik-domain [by @sgiehl]
#12224 New setting `show_update_notification_to_superusers_only` makes it possible to hide update notifications for users except for super users [by @peterbo, @sgiehl]
#12226 When tracking, ignore user abort first [by @tsteur, @sgiehl]
#12235 Add cross domain linking helper text [by @spacenate, @mattab]
#12247 Check XML files in tests for validity [by @sgiehl, @mattab]
#12263 Disallow indexing for pages doing a redirect [by @sgiehl, @mattab]
#12287 Update Piwik PHP SDK to latest version (piwik/piwik-php-tracker) [by @mattab]
#12292 Let plugins decide whether to embed widgetized iframe empty or not [by @tsteur, @mattab]
#12303 Added events for adding and filtering profile summaries [by @tsteur]
#12309 Update check needs to sent activated plugins’ state [by @tsteur]
#12325 Do not print Piwik when a custom logo is used [by @tsteur, @mattab]

piwik/piwik-log-analytics

#194 Ability to import requests matching a particular HOST [by @diosmosis]
#196 Allow filtering logs by host & datetime [by @diosmosis, @mattab]
#86 AWS S3 logs: import Requester field as User ID
#182 Improves automatic format detection (regex improvements) [by @sgiehl]
#191 gracefully handle ValueError for generation time [by @SlavikCA, @mattab]

piwik/device-detector

#5665 PSR-6 & PSR-16 compliant cache bridges [by @bpolaszek, @sgiehl]
#5668 Mozilla/5.0 SeznamEmailProxy/2.0.174
#5670 Update bots.yml [by @razseo, @sgiehl, @bpolaszek]
#5673 Add bots for Czech Republic [by @soukicz, @sgiehl, @bpolaszek]
#5674 LOGICOM Tablette tactile M BOT TAB [by @sgiehl]
#5675 Google Pixel devices with Android 8 always detected as Opera browser. [by @sgiehl]
#5676 Some more bots [by @Findus23, @sgiehl]
#5677 Adds detection for Condor devices (www.condor.dz) [by @sgiehl, @Findus23]
#5678 Adds detection for Lexand devices (https://lexand.ru) [by @sgiehl]
#5679 Use PHPUnit\Framework\TestCase instead of PHPUnit_Framework_TestCase [by @carusogabriel, @sgiehl]
#5681 Bot detection improvement [by @sgiehl]
#5682 iPad detection improvments [by @sgiehl]
#5683 Adds device type for iPhone X [by @mneudert, @sgiehl]
#5685 Adds detection for various Huawei and Samsung devices [by @cb8, @sgiehl]
#5687 BBK doesn’t seem to have any devices
#5688 Adds detection for various Huawei and Samsung devices (part II) [by @cb8, @sgiehl]
#5689 Add phablet Samsung Galaxy Note 8 [by @weberdever, @sgiehl]

piwik/piwik-php-tracker

#28 Added support for sending and reading Tracker Cookies [by @MichaelHeerklotz, @tsteur]

piwik/piwik-icons

#6 Opera Mini, Opera Beta and Opera/Opera Mobile icons all have slightly different dimensions
#18 brand/Danew [by @sogen, @Findus23]
#19 Vodafone, Alcatel, Compaq [by @sogen, @Findus23]

piwik/piwik-package

#59 Apache2 patch [by @dg01d]
#60 remove php file from piwik-icons [by @Findus23, @mattab]

piwik/referrer-spam-blacklist

#633 Add adanih.com [by @Gaffnet, @spmedia]
#634 Added homeafrikalike.tk [by @Gaffnet, @spmedia]
#635 Added homemypicture.tk [by @Gaffnet, @spmedia]
#636 Added livingroomdecoratingideas.website [by @Gaffnet, @spmedia]
#637 Added mattgibson.us [by @Gaffnet, @spmedia]
#638 Added freewlan.info [by @Gaffnet, @spmedia]
#639 Added findercarphotos.com [by @Gaffnet, @spmedia]
#642 Added animalphotos.xyz [by @Gaffnet, @spmedia]
#643 Added 3waynetworks.com [by @Gaffnet, @spmedia]
#644 Added bedroomlighting.us [by @Gaffnet, @spmedia]
#645 Remove vc.ru [by @spmedia]
#646 Added seocheckupx.com to the list [by @pierrevanhulst, @spmedia]
#647 Added copyrightinstitute.org [by @kylevandenelsen, @spmedia]
#648 Added 1-musica.dcdcapital.com [by @Gaffnet, @spmedia]

piwik/searchengine-and-social-list

#28 some of the urls are offline
#36 360search: `m.so.com` is missing in urls [by @sgiehl]
#38 Linkedin Android URL [by @MichalTomczak, @sgiehl]
#39 mail.ru is not defined as a search engine [by @sgiehl]

We are together creating the best open analytics platform in the world. You can help make Piwik even more awesome by getting involved in Piwik!