a21glossary für TYPO3

Wer ein Glossar braucht, hat meistens ein SEO-Problem

Fachbegriffe auf einer Website zu erklären klingt nach Service. In Wirklichkeit löst a21glossary ein handfestes technisches Problem: TYPO3-Seiten mit erklärungsbedürftigen Inhalten ranken besser, wenn die Begriffe intern verlinkt, als eigene Seiten indexierbar und per Tooltip sofort zugänglich sind. Die Extension erzeugt aus einer zentralen Begriffsdatenbank automatisch Verlinkungen im Content, ohne dass Redakteure jeden Link manuell setzen müssen.

Für Unternehmen mit Fachportalen, Wissensplattformen oder erklärungsbedürftigen Produkten schafft a21glossary genau die interne Verlinkungsstruktur, die Google als Themenautorität wertet. Statt 50 Begriffe in einer FAQ zu verstecken, entstehen 50 eigenständige, indexierbare Seiten mit Schema-Markup-Potenzial.

Typische Einsatzszenarien

Fachportale mit mehr als 100 Begriffen. Branchenverbände, Hochschulen und Fachverlage pflegen Glossare mit hunderten Einträgen. a21glossary verlinkt jeden Begriff automatisch bei der ersten Erwähnung im Fließtext. Bei einem Kunden mit 340 Glossar-Einträgen stieg die interne Verlinkungsdichte um 28%, messbar über die Google Search Console.

Produktseiten mit technischem Vokabular. Maschinenbauer, Chemieunternehmen und Medizintechnik-Hersteller nutzen Fachsprache, die Einkäufer und Entscheider nicht immer kennen. Ein Tooltip mit 2-3 Sätzen Erklärung hält den Leser auf der Seite, statt ihn zu Google zu schicken. Die Verweildauer steigt, die Absprungrate sinkt.

Mehrsprachige Wissensplattformen. In Kombination mit TYPO3s Sprachhandling lassen sich Glossare pro Sprache pflegen. Deutsche Begriffe verlinken auf deutsche Erklärungen, englische auf englische. Das funktioniert sauber, solange die Sprachkonfiguration in TYPO3 korrekt aufgesetzt ist.

Technische Architektur

a21glossary arbeitet als Content-Post-Processor. Nach dem Rendering einer TYPO3-Seite durchsucht die Extension den HTML-Output nach definierten Begriffen und ersetzt sie durch verlinkte Varianten. Die Begriffe selbst werden in einer eigenen Datenbanktabelle gespeichert und über ein Backend-Modul gepflegt.

Die Extension registriert sich über einen Content Object Post User Func Hook im TypoScript-Rendering-Prozess. Das bedeutet: Sie greift erst ein, nachdem TYPO3 den Content vollständig gerendert hat. Dadurch funktioniert sie unabhängig vom eingesetzten Content-Element-Typ, egal ob Textmedia, News oder Custom Content Elements.

Die Tooltip-Darstellung erfolgt über ein kleines JavaScript-Snippet und CSS. Beides ist anpassbar. In modernen TYPO3-Setups empfiehlt sich, das Standard-JavaScript durch eine CSS-only-Lösung zu ersetzen, um die Core Web Vitals nicht zu belasten. Mit dem title-Attribut und einem :hover-Selektor lassen sich einfache Tooltips ohne eine einzige Zeile JavaScript realisieren.

Die Glossar-Einträge selbst sind über TypoScript konfigurierbar: Welche Seiten sollen durchsucht werden, wie oft darf ein Begriff pro Seite verlinkt werden (empfohlen: einmal), und welche HTML-Bereiche sind ausgeschlossen (Navigation, Footer, andere Glossar-Einträge).

Häufige Probleme und Lösungen

Performance-Einbruch bei großen Glossaren. Ab circa 500 Begriffen kann der Post-Processing-Schritt spürbar werden, besonders auf Seiten mit viel Text. Die Lösung: Caching aktivieren. TYPO3s Seiten-Cache speichert das Ergebnis nach dem ersten Rendering. Nur bei Cache-Leerung wird erneut verarbeitet. Zusätzlich hilft es, die Begriffsliste auf den tatsächlich genutzten Wortschatz zu reduzieren. 200 präzise Begriffe schlagen 800 inklusive Varianten.

Falsche Verlinkungen in Überschriften und Links. a21glossary verlinkt standardmäßig überall, auch innerhalb von H2-Tags oder bestehenden Hyperlinks. Das führt zu verschachtelten Links, die HTML-invalid sind. Über die TypoScript-Konfiguration lassen sich Tags ausschließen: excludeTags = h1,h2,h3,a,script. Diese Einstellung gehört in jede Erstinstallation.

Konflikte mit RealURL und Routing. In älteren TYPO3-Versionen (vor v9) kam es zu Problemen, wenn Glossar-Detailseiten über RealURL geroutet wurden. Mit TYPO3 v10+ und dem nativen Site-Routing existiert dieses Problem nicht mehr. Wer noch RealURL einsetzt, sollte ohnehin migrieren.

Migration und Versions-Kompatibilität

a21glossary wurde ursprünglich für TYPO3 v4.x entwickelt und über die Jahre aktualisiert. Die letzte aktiv gepflegte Version im TER unterstützt TYPO3 v10 und v11. Für TYPO3 v12 existiert ein Community-Fork auf GitHub, der die Extension auf die neue TCA-Struktur und das geänderte Hook-System portiert. Für TYPO3 v13 ist zum aktuellen Zeitpunkt keine offizielle Version verfügbar.

Die Migration von v11 auf v12 erfordert drei Anpassungen: erstens die Umstellung von $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS'] auf das neue Event-Dispatcher-System, zweitens die Aktualisierung der TCA-Definitionen (Wizard-Konfiguration) und drittens die Anpassung des TypoScript-Setups an die neue Site-Konfiguration.

Wer auf TYPO3 v13 plant, steht vor einer Entscheidung: den Community-Fork weiterentwickeln oder auf eine alternative Lösung umsteigen. Als Alternative bietet sich an, die Glossar-Funktionalität direkt als Custom Content Element mit DataProcessor zu implementieren. Der Aufwand liegt bei circa 2-3 Entwicklertagen, das Ergebnis ist zukunftssicher und unabhängig von Drittanbieter-Pflege. Gosign hat diese Migration bei mehreren Projekten durchgeführt und kann den tatsächlichen Aufwand auf Basis einer Analyse der bestehenden Glossar-Daten realistisch einschätzen.