jumpurl für TYPO3

jumpurl ist seit TYPO3 7.6 aus dem Core entfernt und sollte nicht mehr eingesetzt werden

jumpurl war jahrelang fester Bestandteil des TYPO3-Cores und tat eine simple Sache: Downloads und externe Links über eine Redirect-URL leiten, um Klicks zählbar zu machen. Ein PDF-Download ging nicht direkt an den Browser, sondern über eine jumpurl-Adresse, die TYPO3 als eigenen Request verarbeitete und dann zum eigentlichen Download weiterleitete. In der Hochzeit der Extension war jumpurl eine verbreitete Lösung für Download-Tracking. Seit TYPO3 7.6 ist jumpurl nicht mehr im Core enthalten. Als eigenständige Extension existiert sie zwar weiter, aber die Architektur ist veraltet und moderne Alternativen sind in jeder Hinsicht überlegen.

Wer jumpurl noch im Einsatz hat, arbeitet mit einer Technik aus der TYPO3-v4-Ära. Die Extension erzeugt kryptische URLs mit Hash-Parametern, die weder menschenlesbar noch SEO-freundlich sind. Eigene Klickzahlen liefert die Extension dabei nicht, sie leitet nur weiter. Für ein Feature, das heute jedes Standard-Analytics-Setup über Events abbildet, ist ein zusätzlicher Redirect pro Klick nicht mehr zeitgemäß.

Typische Einsatzszenarien waren Download-Tracking und Link-Monitoring

Das Hauptszenario war und ist Download-Tracking: Wie oft wurde das Whitepaper heruntergeladen, wie oft die Preisliste, wie oft der Produktkatalog? jumpurl selbst protokolliert dabei nichts; gezählt wird über die Redirect-Requests, etwa in den Server-Logs. Unternehmen mit 50 bis 200 Downloads pro Tag nutzen diese Daten für Content-Strategie und Lead-Qualifizierung.

Zweites Szenario: Tracking externer Links. Wenn eine Unternehmenswebsite auf Partner, Lieferanten oder Ressourcen verlinkt, machen die jumpurl-Redirects in den Server-Logs sichtbar, welche externen Ziele die meisten Klicks erhalten. Das ist relevant für Affiliate-Programme, Partner-Reporting und die Analyse des Nutzerverhaltens.

Drittes Szenario: Secure Downloads mit Zugriffskontrolle. jumpurl kann Downloads an eine Benutzeranmeldung koppeln, sodass nur eingeloggte Nutzer Dateien herunterladen können. Das Token-System stellt sicher, dass direkte URLs zu geschützten Dateien nicht funktionieren. Für Unternehmen, die Whitepapers, technische Dokumentationen oder Preislisten nur nach Login bereitstellen wollen, war das in der TYPO3-v6- und v7-Ära die Standardlösung.

Technische Architektur basiert auf URL-Rewriting und einem Redirect über TYPO3

jumpurl registriert seit Version 8 eine PSR-15-Middleware im TYPO3-Frontend, die eingehende Requests mit einem jumpurl-Parameter abfängt. Der Parameter enthält die Ziel-URL oder den Dateipfad, ein zweiter Parameter (juHash) einen Hash, der die Adresse gegen Manipulation absichert. Die Middleware validiert den Hash und leitet den Browser per Redirect an das eigentliche Ziel weiter, standardmäßig mit Statuscode 303. Eine eigene Tabelle für Zugriffe legt die Extension nicht an.

Die Konfiguration erfolgt über TypoScript: global mit config.jumpurl_enable, pro Link oder Datei-Link mit der typolink-Option jumpurl, für E-Mail-Links abschaltbar mit config.jumpurl_mailto_disable. Die Extension modifiziert automatisch die generierten Links im Frontend, sodass Redakteure nichts manuell anpassen müssen. Die Integration ist transparent: Redakteure verlinken Dateien wie gewohnt, und jumpurl schiebt die Weiterleitung automatisch dazwischen.

Ein eigenes Tracking-Log oder Backend-Modul bringt die Extension nicht mit. Ausgewertet wird, was der Webserver ohnehin protokolliert: Zeitstempel, IP-Adresse (DSGVO-relevant), die aufgerufene jumpurl-Adresse mit dem Ziel, HTTP-Referrer und User-Agent.

Häufige Probleme betreffen SEO, DSGVO und Kompatibilität mit URL-Rewriting

Problem eins: SEO-Schaden durch Redirect-Ketten. jumpurl-URLs sind keine echten Seiten-URLs, sondern Redirect-Intermediäre. Wenn Google einen jumpurl-Link indexiert (was bei falscher Konfiguration passiert), entsteht eine Redirect-Kette, die Crawl-Budget verschwendet und Link-Juice verdünnt. Die Lösung: Sicherstellen, dass jumpurl-URLs ein noindex-Tag oder ein robots-Disallow haben.

Problem zwei: DSGVO-Konformität. jumpurl selbst speichert nichts, aber jeder Klick landet mit IP-Adresse im Log des Webservers. Ohne Pseudonymisierung oder Löschkonzept ist das ein Verstoß gegen die DSGVO. Die Server-Logs müssen deshalb regelmäßig bereinigt oder die IP-Adressen vor dem Speichern anonymisiert werden.

Problem drei: Kompatibilität mit modernem URL-Routing. TYPO3 v12 nutzt Site-Handling und Symfony-basiertes Routing. jumpurl läuft als Middleware zwar auch unter v12, hängt seine Parameter aber als Query-String an die Seiten-URL an, sodass die sprechenden URLs des Routings wieder kryptische Anhänge bekommen. Die Lösung ist die Migration auf eine moderne Alternative. Zusätzlich stören die kryptischen jumpurl-Parameter in der Browser-Adresszeile die User Experience: Nutzer sehen eine URL mit Hash-Werten statt eines lesbaren Dateipfads, was Misstrauen erzeugen kann.

Migration auf eventbasiertes Tracking ist bei jedem TYPO3-Upgrade der empfohlene Weg

Die Extension wird weiter gepflegt, Version 9.0.0 vom November 2024 unterstützt TYPO3 v12.4 und v13.4. Bei einer Migration empfiehlt Gosign trotzdem den Wechsel auf eventbasiertes Download-Tracking. Konkret bedeutet das: Ein data-Attribut auf Download-Links (z.B. data-track=“download”) und ein JavaScript-Event-Listener, der Klicks an Matomo, Google Analytics 4 oder ein Custom-Endpoint sendet. Für Secure Downloads ist die Kombination aus FAL-basiertem Dateizugriff und einem Token-System die moderne Alternative.

Der Migrationsaufwand hängt von der Menge der bestehenden jumpurl-Links ab. Wenn externe Quellen (Newsletter, Social Media, Print) auf jumpurl-URLs verweisen, müssen Redirects eingerichtet werden. Gosign analysiert die vorhandenen Zugriffsdaten auf die jumpurl-Adressen, identifiziert die meistgenutzten Downloads und konfiguriert die neue Tracking-Lösung so, dass historische Vergleichbarkeit gewährleistet bleibt. Typischerweise sind 80% der bestehenden jumpurl-Links interne Verlinkungen, die automatisiert umgeschrieben werden können. Die verbleibenden 20% sind externe Referenzen, für die permanente 301-Redirects eingerichtet werden müssen, damit kein Link-Juice verloren geht.