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. Termin taki jak “rada pracowników” jest rozpoznawany i linkowany prawidłowo we wszystkich wersjach językowych treści.

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 dla wybranych terminów lub stron.

Strona słownika jest konfigurowana jako strona pluginu TYPO3. Widok listy pokazuje wszystkie terminy alfabetycznie, opcjonalnie pogrupowane według pierwszej litery lub z nawigacją od A do Z. Każdy termin ma stronę szczegółową z definicją, synonimami 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 v13 i v14 w aktualnej serii 7.x; dla v12 jest seria 6.x, a dla v11 seria 5.x. 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.