Wszystko, co warto wiedzieć, zanim zainstalujesz.
Szczegółowe spojrzenie na to, jak działa DataFirefly Glosariusz SEO: leksykon terminów branżowych, automatyczne tooltipy w opisach i linkowanie wewnętrzne do produktów dla PrestaShop 8 i 9, dlaczego zbudowaliśmy go w ten sposób i jaka myśl stoi za powyższymi funkcjami.
Dlaczego glosariusz to jeden z najlepszych stosunków nakładu do efektu w SEO e-commerce
Katalog e-commerce przechwytuje zapytania transakcyjne: plecak z tkaniny powlekanej, kurtka ripstop męska. To widoczna i mocno obsadzona część rynku. Ale wcześniej w lejku istnieje ogromny wolumen zapytań informacyjnych, których karty produktów strukturalnie nie mogą przechwycić: co to jest tkanina powlekana, różnica między ripstop a cordurą, co oznacza denier tkaniny. Te zapytania łatwiej wypozycjonować (konkurencja komercyjna jest tam niska), przyprowadzają ruch na etapie odkrywania, a przede wszystkim można je skierować do katalogu przez dobrze umieszczony link kontekstowy. Glosariusz to dokładnie narzędzie, które je przechwytuje. Każdy termin branżowy staje się dedykowaną stroną, szybką w produkcji, spójną tematycznie z katalogiem i naturalnie powiązaną z produktami. W przeciwieństwie do bloga nie ma tu ciągłej pracy redakcyjnej: wpisujesz termin raz i pracuje on dla Ciebie bezterminowo.
Podwójna korzyść: konwersja i pozycjonowanie
Większość sprzedawców instaluje glosariusz dla SEO i odkrywa korzyść konwersyjną, której się nie spodziewali. Odwiedzający, który czyta kartę produktu i potyka się o termin techniczny, ma trzy opcje: zgadywać (źle dla zaufania), otworzyć nową kartę Google (źle dla Ciebie: opuszcza Twój sklep) albo zrezygnować. Tooltip rozwiązuje problem, nie wyprowadzając odwiedzającego z karty: najeżdża, czyta definicję w jednym zdaniu, czyta dalej. Współczynnik odrzuceń spada, czas na stronie rośnie, a oba te sygnały behawioralne z kolei zasilają pozycjonowanie samej karty produktu. Moduł zostawia Ci wybór: w trybie link plus tooltip (domyślnym) masz obie korzyści; w trybie samego tooltipa stawiasz na edukację bez dodawania linków wychodzących z kart; w trybie samego linku stawiasz na czyste linkowanie.
Jak działa silnik wstrzykiwania i dlaczego nigdy nie psuje HTML
To najbardziej wrażliwy technicznie punkt modułu tego typu i miejsce, w którym większość rozwiązań na rynku zawodzi. Naiwny moduł glosariusza robi zwykłą podmianę ciągu w HTML opisu. Efekt: wkleja linki wewnątrz istniejących znaczników, psuje atrybuty, zamienia słowo z adresu URL w zagnieżdżony link albo ponownie linkuje tekst linku, który sam właśnie utworzył. DataFirefly Glosariusz SEO działa inaczej. Treść jest najpierw dzielona na segmenty znaczników i segmenty tekstu. Tylko segmenty tekstu są kandydatami do podmiany, a silnik utrzymuje licznik głębokości dla każdej strefy zakazanej: gdy tylko wchodzimy w znacznik a, script, style, code, pre, svg, textarea, select, option, button, iframe, noscript lub nagłówek h1, h2, h3, wszystkie segmenty tekstu aż do odpowiadającego zamknięcia pozostają nietknięte. Na dozwolonych segmentach wyszukiwanie używa unikodowego wyrażenia regularnego z prawdziwymi granicami słów, które wyklucza litery, cyfry, podkreślenia i łączniki po obu stronach terminu: niemożliwe jest więc zamienienie słowa cordura wewnątrz słowa cordury albo złapanie fragmentu w środku identyfikatora. Wreszcie każdy wstrzyknięty link jest tymczasowo zastępowany unikalnym tokenem na czas przetwarzania, a potem przywracany: to gwarantuje, że termin nigdy nie zostanie ponownie zlinkowany wewnątrz linku, który moduł sam przed chwilą postawił.
Synonimy: detal, który potraja pokrycie
To samo pojęcie rzadko wyraża się jednym sposobem w katalogu pisanym latami przez kilka osób. Tkanina powlekana, tkanina powlekana PVC, materiał powlekany, powłoka PVC oznaczają to samo. Moduł dopasowujący tylko dokładną nazwę terminu pomija większość realnych wystąpień. Każdy termin glosariusza przyjmuje więc listę synonimów rozdzielanych przecinkami, całkowicie dowolną i tłumaczoną per język. Wszystkie warianty (nazwa główna i synonimy) są łączone i sortowane malejąco po długości przed etapem dopasowania: najdłuższe i najbardziej rozróżnialne wyrażenie zawsze wygrywa, co zapobiega przechwyceniu przez krótki wariant fragmentu wariantu dłuższego. Konkretnie: jeśli tkanina powlekana PVC i tkanina powlekana są obie na liście, to ta pierwsza zostanie zlinkowana, gdy pojawi się w całości. Dopasowanie jest niewrażliwe na wielkość liter i toleruje wielokrotne spacje oraz znaki nowej linii: wyrażenia przecięte łamaniem wiersza w HTML są rozpoznawane normalnie.
Zabezpieczenia przed nadoptymalizacją, włączone domyślnie
Nadmierne linkowanie wewnętrzne jest przeciwskuteczne: Google od dawna rozpoznaje wzorce nadoptymalizacji kotwic, a karta produktu naszpikowana dwudziestoma linkami wewnętrznymi do definicji rozprasza wewnętrzny PageRank zamiast go koncentrować. Moduł startuje więc z ustawień celowo konserwatywnych. Limit wystąpień na termin wynosi domyślnie 1: nawet jeśli słowo ripstop pojawia się osiem razy w opisie, tylko pierwsze wystąpienie staje się linkiem, pozostałe siedem to zwykły tekst. Globalny limit na treść wynosi 10: powyżej silnik się zatrzymuje, niezależnie od pozostałych terminów. Obie wartości są konfigurowalne, jeśli Twoja strategia jest inna, ale zalecamy utrzymanie limitu per termin na 1: jeden link na pojęcie w zupełności wystarcza do przekazania sygnału semantycznego, a drugi nie wnosi dla wyszukiwarki nic więcej. Każdy termin ma dodatkowo indywidualny przełącznik autolinkowania: termin może istnieć w glosariuszu, mieć zaindeksowaną stronę definicji i nigdy nie być wstrzykiwany automatycznie w treści.
Dane strukturalne: DefinedTerm i DefinedTermSet
Słownik Schema.org definiuje dwa typy dedykowane glosariuszom, wciąż bardzo mało wykorzystywane w e-commerce. Każda strona terminu emituje JSON-LD typu DefinedTerm z nazwą, opisem, adresem URL i przypisaniem do zbioru. Strona indeksu emituje DefinedTermSet odwołujący się do wszystkich aktywnych terminów. W praktyce daje to Google i silnikom odpowiedzi jawny, jednoznaczny sygnał: ta strona definiuje konkretny termin i należy do ustrukturyzowanego glosariusza w tej dziedzinie. To jedno z niewielu oznakowań, które mówi wyszukiwarce nie tylko o czym jest strona, ale jaką funkcję pełni w architekturze serwisu. W erze odpowiedzi generatywnych (AI Overviews, ChatGPT, Perplexity) poprawnie oznakowane treści definicyjne są nadreprezentowane w cytowaniach: porządny glosariusz to dziś jeden z formatów treści najczęściej podejmowanych przez silniki odpowiedzi.
Wielojęzyczność i multisklep, przemyślane od początku
Wszystkie pola tekstowe glosariusza są wielojęzyczne: nazwa terminu, synonimy, obie definicje, slug, meta title i meta description mogą być różne w każdym języku sklepu. To niezbędne, bo synonimy terminu nie mają powodu być takie same po polsku i po niemiecku, a slug URL musi być w języku odwiedzającego. Dopasowanie odbywa się zawsze w języku bieżącego kontekstu: polski opis nigdy nie zostanie wzbogacony angielskimi terminami i odwrotnie. Po stronie multisklepu terminy są przypisane do sklepów przez standardową tabelę asocjacji PrestaShop: możesz mieć gęsty glosariusz techniczny w sklepie B2B i skrócony, przystępny glosariusz w sklepie B2C, w tej samej instalacji.
Zero AI, zero API, zero kosztów cyklicznych
Ten moduł nie wykonuje żadnych połączeń sieciowych. Nie ma klucza API do podania, dostawcy zewnętrznego do wyboru, zużycia do pilnowania. Całe przetwarzanie odbywa się w PHP, po stronie serwera, na Twoich własnych danych. To świadomy wybór: linkowanie przez glosariusz to problem deterministyczny, nie problem wnioskowania. Znasz swoje terminy branżowe lepiej niż jakikolwiek model, a podmiana ciągu w HTML nie potrzebuje sztucznej inteligencji, by być wykonana poprawnie: potrzebuje być wykonana rygorystycznie. Praktyczna konsekwencja: moduł nie ma żadnych kosztów eksploatacji, żadnych opóźnień, żadnej zależności od usługi zewnętrznej, która mogłaby zmienić cennik lub zniknąć, i żadne dane Twojego katalogu nie opuszczają Twojego serwera.
Typowe zastosowania
Tekstylia i galanteria skórzana: gęste słownictwo materiałowe (gramatura, garbowanie, denier, ripstop, powlekanie), którego klient nie zna, z dużym wolumenem powiązanych zapytań informacyjnych. Kosmetyki i suplementy: składniki aktywne to wyszukiwane terminy (kwas hialuronowy, niacynamid, adaptogen), każdy może odsyłać do produktów, które je zawierają. Sprzęt techniczny, narzędzia, wyposażenie profesjonalne: specyfikacje i normy (IP67, wskaźnik UPF, moment dokręcania, norma EN 388) to dokładnie to, czego szuka kupujący przed wyborem. B2B i sprzedaż przemysłowa: glosariusz to najlepszy sposób budowania autorytetu marki w dziedzinie technicznej i wprowadzania do lejka prospektów będących jeszcze na etapie rozumienia tematu. Sklepy niszowe z mocnym żargonem (wino, kawa, audio, kolarstwo, akwarystyka): glosariusz to dosłownie treść, której szuka społeczność, i pozycjonuje Cię jako punkt odniesienia w branży.
Architektura wewnętrzna
Natywny autoload PSR-4 w przestrzeni nazw DataFirefly/Glossary/ mapowanej na katalog src/, bez Composera i zależności zewnętrznych. Encja GlossaryTerm to standardowy wielojęzyczny ObjectModel PrestaShop z automatycznym generowaniem brakujących slugów. Repozytorium TermRepository centralizuje dostęp do bazy ze statycznym cache słownika, dzięki czemu wstrzykiwanie na stronie kategorii wyświetlającej trzydzieści produktów wykonuje tylko jedno zapytanie. Serwis ContentFilter zawiera cały silnik podmiany, bezstanowy i testowalny niezależnie. Kontrolery admina są w legacy ModuleAdminController, świadomy wybór gwarantujący stabilną kompatybilność między PrestaShop 8.0 a 9.x bez utrzymywania dwóch wariantów kodu. Cztery tabele SQL z prefiksem dfglossary_ w utf8mb4_unicode_ci: term (identyfikator, aktywność, autolinkowanie), term_lang (wszystkie pola tłumaczone), term_shop (asocjacja multisklep) i term_product (powiązane produkty). Deinstalacja usuwa cztery tabele, zakładkę panelu i wszystkie zmienne konfiguracji.
Na razie nie ma opinii o produkcie.