Personyze installeren op TYPO3

De Personyze-extensie voor TYPO3 voegt de Personyze-tag toe aan elke pagina van een TYPO3-site, ingesteld via één veld in de TYPO3-backend. Geen template-aanpassingen, geen TypoScript, en niets te doen voor een ontwikkelaar.

Ondersteunt TYPO3 12.4 en 13.4, en vereist PHP 8.1 of nieuwer.

Installeren

composer require personyze/personyze-typo3

Dat is de hele installatie — TYPO3 activeert de extensie automatisch.

Instellen

Ga in de TYPO3-backend naar Admin Tools → Settings → Extension Configuration.
Open personyze.
Vul je Personyze-account-ID in en sla op.

Je account-ID vind je in Personyze onder Instellingen → Trackingcode: het is het getal in de snippet daar (zie Personyze activeren op je site).

De tag is actief vanaf de volgende paginalading. Je hoeft de TYPO3-cache niet te legen, en ook niet als je het account-ID later wijzigt.

Waarom er geen cache geleegd hoeft te worden. De gebruikelijke manier om in TYPO3 een script toe te voegen bakt het in de paginacache, waar een gewijzigd account-ID pas verschijnt als iemand de cache met de hand leegt — opslaan zou dan niets lijken te doen. Deze extensie voegt de snippet toe terwijl het antwoord de deur uitgaat, bij elk verzoek, uit de cache of niet. De tag weerspiegelt altijd de huidige instelling.

Er is een tweede veld, Tracking domains. Laat het leeg. Het is alleen nodig als één Personyze-account meerdere domeinen volgt, en alleen met de waarde die Personyze-support je geeft.

Wat een tag krijgt, en wat niet

Elke front-endpagina van de site.
Niet de TYPO3-backend. De extensie registreert zich alleen in de front-end-middlewarestack van TYPO3, dus de backend krijgt nooit een tag en de klikken van je eigen redacteuren tellen nooit mee als siteverkeer.
Geen foutpagina’s. Alleen een normale, geslaagde HTML-pagina krijgt de tag; een 404 of foutantwoord blijft precies zoals het was.
Helemaal niets zolang er geen account-ID is ingesteld. Een lege instelling betekent geen tag, en niet een tag die aan account 0 rapporteert.

Controleren

Open een willekeurige front-endpagina en bekijk de bron. Je zoekt één scriptblok met stat-track-lib.js en een _S_T.setup( -aanroep met je account-ID erin. Kijk daarna in Personyze: de site hoort binnen een paar minuten verkeer te melden.

Problemen oplossen

Ik heb het account-ID opgeslagen en de pagina’s hebben nog steeds geen tag. Dat hoort niet te gebeuren: de instelling werkt bij het volgende verzoek, zonder de cache te legen. Gebeurt het toch, controleer dan of de extensie actief is onder Admin Tools → Extensions. Een CDN, reverse proxy of Varnish vóór TYPO3 heeft een eigen cache die TYPO3 niet kan legen.

Geen tag in de TYPO3-backend. Dat is de bedoeling; zie hierboven.

De tag staat erop, maar Personyze meldt geen verkeer. Controleer of het account-ID overeenkomt met dat onder Instellingen → Trackingcode, en of je in Personyze naar hetzelfde account kijkt.

Personyze installeren op Drupal
Personyze installeren op Joomla
WordPress-plugin: een WordPress-site koppelen, voeden en personaliseren
Personyze activeren op je site: de trackingcode, en hoe je ziet of hij werkt