Craft CMS-plugin

MetriXs heeft een officiële Craft CMS-plugin die de tracker op elke pagina van je site zet, je site automatisch verifieert () en strikte opt-in blijft: er wordt niets geladen tot je hem verbindt. Geen themabewerking, geen Twig-snippets, geen cookiemelding.

Deze guide loopt door de complete installatie, stap voor stap.

Voordat je begint

Je hebt een MetriXs-account nodig. De plugin zelf is gratis en volledig functioneel; het gratis MetriXs-plan is genoeg om te starten.

1. Ga naar app.metrixs.eu en registreer je
2. Bevestig je e-mailadres via de link die je ontvangt

Stap 1: voeg je site toe in MetriXs

1. Log in op het MetriXs-dashboard
2. Voeg tijdens het onboarding (of via Instellingen → Sites) het domein van je site toe, bijv. jouwsite.nl — zonder https:// en zonder www.
3. Sla de voorgestelde handmatige snippet-verificatie over — de plugin verifieert je site automatisch in stap 4
4. Start indien gevraagd een proefperiode of kies het gratis plan (events vereisen een actief plan)

Stap 2: maak een sitesleutel aan

De plugin authenticiteert met een sitespecifieke API-sleutel. Die geeft alleen toegang tot deze ene site (stats:read + event:write), nooit tot je account, en is op elk moment in te trekken.

1. Ga in het dashboard naar Instellingen → Sites
2. Vouw je site uit en zoek het gedeelte API-sleutels
3. Klik op Create API key en geef hem een naam, bijv. “Craft”
4. Kopieer de sleutel (mtx_live_...) meteen — hij wordt één keer getoond en is later niet meer op te halen

Stap 3: installeer de plugin

Installeer via Composer vanuit je Craft-projectroot:

composer require metrixs/mx-cookieless-analytics

of installeer hem vanuit de Plugin Store in de Craft-beheeromgeving.

Activeer daarna de plugin:

php craft plugin/install mx-cookieless-analytics

Stap 4: configureer de plugin

Ga in de Craft-beheeromgeving naar Instellingen → Plugins → MX Cookieless Analytics:

Veld	Wat in te vullen
Enable tracking	Laat voorlopig uit — aanzetten na verificatie
Site API key	De sleutel uit stap 2
MetriXs URL	Laat de standaardwaarde https://app.metrixs.eu staan
Site domain	Laat leeg voor automatische detectie via de primaire site-URL
Exclude admins	Standaard aan — gebruikers met beheerderstoegang tellen niet

Klik op Opslaan. De plugin verifieert je site automatisch met hetzelfde opslaan — je ziet de groene bevestiging “site verified” (of een foutmelding met uitleg). Zet Enable tracking aan en sla opnieuw op.

Stap 5: controleer of tracking werkt

1. Open je site in een incognitovenster en bezoek een paar pagina’s
2. Open het MetriXs-dashboard en check de Realtime-weergave — pageviews moeten binnen enkele seconden verschijnen

Let op: gebruikers met beheerderstoegang zijn standaard uitgesloten. Reguliere ingelogde gebruikers worden wel gevolgd. Test in incognitomodus of pas de uitsluiting aan in de plugin-instellingen.

Hoe de verificatie werkt: de plugin vraagt de MetriXs-API om een eenmalige challangetoken, servet hem vanaf je eigen domein en de API haalt hem terug. Alleen iemand die jouw domein beheert kan de token serveren — dat bewijst eigendom De token wordt weer verwijderd zodra de uitwisseling klaar is.

Instellingenreferentie

Instelling	Standaard	Betekenis
Enable tracking	Uit	Hoofdschakelaar — er wordt niets geladen tot de site verbonden is en dit aan staat
Site API key	—	Sitespecifieke sleutel uit het dashboard
MetriXs URL	https://app.metrixs.eu	Alleen wijzigen voor eigen endpoints (alleen HTTPS)
Site domain	Leeg (auto)	Moet overeenkomen met het domein in MetriXs
Exclude admins	Aan	Gebruikers met beheerderstoegang niet volgen

Het tracker-script wordt vanaf app.metrixs.eu geleverd met een geversioneerde URL, geregistreerd in de pagina-head via Craft’s asset-pipeline en asynchroon (defer) geladen. Hij werkt prima naast caching- en CDN-setups.

Problemen oplossen

Verificatie mislukt

• Zorg dat je site openbaar bereikbaar is via HTTPS (geen onderhoudsmodus, geen firewall die de MetriXs-servers blokkeert)
• Sla de plugin-instellingen opnieuw op — de uitwisseling draait bij elk opslaan

Geen data in het dashboard

• De plugin-instellingen moeten de “site verified”-bevestiging hebben getoond
• Enable tracking moet aan staan
• Het sitedomein moet exact overeenkomen met het domein in MetriXs (zonder www., zonder https://)
• Ben je als beheerder ingelogd? Standaard uitgesloten — test incognito

API-sleutel kwijt Sleutels zijn na aanmaak niet op te halen. Trek de oude in het dashboard in (Instellingen → Sites → API-sleutels), maak een nieuwe aan en vul die in de plugin in.

Configureren zonder de beheeromgeving De auto-verificatie draait bij het opslaan van instellingen. Wil je de beheeromgeving niet gebruiken, installeer de plugin dan alsnog en verifieer je site handmatig: het dashboard toont je snippet, en MetriXs bevestigt het eigendom door hem op je site te herkennen.

Deinstalleren

Als je de plugin verwijdert:

• Je site wordt niet automatisch ontkoppeld in MetriXs — trek de API-sleutel in het dashboard in (Instellingen → Sites → API-sleutels) om de invoer te stoppen
• Je historische gegevens blijven in je MetriXs-account

Liever zonder plugin?

Je kunt de tracker altijd handmatig toevoegen met het fragment uit de platformguides — de plugin automatiseert alleen installatie en verificatie.