MilkStats

Beschrijving

MilkStats houdt bezoekersstatistieken bij zonder persoonsgegevens te verzamelen.
Alle data blijft lokaal in je eigen WordPress-database — er wordt niets gedeeld met externe analysediensten (geen Google Analytics, geen externe scripts of lettertypen).
Een product van 5Names.

Wat wordt gemeten?

• Paginaweergaven — geteld en geaggregeerd per pagina, per dag
• Sessies — hoeveel unieke bezoekerssessies er waren
• Tijd op pagina — hoe lang iemand op een pagina bleef
• Navigatiepaden — welke pagina het vaakst leidt naar welke volgende pagina
• Sources — did the visitor arrive via a search engine, social media, a
  referring site, an AI assistant, or directly? Plus UTM campaign tags
  (utm_source, utm_medium, utm_campaign) if you use them in your own
  marketing links.
• Evenementen — klikken op uitgaande links en download links worden automatisch gedetecteerd, plus optionele aangepaste gebeurtenissen via het data-milkstats-event attribuut. Zie “Aangepaste gebeurtenissen” hieronder.
• AI-crawlerzichtbaarheid — hoe vaak bekende AI-crawlers (GPTBot, ClaudeBot, PerplexityBot, en andere) je site bezoeken, apart van menselijk verkeer.

Wat wordt NOOIT opgeslagen?

• Geen IP-adressen
• No tracking cookies — the session ID lives only in the browser’s
  sessionStorage and disappears as soon as the tab is closed. The only
  cookie this plugin can ever set is the optional opt-out cookie described
  below, and only if you or a visitor chooses to set it.
• Geen browser-fingerprinting
• No full referrer URLs — only the domain (e.g. “google.com”), never the
  path or a search query that might be contained in it
• Geen gegevens verzonden naar externe partijen

Hoe werkt het technisch?

On every page view, a small, first-party JavaScript file (assets/tracker.js)
sends an AJAX request to your own admin-ajax.php. That request contains the
page URL, page title, a random session ID, and — only on the first page view
of a session — the hostname of the referring site and any UTM parameters.
When the page is left, the time on page is sent afterwards via
navigator.sendBeacon.

Deze gegevens belanden uiteindelijk in de volgende tabellen in je WordPress database:

1. wp_milkstats_pageviews — dagelijkse totalen per pagina. Wordt voor onbepaalde tijd bewaard: alleen aantallen, geen sessie-informatie.
2. wp_milkstats_session_events — individuele paginaweergaven per sessie, met tijd op pagina. Wordt automatisch verwijderd na de ingestelde bewaartermijn.
3. wp_milkstats_sessions — één rij per sessie met de verkeersbron (first-touch attributie). Wordt ook opgeruimd na de bewaartermijn.
4. wp_milkstats_events — aangepaste events (uitgaande linkklikken, downloads,
   handmatige gebeurtenissen). Opgeschoond na de bewaartermijn, net als sessie gegevens.
5. wp_milkstats_device_stats — daily aggregated device/browser/OS counts.
   Kept indefinitely, like page totals — never traceable to an individual.
6. wp_milkstats_ai_crawler_hits — dagelijkse geaggregeerde hits van bekende AI-crawlers. Wordt voor onbepaalde tijd bewaard, net als paginatotalen.

Een dagelijkse WP-Cron taak ruimt sessiegegevens op die ouder is dan de ingestelde bewaartermijn. Paginatotalen worden nooit verwijderd. Bots worden herkend en genegeerd op basis van de User-Agent.

Aangepaste gebeurtenissen

Naast paginaweergaven meet MilkStats ook events, zonder dat daar configuratie voor nodig is:

• Uitgaande links — een klik op een link naar een ander domein wordt automatisch geregistreerd, met het domein als label.
• Downloads — een klik op een link naar een bestand met een bekende download-extensie (pdf, zip, docx, xlsx, en meer) wordt automatisch geregistreerd, met de bestandsnaam als label.
• Handmatige gebeurtenissen — voeg het data-milkstats-event="label"-attribuut toe aan een
  link, knop of <form> om die klik of verzending als een aangepaste
  Gebeurtenis te volgen, bijvoorbeeld:
  Een offerte aanvragen
  of <form data-milkstats-event="Contact form submitted">…</form>.

Gebeurtenissen tellen mee als de bezoeker niet is uitgesloten (zie Instellingen) en worden op de statistiekenpagina getoond onder “Gebeurtenissen”, met de top labels per type.

Jezelf uitsluiten (opt-out)

Naast de roluitsluiting (werkt alleen terwijl je bent ingelogd) kun je jezelf — of een externe tester — ook uitsluiten zonder in te loggen:

• Via the admin bar — administrators see a MilkStats item at the top
  (“tracking on”/”tracking off”) to flip this with one click.
• Via een link — bezoek ?milkstats_optout=1 om jezelf uit te sluiten, of
  ?milkstats_optout=0 om weer meegeteld te worden. Werkt ook terwijl je bent uitgelogd, handig om te delen met externe testers.
• Via de instellingenpagina — een knop (“Sluit mijn bezoeken in deze browser uit”) die de huidige status toont.

This sets a first-party cookie (milkstats_optout) in that one browser. The
cookie itself has no tracking purpose — purely a toggle — and works alongside
the role exclusion, not instead of it.

Instellingen

Onder Site Analytics → Instellingen kun je configureren:

• Uitgesloten rollen — welke gebruikersrollen nooit worden meegeteld (standaard: beheerder, redacteur, auteur, medewerker)
• Jezelf uitsluiten — een knop om je eigen bezoeken in de huidige browser uit te sluiten, ook terwijl je bent uitgelogd (zie “Jezelf uitsluiten” hierboven)
• Ledensegment — optioneel: welke rol(len) apart geteld moeten worden als een “ingelogd segment” (bv. leden, klanten, abonnees), met een eigen naam voor dat segment in de statistieken. Er kunnen tot drie extra benoemde segmenten worden geconfigureerd, elk te kiezen via een dropdown op de statistiekenpagina.
• Bewaartermijn — na hoeveel dagen sessiedata (tijd op pagina, navigatiepaden, bronnen) automatisch wordt verwijderd

Waar zie ik de statistieken?

• Een compact overzicht op het WordPress dashboard (widget)
• A full statistics page under Site Analytics in the main menu, with a
  rolling period filter (7/30/90/365 days) plus a calendar period picker
  (today/yesterday, this/last week, this/last month, this/last quarter,
  this/last year), bar chart, top pages, navigation paths, source breakdown,
  device/browser/OS breakdown, and AI crawler visibility

Credits

De adminschermen gebruiken het lettertype Inter van Rasmus Andersson, meegeleverd met de plugin onder de SIL Open Font License 1.1 (assets/fonts/OFL.txt). Het wordt vanaf je eigen site geserveerd — nooit vanaf een externe font-CDN.