jumpurl para TYPO3

jumpurl fue eliminado del Core desde TYPO3 7.6 y no debería seguir usándose

jumpurl fue durante años parte fija del Core TYPO3 y hacía algo sencillo: redirigir descargas y enlaces externos a través de una URL de tracking para hacer contables los clics. Desde TYPO3 7.6, jumpurl ya no está en el Core. Como extensión independiente sigue existiendo, pero la arquitectura está obsoleta y las alternativas modernas son superiores en todos los aspectos.

Quien aún tiene jumpurl en uso, trabaja con una técnica de la era TYPO3 v4. La extensión genera URLs crípticas con parámetros hash que no son legibles ni amigables para SEO. La extensión no genera recuentos de clics propios; solo redirige.

Escenarios de uso habituales

El escenario principal era y es el tracking de descargas: cuántas veces se descargó el whitepaper, cuántas la lista de precios. Segundo escenario: tracking de enlaces externos. Tercer escenario: descargas seguras con control de acceso mediante sistema de tokens.

Arquitectura técnica

Desde la versión 8, jumpurl registra un middleware PSR-15 en el frontend de TYPO3 que intercepta peticiones entrantes con un parámetro jumpurl. El parámetro contiene la URL destino o la ruta del archivo, y un segundo parámetro (juHash) contiene un hash que protege la dirección frente a manipulaciones. El middleware valida el hash y redirige el navegador al destino real, por defecto con el código de estado 303. La extensión no crea ninguna tabla propia para los accesos.

Problemas frecuentes

Problema uno: daño SEO por cadenas de redirección. Problema dos: conformidad con el RGPD, ya que cada clic queda registrado con su dirección IP en el log del servidor web, aunque jumpurl no almacene nada. Problema tres: compatibilidad con el routing moderno de TYPO3 v12 basado en Site Handling y Symfony.

Migración y compatibilidad de versiones

La extensión sigue manteniéndose: la versión 9.0.0 de noviembre de 2024 soporta TYPO3 v12.4 y v13.4. Aun así, en una migración Gosign recomienda el cambio a tracking de descargas basado en eventos. Concretamente esto significa: un atributo data en los enlaces de descarga y un event listener JavaScript que envía clics a Matomo, Google Analytics 4 o un endpoint personalizado. Para descargas seguras, la combinación de acceso a archivos basado en FAL y un sistema de tokens es la alternativa moderna.

El esfuerzo de migración depende de la cantidad de enlaces jumpurl existentes. Gosign analiza los datos de acceso existentes a las direcciones jumpurl, identifica las descargas más utilizadas y configura la nueva solución de tracking de modo que se mantenga la comparabilidad histórica.