dpn_glossary dla TYPO3

Słownik przynosi wartość SEO, gdy wewnętrzne linkowanie działa automatycznie

Ręczne linkowanie terminów fachowych na stronie to syzyfowa praca. Firma z 200 podstronami i 80 terminami fachowymi musiałaby teoretycznie przeglądnąć każdą stronę i połączyć odpowiednie pojęcia ze stroną słownika. W praktyce to nigdy nie jest realizowane kompletnie, a przy nowych treściach zapomina się o tym. dpn_glossary automatyzuje ten proces: rozszerzenie rozpoznaje zdefiniowane terminy w treści i automatycznie linkuje je z odpowiednią stroną słownika lub wyświetla definicję jako tooltip.

Efekt SEO jest mierzalny. Każdy termin słownikowy tworzy własny indeksowalny URL. Automatyczne linkowanie z treści buduje gęstą wewnętrzną sieć linków, która pomaga Google ocenić autorytet tematyczny strony. Witryny z ponad 50 terminami słownikowymi generują typowo od 5 do 15% dodatkowego ruchu organicznego przez słowa kluczowe long-tail.

Typowe scenariusze zastosowań

Portale branżowe i strony sektorowe. Ubezpieczalnie, instytucje finansowe, kancelarie prawne, firmy techniczne - wszędzie tam, gdzie fachowy język to codzienność, odwiedzający korzystają ze zrozumiałych definicji. Ubezpieczyciel z terminami takimi jak “suma ubezpieczenia”, “udział własny”, “roszczenie regresowe” może wyświetlać je w tekście płynnym jako tooltip, nie zakłócając czytelności. Jednocześnie istnieje alfabetyczna strona słownika jako leksykon.

Dokumentacja techniczna i bazy wiedzy. Firmy programistyczne prowadzące swoją dokumentację w TYPO3 używają dpn_glossary do konsystentnego wyjaśniania terminów technicznych (API, SDK, Webhook, OAuth). Nowi pracownicy i klienci znajdują definicje bezpośrednio w kontekście, bez konieczności szukania w oddzielnym dokumencie.

Wielojęzyczne strony z terminami specyficznymi dla języka. dpn_glossary wspiera mechanizmy tłumaczeniowe TYPO3. Terminy można definiować per język, włącznie z różnymi definicjami i skrótami. Niemiecki termin “Betriebsrat” jest w angielskiej treści rozpoznawany jako “Works Council” i linkowany.

Architektura techniczna

dpn_glossary przechowuje terminy w własnej tabeli (tx_dpnglossary_domain_model_term). Każdy termin ma nazwę, definicję (RichText), opcjonalnie skrót, synonimy, media (obrazy, pliki) i URL szczegółów. Synonimy są ważne: termin “AI” może być zdefiniowany jako synonim “Sztucznej Inteligencji”, dzięki czemu obie pisownie są automatycznie rozpoznawane w treści.

Automatyczne linkowanie działa jako Content-Post-Processor: po wyrenderowaniu przez TYPO3 treści strony, dpn_glossary przeszukuje output HTML pod kątem znanych terminów i zastępuje je linkami lub znacznikami tooltip. Przy tym pomijane są tagi HTML, atrybuty i istniejące linki, by uniknąć błędnych zagnieżdżeń. Zamiana jest konfigurowalna: tylko pierwsze wystąpienie na stronie, wszystkie wystąpienia lub brak zamiany (tylko tooltip).

Strona słownika jest konfigurowana jako strona pluginu TYPO3. Widok standardowy pokazuje nawigację alfabetyczną (A-Z) ze wszystkimi terminami. Każdy termin ma stronę szczegółową z definicją, powiązanymi terminami i opcjonalnie osadzonymi mediami.

Częste problemy i rozwiązania

Terminy są linkowane w nagłówkach, menu lub formularzach. Automatyczne linkowanie czasem obejmuje obszary HTML, które nie powinny być linkowane. Rozwiązanie: rozszerzenie oferuje konfigurację Excluded Tags (np. h1, h2, h3, nav, form, a). Domyślnie nagłówki i linki są wykluczone, ale lista musi być dostosowana do każdego projektu.

Wyświetlanie tooltipów koliduje z layoutem. Tooltipy (popupy hover z definicją) mogą wychodzić poza krawędź strony lub zasłaniać inne elementy. Rozwiązanie: dostosowanie CSS tooltipa (max-width, z-index, pozycja). dpn_glossary dostarcza standardowy CSS, który można nadpisać przez TypoScript.

Problemy z wydajnością przy wielu terminach. Witryny z ponad 500 terminami odczuwają linkowanie przy niecachowanych stronach. Rozwiązanie: ograniczenie listy terminów do aktywnych (dezaktywacja przestarzałych), ograniczenie linkowania do określonych obszarów strony (tylko treść główna, nie stopka czy sidebar) i konsekwentne korzystanie z cache strony TYPO3.

Migracja i kompatybilność wersji

dpn_glossary wspiera TYPO3 v11 i v12 w aktualnej stabilnej wersji. Kompatybilność z TYPO3 v13 jest w fazie rozwoju (stan kwiecień 2026). Rozszerzenie jest aktywnie utrzymywane, z regularnymi wydaniami i jasną ścieżką aktualizacji.

Dla projektów migrujących z innego rozwiązania słownikowego (np. samodzielnie zbudowanego pluginu lub migracji z WordPress), migracja danych jest prosta: eksport terminów jako CSV i załadowanie do tabeli dpn_glossary przez skrypt importowy. Gosign ma do tego narzędzie CLI obsługujące źródła CSV, JSON i XML.

Długoterminowo Gosign zaleca dodatkowo generowanie danych słownikowych jako Schema.org DefinedTerm Markup. dpn_glossary nie oferuje do tego natywnego wsparcia, ale nadpisanie szablonu Fluid może uzupełnić markup per termin. Poprawia to widoczność w Knowledge Panels i odpowiedziach generowanych przez AI.

Gosign kalkuluje pierwszą konfigurację projektu dpn_glossary (instalacja, konfiguracja, dostosowanie szablonu, import 50 terminów) na 1 do 2 dni deweloperskich. Bieżącą pielęgnację terminów przejmuje redakcja przez backend TYPO3.