Link-Validator für TYPO3

Kaputte Links kosten Rankings und Vertrauen, und die meisten TYPO3-Websites haben davon mehr als erwartet

Eine TYPO3-Website mit 500 Seiten hat im Durchschnitt 3.000-5.000 Links. Davon sind erfahrungsgemäß 2-5% defekt: gelöschte Seiten, geänderte URLs externer Websites, Tippfehler in manuell eingegebenen Links. Das sind 60-250 Broken Links, die Besucher auf 404-Seiten schicken und Google signalisieren, dass die Website schlecht gepflegt ist. dreipc_linkvalidator prüft alle internen und externen Links automatisch und meldet Probleme, bevor sie sich auf Rankings und Nutzererfahrung auswirken.

TYPO3 bringt einen eigenen Linkvalidator im Core mit (EXT:linkvalidator). dreipc_linkvalidator erweitert diesen um zusätzliche Prüfungen, bessere Reports und eine intuitivere Backend-Oberfläche. Für Websites mit mehr als 200 Seiten ist ein automatisierter Link-Check kein Luxus, sondern Pflicht.

Typische Einsatzszenarien

Corporate Websites mit externen Verlinkungen. Unternehmenswebsites verlinken auf Partner, Lieferanten, Fachverbände, Gesetzestexte und Presseartikel. Externe URLs ändern sich ohne Vorwarnung. Ein Link auf eine EU-Verordnung funktioniert heute, wird aber nächste Woche verschoben. dreipc_linkvalidator prüft externe Links per HTTP-Request und meldet 404, 301-Ketten (mehr als 2 Redirects) und Timeouts.

Universitäten und Bildungseinrichtungen. Hochschul-Websites gehören zu den link-intensivsten Seiten überhaupt: Studienordnungen, Formulare, Vorlesungsverzeichnisse, Personenverzeichnisse, Partnerhochschulen. Bei einer Hochschul-Website mit 12.000 Seiten fand der Link-Check 1.400 defekte Links, davon 800 interne (gelöschte Seiten, umstrukturierte Bereiche) und 600 externe.

Redaktionelle Portale mit Archiv-Content. News-Portale und Magazine mit tausenden Artikeln verlinken untereinander und auf externe Quellen. Über Jahre sammeln sich Broken Links an, besonders in älteren Artikeln. Ein monatlicher Link-Check identifiziert neue Probleme, bevor sie sich häufen.

Technische Architektur

dreipc_linkvalidator erweitert TYPO3s Core-Linkvalidator um zusätzliche Prüfmechanismen. Der Core-Linkvalidator prüft Links auf Datenbankebene: Er analysiert die Felder bodytext, header_link und andere konfigurierte Felder in der Content-Tabelle und identifiziert Links auf gelöschte Seiten oder Dateien. dreipc_linkvalidator ergänzt HTTP-basierte Prüfungen für externe URLs.

Die Prüfung läuft als TYPO3 Scheduler-Task. Typische Konfiguration: einmal pro Woche nachts. Der Task durchsucht alle konfigurierten Tabellen und Felder nach Links, unterscheidet zwischen internen Links (t3://page?uid=123), Datei-Links (t3://file?uid=456) und externen Links (https://…), und prüft jeden Link auf Erreichbarkeit.

Interne Links werden gegen die TYPO3-Datenbank geprüft: Existiert die verlinkte Seite noch? Ist sie nicht versteckt, nicht gelöscht, nicht zeitlich abgelaufen? Datei-Links prüfen, ob die referenzierte Datei im FAL noch existiert. Externe Links werden per HTTP HEAD-Request geprüft (schneller als GET, da kein Body übertragen wird). Bei HEAD-Fehler folgt ein GET als Fallback.

Die Ergebnisse werden in einer Backend-Ansicht dargestellt: tabellarisch, filterbar nach Fehlertyp (404, 301, Timeout, SSL-Fehler), nach Seite und nach Redakteur. Jeder Eintrag enthält den Link, die Fehlerursache, die Seite auf der er vorkommt und einen direkten Link zum TYPO3-Backend-Editor.

Häufige Probleme und Lösungen

False Positives bei externen Links. Manche Websites blockieren automatisierte Requests (Bot-Protection, Cloudflare Challenge). Der Link funktioniert im Browser, aber der Linkvalidator meldet 403 oder Timeout. Lösung: Einen realistischen User-Agent-Header setzen, Timeouts auf 15 Sekunden erhöhen und bekannte False-Positive-Domains auf eine Whitelist setzen. Bei einem Kunden reduzierten diese Anpassungen die False-Positive-Rate von 12% auf unter 2%.

Prüfung dauert zu lange bei großen Websites. 10.000 externe Links zu prüfen dauert bei sequentieller Abarbeitung mehrere Stunden. Lösung: Parallele Prüfung konfigurieren (5-10 gleichzeitige Requests), die Prüfung auf externe Links beschränken (interne Links sind schnell per DB-Query prüfbar) und die Prüffrequenz anpassen (externe Links wöchentlich, interne täglich).

Redakteure ignorieren die Berichte. Der häufigste Grund für wachsende Broken-Link-Listen: Niemand fühlt sich zuständig. Lösung: E-Mail-Benachrichtigungen an die zuständigen Redakteure aktivieren. dreipc_linkvalidator kann Reports per E-Mail versenden, aufgeschlüsselt nach Seitenbaum-Bereich. Der Redakteur erhält nur die Broken Links in “seinem” Bereich.

Migration und Versions-Kompatibilität

TYPO3s Core-Linkvalidator (EXT:linkvalidator) ist seit v7 Bestandteil des Core und wird kontinuierlich weiterentwickelt. In TYPO3 v12 und v13 ist der Core-Linkvalidator deutlich verbessert: bessere Performance, neue UI im Backend, Scheduler-Integration überarbeitet. dreipc_linkvalidator als Erweiterung unterstützt TYPO3 v10 und v11. Für v12 und v13 existiert keine offizielle Version.

Für Projekte auf TYPO3 v12/v13 stellt sich die Frage, ob dreipc_linkvalidator noch nötig ist. Der Core-Linkvalidator in v12 deckt viele Features ab, die früher nur über dreipc verfügbar waren: HTTP-basierte Prüfung externer Links, Scheduler-Integration, Backend-Ansicht mit Filterung. Was fehlt: E-Mail-Reports und die Whitelist-Funktion für False Positives.

Die Alternative: den Core-Linkvalidator mit einem Custom Command ergänzen, der E-Mail-Reports generiert. Der Aufwand liegt bei circa einem Entwicklertag. Alternativ gibt es externe Tools (Screaming Frog, Ahrefs, Semrush), die Broken Links als Teil ihres SEO-Audits prüfen, aber nicht in TYPO3 integriert sind. Gosign empfiehlt den Core-Linkvalidator in Kombination mit einem monatlichen externen Crawl für maximale Abdeckung.