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 überall 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 als Datensätze im Listenmodul gepflegt.

Die Extension hängt sich seit Version 12.0.0 über das PSR-14-Event AfterCacheableContentIsGeneratedEvent in die Seitenausgabe ein, bis Version 11 über den Hook contentPostProc-all. 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 übernimmt der Browser: a21glossary schreibt die Erklärung als title-Attribut in abbr-, acronym- oder dfn-Tags und bringt kein JavaScript mit. Wer den Tooltip gestalten will, setzt auf eine CSS-only-Lösung, 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, welche Begriffstypen werden verlinkt, 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 bestehenden Links. a21glossary verlinkt standardmäßig auch innerhalb bestehender Hyperlinks; Überschriften h1 bis h6 sind von Haus aus ausgeschlossen. Das führt zu verschachtelten Links, die HTML-invalid sind. Über die TypoScript-Konfiguration lässt sich die Standardliste um das a-Tag ergänzen: excludeTags = acronym,abbr,dfn,h1,h2,h3,h4,h5,h6,input,pre,script,a. 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 3.x entwickelt und über die Jahre aktualisiert. Seit 2017 pflegt Sven Wappler (WapplerSystems) die Extension; im TER steht seine Version 12.0.1 für TYPO3 v12, welche die Extension auf die neue TCA-Struktur und das geänderte Hook-System portiert. Für TYPO3 v13 gibt es Version 13.0.0 über Composer (Packagist), im TER steht sie noch nicht.

Beim Sprung von v11 auf v12 hat WapplerSystems die Extension in Version 12.0.0 selbst angepasst: erstens die Umstellung von $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS'] auf das neue Event-Dispatcher-System, zweitens die Aktualisierung der TCA-Definitionen. Das TypoScript-Setup blieb unverändert, Anwender aktualisieren nur die Extension.

Wer auf TYPO3 v13 plant, steht vor einer Entscheidung: auf a21glossary 13.0.0 aktualisieren 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.