DF Glossary: glosariusz SEO dla PrestaShop 8 i 9

Wprowadzenie

DF Glossary zamienia Twoje słownictwo branżowe w aktywo SEO. Wpisujesz terminy tylko raz, wraz z definicją krótką i długą, a moduł automatycznie robi trzy rzeczy: wstrzykuje link z dymkiem przy każdym wystąpieniu terminu w opisach produktów, kategorii i stronach CMS; publikuje indeksowalną stronę definicji dla każdego terminu; oraz łączy każdą definicję z produktami, które do niej przypiszesz.

Efektem jest dwukierunkowe linkowanie wewnętrzne budujące się bez wysiłku redakcyjnego: karty produktów wzmacniają definicje, definicje wzmacniają produkty, a definicje wzmacniają się nawzajem.

Instalacja

Wymagania

• PrestaShop 8.0, 8.1, 8.2 lub 9.x
• PHP 7.4 do 8.3
• MySQL 5.7 lub MariaDB 10.3 albo nowsze
• Włączone przyjazne adresy URL (Ustawienia sklepu, Ruch i SEO), niezbędne dla stron glosariusza

Procedura

1. W panelu administracyjnym przejdź do Moduły → Menedżer modułów → Wgraj moduł.
2. Prześlij plik dfglossary-1.0.0.zip.
3. Instalacja tworzy cztery tabele SQL, zakładkę w panelu oraz domyślne klucze konfiguracji.
4. W menu pojawia się nowa zakładka Katalog → Glosariusz SEO. Tam zarządzasz terminami.
5. Kliknij Konfiguruj w menedżerze modułów, aby przejść do ustawień globalnych.

Konfiguracja modułu

Panel konfiguracji dzieli się na trzy sekcje.

Aktywacja i tryb wstrzykiwania

• Włącz wstrzykiwanie: przełącznik główny. Po wyłączeniu moduł przestaje wzbogacać treści, ale strony glosariusza pozostają online i zaindeksowane.
• Tryb: trzy możliwe wartości:
  • Link i dymek (domyślnie): termin staje się linkiem do swojej strony definicji i pokazuje dymek po najechaniu kursorem. To tryb łączący korzyść SEO z korzyścią konwersyjną.
  • Sam link: termin staje się linkiem, bez dymka. Wybieraj go, jeśli zależy Ci wyłącznie na linkowaniu wewnętrznym.
  • Sam dymek: termin pokazuje definicję po najechaniu, nie stając się linkiem. Wybieraj go, jeśli chcesz efektu edukacyjnego bez dodawania linków wychodzących na kartach produktów.

Limity (zabezpieczenia przed nadoptymalizacją)

• Maksymalna liczba wystąpień na termin: domyślnie 1. Nawet jeśli słowo pojawia się osiem razy w opisie, linkiem staje się tylko pierwsze wystąpienie. Zdecydowanie zalecamy zachowanie tej wartości: jeden link na pojęcie wystarcza, aby przekazać sygnał semantyczny, a kolejne rozwadniają wewnętrzny PageRank, nic nie wnosząc.
• Maksymalna liczba linków na treść: domyślnie 10, łącznie dla wszystkich terminów. Po przekroczeniu silnik się zatrzymuje, niezależnie od pozostałych terminów.

Objęte treści

Cztery niezależne przełączniki określają, gdzie stosowane jest wstrzykiwanie:

• Opisy produktów: opis długi.
• Uwzględnij opis krótki: osobna opcja. Uwaga: opis krótki często wyświetla się u góry karty i na listingach, więc umieszczanie w nim linków może być przesadą.
• Opisy kategorii: opis i opis dodatkowy.
• Strony CMS i kategorie CMS: treść stron CMS.

Baza adresu URL

Pole Baza adresu URL określa segment, pod którym publikowane są strony glosariusza. Wartość domyślna to glossaire, co daje /glossaire dla indeksu i /glossaire/tkanina-powlekana dla karty terminu. Możesz wpisać własny segment, na przykład slownik. Pole jest walidowane jak przepisanie adresu: dozwolone są wyłącznie litery, cyfry i myślniki.

Zarządzanie terminami

Przejdź do Katalog → Glosariusz SEO. Lista pokazuje wszystkie terminy z ich slugiem, stanem automatycznego linkowania i statusem. Możesz wyszukiwać, sortować, filtrować, włączać i wyłączać jednym kliknięciem oraz usuwać zbiorczo.

Tworzenie terminu

Kliknij Dodaj termin. Formularz jest w pełni wielojęzyczny: każde pole tekstowe wpisuje się osobno dla każdego języka.

• Termin: dokładne brzmienie wyszukiwane w Twoich treściach. Dopasowanie nie rozróżnia wielkości liter i respektuje granice wyrazów.
• Slug: identyfikator w adresie URL. Zostaw puste, aby wygenerował się automatycznie z nazwy.
• Synonimy: lista rozdzielona przecinkami. Liczby mnogie, skróty, warianty pisowni: wszystkie te formy wyzwalają ten sam link i ten sam dymek.
• Definicja krótka: to tekst dymka. Zalecany czysty tekst. W dymku jest ucinana do 180 znaków, ale w całości wyświetla się na górze strony definicji.
• Definicja długa: edytor formatowany. To treść strony definicji i zawartość, która ma się pozycjonować w Google.
• Meta title i meta description: opcjonalne. W razie ich braku moduł automatycznie sięga po nazwę terminu i definicję krótką.
• Powiązane produkty: lista identyfikatorów produktów rozdzielona przecinkami. Ich miniatury pojawią się na stronie terminu.
• Automatyczne linkowanie: przełącznik indywidualny. Po wyłączeniu termin zachowuje zaindeksowaną stronę definicji, ale nigdy nie jest wstrzykiwany w treści.
• Aktywny: po wyłączeniu termin znika z glosariusza, a jego strona zwraca poprawny błąd 404.

Dobre praktyki redakcyjne

• Celuj w 20 do 50 terminów. Liczba nie jest tu istotną zmienną: termin zasługuje na miejsce, jeśli faktycznie występuje w Twoich opisach i odpowiada na pytanie zadawane przez klientów.
• Pisz definicje długie na 150 do 400 słów. Wystarczająco, aby w oczach Google stanowiły samodzielną treść, i wystarczająco krótko, aby dało się je szybko przygotować.
• Przypisuj 2 do 6 produktów na termin, nie więcej. Strona definicji wskazująca dwadzieścia produktów rozwadnia swój autorytet.
• Zadbaj o synonimy. To dźwignia zwielokrotniająca pokrycie: katalog pisany przez lata przez różne osoby rzadko wyraża to samo pojęcie w jeden sposób.
• Nie tłumacz synonimów słowo w słowo. Każdy język ma własne warianty, wpisuj je niezależnie.

Jak działa wstrzykiwanie

Wzbogacanie odbywa się po stronie serwera, w momencie renderowania strony, przez hooki filtrowania treści PrestaShop. Twoje opisy nigdy nie są modyfikowane w bazie danych: po wyłączeniu modułu treści natychmiast wracają do stanu pierwotnego.

Silnik zamiany

Treść jest dzielona na segmenty znaczników i segmenty tekstu. Kandydatami do zamiany są wyłącznie segmenty tekstu. Następujące obszary są zawsze pomijane:

• istniejące linki (brak ryzyka utworzenia linku zagnieżdżonego),
• nagłówki h1, h2 i h3,
• bloki script, style, code, pre, svg, noscript,
• pola formularzy: textarea, select, option, button,
• ramki iframe.

W dozwolonych segmentach wyszukiwanie korzysta z granic wyrazów w standardzie Unicode: nie da się zamienić fragmentu znajdującego się wewnątrz słowa lub identyfikatora. Dopasowanie pomija wielkość liter i toleruje wielokrotne spacje oraz znaki nowej linii. Dodatkowo każdy wstrzyknięty link jest na czas przetwarzania tymczasowo zastępowany unikalnym tokenem, więc termin nigdy nie może zostać ponownie zlinkowany wewnątrz linku, który moduł sam właśnie utworzył.

Kolejność priorytetów wariantów

Wszystkie warianty terminu (nazwa główna i synonimy) są scalane, a następnie sortowane malejąco według długości. Zawsze wygrywa najdłuższe wyrażenie. W praktyce, jeśli wśród synonimów znajdują się zarówno tkanina powlekana PVC, jak i tkanina powlekana, zlinkowany zostanie ten pierwszy, gdy wystąpi w całości.

Strony glosariusza

Strona indeksu

Dostępna pod /glossaire, wymienia wszystkie aktywne terminy pogrupowane literami, z nawigacją alfabetyczną i zajawką przy każdym terminie. Emituje JSON-LD typu DefinedTermSet.

Strona definicji

Dostępna pod /glossaire/{slug}, każda karta zawiera:

• nagłówek H1 i wyeksponowaną definicję krótką,
• definicję długą w formacie sformatowanym, w której pozostałe terminy glosariusza są z kolei automatycznie linkowane (bieżący termin jest wykluczony, bez linkowania do samego siebie),
• miniatury powiązanych produktów,
• chmurę terminów pokrewnych,
• dedykowane meta title i meta description, adres kanoniczny, okruszki nawigacyjne,
• JSON-LD typu DefinedTerm.

Jeśli slug nie istnieje lub termin jest wyłączony, strona zwraca poprawny błąd 404.

Wielojęzyczność i multistore

Wszystkie pola tekstowe glosariusza są wielojęzyczne: nazwa, synonimy, definicje, slug, meta title i meta description mogą różnić się w każdym języku. Dopasowanie zawsze odbywa się w języku bieżącego kontekstu: polski opis nigdy nie zostanie wzbogacony angielskimi terminami.

W trybie multistore terminy są przypisywane do sklepów przez standardową tabelę powiązań PrestaShop. Możesz więc mieć gęsty glosariusz techniczny w sklepie B2B i uproszczony glosariusz w sklepie B2C, w ramach jednej instalacji.

Zachowanie na urządzeniach mobilnych

Na ekranie dotykowym nie ma najechania kursorem. Moduł ładuje mały skrypt obsługujący dotknięcie: pierwsze dotknięcie terminu pokazuje dymek i blokuje przejście, drugie otwiera stronę definicji. Pozostałe otwarte dymki zamykają się automatycznie, a dotknięcie poza terminem zamyka dymek.

Wydajność

Słownik terminów jest wczytywany raz na żądanie i trzymany w statycznej pamięci podręcznej: nawet strona kategorii z trzydziestoma produktami generuje tylko jedno zapytanie SQL na potrzeby glosariusza. Sama zamiana to operacja na łańcuchach znaków w PHP, rzędu milisekundy. Nie jest ładowany żaden blokujący JavaScript, nie są wykonywane żadne wywołania sieciowe, a wynik jest w pełni zgodny z pamięcią podręczną full-page.

Rozwiązywanie problemów

W kartach produktów nie pojawia się żaden link

• Sprawdź, czy główny przełącznik Włącz wstrzykiwanie jest ustawiony na Tak.
• Sprawdź, czy w objętych treściach włączone są Opisy produktów.
• Sprawdź, czy termin jest aktywny i czy ma włączone automatyczne linkowanie.
• Sprawdź, czy termin jest uzupełniony w języku oglądanej karty: termin wpisany wyłącznie po polsku nigdy nie zostanie wstrzyknięty w angielski opis.
• Wyczyść pamięć podręczną PrestaShop (Parametry zaawansowane → Wydajność).

Termin pojawia się w tekście, ale nie jest zlinkowany

Trzy możliwe przyczyny. Albo termin znajduje się już wewnątrz linku, nagłówka h1 do h3 lub obszaru chronionego, co jest zachowaniem zamierzonym. Albo limit wystąpień na termin (domyślnie 1) jest już osiągnięty dla tej treści, więc kolejne wystąpienia pozostają zwykłym tekstem, i to jest normalne. Albo osiągnięty został globalny limit 10 linków na treść.

Strony glosariusza zwracają błąd 404

• Sprawdź, czy przyjazne adresy URL są włączone.
• Wygeneruj ponownie plik .htaccess (Ustawienia sklepu → Ruch i SEO → Generuj plik .htaccess).
• Sprawdź, czy termin jest aktywny i czy jego slug jest uzupełniony w oglądanym języku.

Dymki się nie wyświetlają

Sprawdź, czy tryb nie jest ustawiony na Sam link. Jeśli tryb jest poprawny, wyczyść pamięć podręczną i sprawdź, czy arkusz stylów modułu jest wczytywany (jest dodawany automatycznie na wszystkich stronach sklepu).

Odinstalowanie

Odinstalowanie usuwa cztery tabele SQL modułu, zakładkę w panelu oraz wszystkie klucze konfiguracji. Twoje terminy są więc bezpowrotnie tracone, wyeksportuj je, jeśli planujesz późniejszą ponowną instalację. Żaden opis produktu, kategorii ani strony CMS nigdy nie był natomiast modyfikowany w bazie: treści po prostu wracają do stanu pierwotnego, bez żadnego sprzątania.

Znane ograniczenia

• Unikalność slugów nie jest wymuszana per język. Jeśli dwa terminy mają ten sam slug w tym samym języku, wygrywa znaleziony jako pierwszy. Sprawdzaj slugi przy wprowadzaniu.
• Obszary chronione (linki, nagłówki h1 do h3, kod, formularze) nigdy nie są wzbogacane. To decyzja projektowa, a nie ograniczenie do obejścia.