newscanonical for TYPO3

Duplicate Content durch fehlende Canonical Tags kostet TYPO3-News-Seiten Rankings

Ein tx_news-Artikel ist häufig über drei oder mehr URLs erreichbar: über den Kategorie-Pfad (/news/marketing/artikel-titel), über das Archiv (/news/2025/03/artikel-titel) und über einen Direct-Link (/news/artikel-titel). Für Besucher macht das keinen Unterschied, für Google ist es ein Problem. Google sieht drei separate Seiten mit identischem Inhalt und muss entscheiden, welche die “richtige” ist. Ohne ein Canonical-Tag, das auf die bevorzugte URL zeigt, verteilt Google die Ranking-Signale auf alle Varianten und schwächt jede einzelne. newscanonical löst dieses Problem für tx_news, indem es auf jeder News-Detailseite ein Canonical-Tag generiert, das auf die definitive URL zeigt.

Die Extension ist ein fokussiertes SEO-Tool, das genau einen Job macht: Duplicate Content bei tx_news verhindern. Für Websites mit 100+ News-Artikeln kann das den Unterschied zwischen Seite 1 und Seite 3 bei Google bedeuten.

Typical use cases involve News-Websites, Magazine und Pressebereiche

Das Standardszenario ist die Unternehmenswebsite mit einem News- oder Blog-Bereich. Ein Unternehmen veröffentlicht wöchentlich Artikel, die in Kategorien (Produkte, Branchen, Events) eingeordnet sind. Jeder Artikel erscheint in der Kategorieliste und im Gesamtarchiv. Ohne newscanonical indexiert Google jede URL-Variante separat, was bei 500 Artikeln zu 1.500 indexierten Seiten mit Duplicate Content führen kann. Die Google Search Console zeigt das als “Doppelte Seite, von Google gewählte kanonische URL weicht von der vom Nutzer bestimmten ab”.

Zweites Szenario: Online-Magazine mit Tag- und Kategorie-basierten Listenansichten. Ein Magazin hat 20 Kategorien und 50 Tags. Jeder Artikel hat mindestens eine Kategorie und zwei bis drei Tags. Die Kombinatorik erzeugt dutzende mögliche URL-Pfade pro Artikel. newscanonical konsolidiert alle Varianten auf eine einzige Canonical-URL.

Drittes Szenario: Pressebereiche von börsennotierten Unternehmen. Pflichtmitteilungen müssen dauerhaft verfügbar sein und dürfen im Google-Index nicht durch Duplicate-Content-Probleme aus den Suchergebnissen fallen. Ein korrektes Canonical-Tag stellt sicher, dass Google die definitive Version indexiert.

Technical architecture setzt ein Link-Tag im HTML-Header pro News-Detailseite

newscanonical registriert sich in die Rendering-Pipeline von tx_news und fügt im HTML-Header der Detailseite ein <link rel="canonical" href="..."> Tag ein. Die Canonical-URL wird aus der konfigurierten Detail-Seiten-PID und dem News-UID berechnet, unabhängig davon, über welchen Pfad der Besucher auf die Seite gelangt ist.

Die Konfiguration erfolgt über TypoScript: Die Detail-Seiten-PID wird als Basis für die Canonical-URL gesetzt. Optionale Parameter wie die URL-Struktur (RealURL oder TYPO3 Site Handling) und die Einbeziehung von Kategorie-Segmenten in die Canonical-URL werden über Konstanten gesteuert.

Die Extension arbeitet als Hook in der tx_news-Rendering-Pipeline, nicht als eigenständiges Plugin. Das bedeutet: Sie hat keine eigene Frontend-Ausgabe und kein eigenes Content-Element. Die einzige sichtbare Auswirkung ist das Canonical-Tag im HTML-Source, das Suchmaschinen lesen, aber Besucher nie sehen.

Für die korrekte Funktion muss die Detail-Seiten-PID in der tx_news-Konfiguration und in der newscanonical-Konfiguration übereinstimmen. Wenn tx_news mehrere Detail-Seiten nutzt (z.B. eine pro Kategorie), muss newscanonical entsprechend konfiguriert werden, damit die Canonical-URL auf die richtige Detail-Seite zeigt.

Common problems include falsche PID-Konfiguration, Konflikte mit dem Core-Canonical und Redirect-Loops

Problem eins: Falsche Detail-Seiten-PID. Wenn die PID in der newscanonical-Konfiguration nicht mit der tx_news-Konfiguration übereinstimmt, zeigt das Canonical-Tag auf eine Seite, die den Artikel gar nicht anzeigen kann. Google ignoriert das Canonical-Tag dann und wählt selbst eine Variante. Die Lösung: PID-Konsistenz prüfen und in der Google Search Console die indexierten Canonical-URLs gegen die konfigurierten URLs vergleichen.

Problem zwei: Konflikte mit dem TYPO3-Core-Canonical. Seit TYPO3 v10 hat der Core eine eigene Canonical-URL-Generierung über die SEO-Erweiterung (seo system extension). Wenn beide aktiv sind, können zwei konkurrierende Canonical-Tags im HTML-Header erscheinen. Die Lösung: Prüfen, ob der Core-Canonical für News-Detailseiten korrekt arbeitet. Wenn ja, ist newscanonical überflüssig und kann deaktiviert werden. Wenn der Core-Canonical die News-Parameter nicht korrekt in die URL aufnimmt, bleibt newscanonical nötig.

Problem drei: Redirect-Loops bei fehlerhafter URL-Konfiguration. Wenn die Canonical-URL auf eine Seite zeigt, die selbst einen Redirect auf eine andere URL enthält, entsteht ein Loop. Das passiert typischerweise nach einer URL-Umstrukturierung, wenn alte Redirects nicht bereinigt wurden. Die Lösung: Alle Redirects für News-URLs prüfen und inkonsistente Einträge entfernen.

Ab TYPO3 v12 prüft Gosign, ob der Core-Canonical ausreicht

TYPO3 v12 hat den Canonical-Support im Core signifikant verbessert. Die seo system extension generiert Canonical-URLs auf Basis des Site Handling und berücksichtigt Query-Parameter. Für viele tx_news-Konfigurationen reicht der Core-Canonical seit v12 aus, sodass newscanonical nicht mehr nötig ist. Gosign prüft bei jedem TYPO3-Upgrade, ob die Core-Lösung die News-Canonical-URLs korrekt generiert. Wenn ja, empfehlen wir die Deaktivierung von newscanonical, um eine potenzielle Konfliktstelle zu eliminieren. Wenn die News-URLs komplexe Parameter oder Kategorie-Pfade enthalten, die der Core nicht auflöst, bleibt die Extension eine valide Lösung. In jedem Fall empfehlen wir nach dem Upgrade einen systematischen Crawl mit Screaming Frog oder einem vergleichbaren Tool, um alle News-Detailseiten auf korrektes Canonical-Verhalten zu prüfen. Ein einziger falsch konfigurierter Canonical-Tag kann dutzende Seiten aus dem Google-Index verdrängen, was bei Presseseiten oder SEO-relevanten Blog-Artikeln direkten Traffic-Verlust bedeutet.