Installer Personyze sur TYPO3

L’extension Personyze pour TYPO3 ajoute la balise Personyze à chaque page d’un site TYPO3, et se configure depuis un seul champ du backend TYPO3. Aucune modification des templates, pas de TypoScript, et rien à faire pour un développeur.

Compatible avec TYPO3 12.4 et 13.4 ; nécessite PHP 8.1 ou plus récent.

Installation

composer require personyze/personyze-typo3

C’est toute l’installation : TYPO3 active l’extension automatiquement.

Configuration

Dans le backend TYPO3, allez dans Admin Tools → Settings → Extension Configuration.
Ouvrez personyze.
Saisissez votre ID de compte Personyze et enregistrez.

Votre ID de compte se trouve dans Personyze, sous Paramètres → Code de suivi : c’est le nombre qui figure dans le snippet (voir Activer Personyze sur votre site).

La balise est active dès le chargement de page suivant. Inutile de vider le cache TYPO3, ni maintenant ni quand vous changerez l’ID de compte plus tard.

Pourquoi il n’y a pas de cache à vider. La méthode habituelle pour ajouter un script dans TYPO3 l’intègre au cache des pages, où un ID de compte modifié n’apparaîtrait qu’après un vidage manuel du cache — enregistrer le réglage semblerait ne rien faire. Cette extension ajoute le snippet au moment où la réponse part, à chaque requête, qu’elle vienne du cache ou non. La balise reflète toujours le réglage actuel.

Il existe un second champ, Tracking domains. Laissez-le vide. Il ne sert que lorsqu’un même compte Personyze suit plusieurs domaines, et uniquement avec la valeur que vous communique le support Personyze.

Ce qui reçoit la balise, et ce qui ne la reçoit pas

Chaque page publique (front-end) du site.
Pas le backend TYPO3. L’extension ne s’enregistre que dans la pile de middlewares front-end de TYPO3 : le backend n’est donc jamais balisé, et les clics de vos propres éditeurs ne sont jamais comptés comme du trafic.
Pas les pages d’erreur. Seule une page HTML normale, réussie, reçoit la balise ; une 404 ou une réponse d’erreur est laissée telle quelle.
Rien du tout tant qu’aucun ID de compte n’est défini. Un réglage vide signifie pas de balise, plutôt qu’une balise qui remonte vers le compte 0.

Vérification

Ouvrez n’importe quelle page publique et affichez la source. Vous cherchez un bloc de script contenant stat-track-lib.js et un appel _S_T.setup( avec votre ID de compte. Vérifiez ensuite dans Personyze : le site doit commencer à remonter du trafic en quelques minutes.

Dépannage

J’ai enregistré l’ID de compte et les pages n’ont toujours pas de balise. Cela ne devrait pas arriver : le réglage prend effet à la requête suivante, sans vider le cache. Si c’est le cas, vérifiez que l’extension est active dans Admin Tools → Extensions, et rappelez-vous qu’un CDN, un reverse proxy ou Varnish placé devant TYPO3 a son propre cache, que TYPO3 ne peut pas vider.

Pas de balise dans le backend TYPO3. C’est voulu ; voir plus haut.

La balise est présente mais Personyze ne remonte aucun trafic. Vérifiez que l’ID de compte correspond à celui de Paramètres → Code de suivi, et que vous regardez le même compte dans Personyze.

Installer Personyze sur Drupal
Installer Personyze sur Joomla
Plugin WordPress : connecter, alimenter et personnaliser un site WordPress
Activer Personyze sur votre site : le code de suivi, et comment savoir s’il fonctionne