Compass - Heatmap Analytics

[maximus]

Hey everyone!

Built a heatmap module for ProcessWire, thought I'd share.

It tracks clicks, mouse movement, rage clicks and scroll depth — and shows everything as a heatmap right in the admin. No third-party services, all data stays on your server.

You pick a page from the list, it loads in an iframe with the heatmap overlaid on top. Switch between click/movement/rage/scroll tabs, filter by date and device type, export as PNG if you need it.

Install is just drop the folder into /site/modules/ and hit Install. The tracker injects itself automatically, nothing to configure.

GitHub: https://github.com/mxmsmnv/Compass

[adrian]

Hey @maximus - another great one! 

I noticed that the settings default to having "superuser" in the excluded roles, but even if you remove that, this line: 

$excludedRoles = $this->parseConfigList($this->get('exclude_roles')) ?: ['superuser'];

forces the superuser block anyway. This confused me for a bit while testing.

[adrian]

PS, Native Analytics is hookable (https://github.com/Roychgod/NativeAnalytics/pull/15) these days, so I took the approach of actually building my Behavior/Heatmap module to add a tab to that module. Not sure if you think it would be a good approach for Compass, but just thought I'd throw the idea out there in case you didn't know about the option.

[maximus]

Thanks @adrian, great catch on the superuser fallback. You were right — that made the setting misleading if someone intentionally cleared the excluded roles list. I’ve fixed that in 1.1.0, so leaving the field blank now tracks all roles.

Also, thanks for the heads-up about Native Analytics being hookable now. I hadn’t been following its recent development closely, so I didn’t know about that change.

I liked your suggestion and added optional Native Analytics integration in 1.1.0 as well. Compass remains fully standalone via Setup → Compass, but if Native Analytics with hookable dashboard tabs is installed, Compass now adds its own tab there too.

And yes, I still think there’s room for smaller focused tools alongside bigger all-in-one analytics modules. Sometimes people just need a specific behavior/heatmap tool without adopting a broader analytics setup.

Fun side note: Compass was originally started in April 2026 in Philadelphia, while I was at a Mel Robbins event.