Matomo Tracker Versions Save

New Features ✨

• Packages are now published under the @jonkoops organization on NPM (see migration guide).

Enhancements 📝

• Source files are now included in the NPM package (see #711).
• Children prop added to MatomoProvider (see #798)

Migration :truck:

Since the municipality of Amsterdam no longer has any interest in maintaining these libraries they have been moved to a new organization. The packages have been renamed as follows:

• @datapunt/matomo-tracker-js :arrow_right: @jonkoops/matomo-tracker
• @datapunt/matomo-tracker-react :arrow_right: @jonkoops/matomo-tracker-react

To upgrade your project run the following commands:

npm uninstall @datapunt/matomo-tracker-js @datapunt/matomo-tracker-react
npm install @jonkoops/matomo-tracker @jonkoops/matomo-tracker-react

• Fixed: support array of instructions on initial options on configurations object

• Added: Support outbound links on <a> child elements.
• Added: removeEcommerceItem and clearEcommerceCart action

• Added: Support React v17

• Fixed: External links not being tracked

• Changed: methods returned from useMatomo are now memoized so they can be tracked as dependencies (for example in useEffect)
• [BREAKING] Changed: The siteId option in the MatomoTracker constructor is now required.

• Fixed: The params argument for the trackPageView method is now optional
• Fixed: The pushInstruction method is now exposed through useMatomo

• Added: include configurations in the MatomoTracker.initialize params
• Added: add a generic pushInstruction method to pass instructions to Matomo
• Added: add disabled flag to options to make all tracking calls no-ops
• Removed: removed the window.MatomoTracker global
• Fixed: enableHeartBeat always set default seconds value

• Added: Exposed trackEvents function to useMatomo
• Changed: TrackEvents on DOM changes using a MutationObserver
• Added: include userId in the MatomoTracker.initialize params

• Add e-commerce tracking
• Expose trackLink in react package
• Check on window object (no reference error during SSR)