Add cookieless Matomo analytics and opt-out (#131) (#133)

* Align Postgres version on 18.6

* Document production tablebase path and permissions

* Add cookieless Matomo analytics with opt-out (#131)
This commit is contained in:
2026-11-10 10:12:48 +01:00
committed by GitHub
parent be57f21729
commit 73ba25afe3
17 changed files with 572 additions and 29 deletions
+93
View File
@@ -0,0 +1,93 @@
# Analytics
We use a self-hosted Matomo instance for privacy-conscious analytics on public
pages and the guest trainer.
## What is collected
- Page views on anonymous public pages and the guest trainer.
- Standard request data Matomo needs to count a visit, with IP anonymisation.
We do **not**:
- set Matomo cookies,
- use user IDs,
- track signed-in account, profile, or admin pages,
- enable cross-site or advertising features,
- share analytics data with third parties.
## Configuration
The app reads these environment variables at boot:
```sh
MATOMO_URL=https://analytics.owenrees.eu/
MATOMO_SITE_ID=6
```
They are configured in `config/runtime.exs` for production only. If either is
missing, no analytics config is rendered and no tracker is loaded.
The root layout renders a hidden `#matomo-config` element only when the visitor
is anonymous. `assets/js/analytics.js` initialises Matomo cookieless from that
element. Signed-in users never receive the element.
## Matomo settings
In the Matomo administration UI:
1. **Administration → Websites → Manage**
- URL: `https://innersquare.app`
- Site ID: `6`
- Timezone: match the site
2. **Administration → Privacy → Anonymize data**
- Enable IP anonymisation (at least the last byte; 2 bytes is safer)
- Disable tracking cookies
- Respect Do Not Track
- Do not use user IDs
- Set raw data retention to **180 days**
3. **Administration → System check / trusted hosts**
- Add `innersquare.app` and `www.innersquare.app` if host validation is on.
4. Do not enable ecommerce, advertising, or cross-domain tracking.
The JavaScript also calls:
```js
_paq.push(["disableCookies"]);
_paq.push(["setDoNotTrack", true]);
```
## Opt-out
The privacy page has an **Analytics** section with an opt-out control. The
preference is stored in `localStorage["matomo_optout"]`, not a cookie. When set,
the tracker is never loaded and LiveView page views are skipped.
The preference is local to the browser. Clearing site data resets it. Users can
also object by emailing `support@innersquare.app`.
## Verification
On an anonymous public page:
```sh
curl -s https://innersquare.app/ | grep -c matomo-config
```
should return `1`.
In the browser:
- `matomo.js` and `matomo.php` load once.
- Matomo Real-time shows the page view.
- No `_pk_*` cookies are created.
- Opting out sets `matomo_optout=1` in localStorage and stops further requests.
- Signed-in pages produce no Matomo config or requests.
- A DNT browser setting suppresses tracking.
## Legal basis
Analytics runs on the basis of legitimate interests in improving the service.
The privacy policy discloses it, explains the data, and provides the opt-out.
This document is an engineering configuration guide, not legal advice; keep a
short legitimate-interest assessment on file.