La extensión de Personyze para TYPO3 añade la etiqueta de Personyze a todas las páginas de un sitio TYPO3, y se configura desde un solo campo del backend de TYPO3. Sin editar plantillas, sin TypoScript y sin nada que hacer para un desarrollador.
Compatible con TYPO3 12.4 y 13.4; requiere PHP 8.1 o posterior.
Instalación
composer require personyze/personyze-typo3Esa es toda la instalación: TYPO3 activa la extensión automáticamente.
Configuración
- En el backend de TYPO3, vaya a Admin Tools → Settings → Extension Configuration.
- Abra personyze.
- Introduzca su ID de cuenta de Personyze y guarde.
Encontrará su ID de cuenta en Personyze, en Configuración → Código de seguimiento: es el número que aparece en el fragmento de código (consulte Activar Personyze en su sitio).
La etiqueta está activa desde la siguiente carga de página. No hace falta vaciar la caché de TYPO3, ni tampoco cuando cambie el ID de cuenta más adelante.
Hay un segundo campo, Tracking domains. Déjelo vacío. Solo hace falta cuando una misma cuenta de Personyze rastrea varios dominios, y solo con el valor que le indique el soporte de Personyze.
Qué se etiqueta y qué no
- Todas las páginas públicas (front-end) del sitio.
- No el backend de TYPO3. La extensión solo se registra en la pila de middleware del front-end de TYPO3, así que el backend nunca lleva la etiqueta y los clics de sus propios editores nunca cuentan como tráfico del sitio.
- No las páginas de error. Solo se etiqueta una página HTML normal y correcta; una respuesta 404 o de error se deja exactamente como estaba.
- Nada en absoluto mientras no haya un ID de cuenta. Un ajuste vacío significa que no hay etiqueta, en lugar de una etiqueta que informe a la cuenta 0.
Verificación
Abra cualquier página pública y vea el código fuente. Busque un bloque de script que contenga stat-track-lib.js y una llamada a _S_T.setup( con su ID de cuenta. Después compruébelo en Personyze: el sitio debería empezar a registrar tráfico en pocos minutos.
Resolución de problemas
He guardado el ID de cuenta y las páginas siguen sin etiqueta. No debería ocurrir: el ajuste surte efecto en la siguiente petición, sin vaciar la caché. Si ocurre, compruebe que la extensión está activa en Admin Tools → Extensions, y recuerde que una CDN, un proxy inverso o Varnish delante de TYPO3 tienen su propia caché, que TYPO3 no puede vaciar.
No hay etiqueta en el backend de TYPO3. Es lo previsto; vea más arriba.
La etiqueta está, pero Personyze no registra tráfico. Compruebe que el ID de cuenta coincide con el de Configuración → Código de seguimiento y que está mirando la misma cuenta en Personyze.
Relacionado
- Instalar Personyze en Drupal
- Instalar Personyze en Joomla
- Plugin de WordPress: conectar, alimentar y personalizar un sitio WordPress
- Activar Personyze en su sitio: el código de seguimiento y cómo saber si funciona