Piwik 3.2.1 released


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!

New Plugins

By Piwik and Innocraft

By third party developers:

Changes for Developers

  • Themes can now customize the header text color using @theme-color-header-text
  • New event Widgetize.shouldEmbedIframeEmpty added so plugins can optionally define the output of the widgetized HTML themselves
  • New events added to add and filter visitor details: Live.addProfileSummaries and Live.filterProfileSummaries
  • New JavaScript method piwikHelper.registerShortcut allows plugins to bind keyboard shortcuts. A summary for available shortcuts will be shown by pressing ?

For more developer changes, check out the Piwik Platform Changelog

List of 111 tickets closed in Piwik 3.2.1

Click to expand list


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


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


#59 Piwik Debian package: Apache2 improvements [by @dg01d]


#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, @sgiehl]
#5673 Add bots for Czech Republic [by @soukicz, @sgiehl, @bpolaszek, @sgiehl]
#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, @sgiehl]
#5678 Adds detection for Lexand devices (https://lexand.ru) [by @sgiehl, @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]


#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]


#4577 Ability to restrict user login to specific IP addresses
#6880 Various bugs when using SSL and/or a reverse proxy
#12288 Small performance improvements in ArchiveProcessor [by @tsteur, @mattab]
#12289 Improve serialize dataTable performance [by @tsteur, @mattab]
#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
#5230 Keyboard shortcuts for Piwik app [by @sgiehl]
#8942 New plugin: provide simple UI to invalidate old reports [by @sgiehl]
#11131 Action URL segment could filter both (Page URLs OR Event URLs) [by @mattab, @sgiehl, @sgiehl, @sgiehl, @mattab]
#12045 Make it possible to configure max visits for visitor profile
#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, @mattab]
#12233 Use consistent HTML email body for all scheduled reports (HTML, PDF & CSV) [by @diosmosis, @mattab]
#12236 New “Event URL” segment eventUrl to segment on any Segment URL [by @mattab, @mattab]
#12242 Add possibility to restrict piwik access by ip [by @tsteur, @mattab]
#12262 Add visitor details events [by @tsteur, @tsteur]
#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]
#12283 Show shortcut help screen when pressing ? [by @sgiehl, @mattab]
#12294 Show message if visitor log shows no data because the data was purged [by @tsteur, @mattab]
#12270 make HTML in safemode-page valid [by @Findus23, @sgiehl]
#12329 Updates device detector to 3.9.1 [by @sgiehl, @sgiehl]
#12330 Moved UI tests from core to custom alerts plugin [by @sgiehl, @sgiehl]
#6330 Widget - Table content disappears when “Display a table with more metrics” icon is clicked
#6644 Some URLs not resolved appropriately behind proxy
#7898 Piwik under sub path URL
#10605 Sometimes the datatable footer controls can be hidden [by @sgiehl]
#12113 issue with Widgetized dashboards: only [object Object] displayed [by @sgiehl]
#12166 Embedding Dashboard as Widget/Iframe, cannot select a segment [by @tsteur, @mattab]
#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]
#12203 Fix addTracker does not return the tracker instance [by @tsteur, @tsteur]
#12272 Prevent error Key “url” for array with keys XXX does not exist [by @mattab, @sgiehl]
#12290 Integrity Check wants to delete whole piwik directory [by @sgiehl]
#11566 Create a FAQ about tracking Internal newsletters
#11710 Document how to view our UI demo page in developer guides
#11765 https proxy call brakes logo.svg URL (also some strange redirect removing /piwik/ folder) and getting a “No input file specified.” response.
#11771 added $_COOKIE to RequestSet environment [by @MichaelHeerklotz, @tsteur]
#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
#11873 Convert period selector to angular & allow plugins to add periods to the frontend [by @diosmosis, @diosmosis, @mattab, @diosmosis]
#12011 Configuration for Piwik behind nginx reverse proxy with path rewrite [by @user121216, @mattab]
#12087 Upgrade travis to trusty environment [by @mneudert, @sgiehl, @mneudert]
#12143 Backspace eats extra characters [by @Morerice, @Morerice, @sgiehl]
#12161 Even more HTTPS links [by @Findus23, @sgiehl]
#12171 Formats numbers in the real time widget [by @AMcNeice, @mattab]
#12173 Release Piwik 3.2.0 [by @mattab, @mattab]
#12179 Do not show bundles in premium feature widgets [by @tsteur, @mattab]
#12180 [automatic translation update] Updated 615 strings in 7 languages (de, el, fi, ja, nl, pl, tr) [by @sgiehl, @sgiehl]
#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]
#12220 use same padding for all widget content [by @fdellwing, @mattab]
#12223 Fixes seriespicker regression (changes to dashboard weren’t saved anymore) [by @sgiehl, @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]
#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, @sgiehl]
#12247 Check XML files in tests for validity [by @sgiehl, @mattab]
#12254 Make all new segments “Pre-processed” when browser_archiving_disabled_enforce=1 [by @mattab, @mattab]
#12257 Log on DEBUG level all SQL archiving queries [by @mattab, @mattab]
#12263 Disallow indexing for pages doing a redirect [by @sgiehl, @mattab]
#12286 Mention that old report data can be invalidated using the new InvalidateReports plugin [by @mattab, @mattab]
#12287 Update Piwik PHP SDK to latest version (piwik/piwik-php-tracker) [by @mattab, @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, @tsteur]
#12309 Update check needs to sent activated plugins’ state [by @tsteur, @tsteur]
#12325 Do not print Piwik when a custom logo is used [by @tsteur, @mattab]
#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, @sgiehl]
#12332 Fixed broken docs link [by @gricey432, @sgiehl]


#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, @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]


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