Strony Porównań „A vs B” dla PrestaShop 8 i 9: dokumentacja

Wprowadzenie

Moduł tworzy publiczne strony porównujące dwa lub trzy produkty, na przykład „iPhone 15 vs Galaxy S24”, aby pozycjonować się na wyszukiwania porównawcze. Każda strona ma przyjazny URL w każdym języku, znaczniki SEO, dane strukturalne, tabelę porównawczą, Twój werdykt i FAQ. Strona listy zbiera wszystkie opublikowane porównania.

Nie zastępuje porównywarki sesyjnej, takiej jak Porównywarka Produktów, w której odwiedzający porównuje własny wybór: oba moduły można zainstalować razem.

Instalacja

1. W Moduły > Menedżer modułów kliknij Załaduj moduł i wybierz plik ZIP modułu.
2. Instalacja tworzy zakładkę Katalog > Porównania SEO, trzy tabele (porównania, tłumaczenia, przypisanie do sklepów) i domyślny prefiks URL dla każdego zainstalowanego języka.
3. Sprawdź, czy przyjazne adresy URL są włączone w Preferencje sklepu > Ruch i SEO. Bez nich strony działają, ale z adresami w rodzaju index.php?fc=module&module=dfversus&controller=compare&rewrite=....

Ustawienia

Przycisk Konfiguruj modułu otwiera panel informacyjny (link do zarządzania porównaniami, adres strony listy w każdym języku, adres mapy witryny), a pod nim trzy bloki ustawień.

Adresy URL i strona listy

• Prefiks URL, dla każdego języka: porównania używają /prefiks/slug-strony, a strona listy /prefiks. Wartości domyślne: comparatif (fr), compare (en), comparativa (es), vergleich (de), confronto (it), porownanie (pl), vergelijking (nl), comparativo (pt). Prefiksy używane przez PrestaShop (module, content, search, cart, order…) są odrzucane i zastępowane wartością domyślną.
• Tytuł strony listy (H1), meta tytuł, meta opis i wstęp, dla każdego języka.
• Porównań na stronę: domyślnie 24, od 1 do 100.

Wyświetlanie

• Pokaż linki na stronach produktów: wyświetla pod stroną produktu porównania zawierające dany produkt (hook displayFooterProduct). Linki na stronach produktów określa ich liczbę (domyślnie 6).
• Powiązane porównania: liczba porównań ze wspólnym produktem wyświetlanych na dole każdej strony (domyślnie 6, 0 ukrywa blok).
• Porównuj cechy produktów: dodaje do tabeli wszystkie cechy z Katalog > Atrybuty i cechy.
• Pokaż oceny klientów: średnia ocena i liczba opinii z modułu Komentarze produktów (productcomments), jeśli jest zainstalowany.
• Domyślnie pokazuj tylko różnice: odwiedzający nadal może przełączyć opcję na stronie.
• Kolor akcentu: używany dla polecanego produktu, plakietek, linków i najlepszej wartości. Czcionki pochodzą z motywu.

Dane strukturalne

Dodaj znaczniki JSON-LD jest domyślnie włączone. Wyłącz tę opcję tylko wtedy, gdy inny moduł już generuje te znaczniki na tych stronach. Znaczniki Open Graph są dodawane nadal.

Tworzenie porównania

W Katalog > Porównania SEO kliknij Dodaj porównanie.

Produkty i polecany produkt

Wyszukaj każdy produkt po nazwie, indeksie, EAN lub ID i kliknij wynik (albo użyj strzałek i klawisza Enter). Produkty 1 i 2 są wymagane, produkt 3 jest opcjonalny. Nieaktywny produkt jest oznaczony plakietką. Pole Polecany produkt wyróżnia kolumnę plakietką „Nasz wybór” i powtarza ją w werdykcie. Jeśli któreś miejsce zostanie puste, produkty są przestawiane przy zapisie.

Tytuł, slug i znaczniki

• Tytuł (H1): pozostawiony pusty jest generowany w każdym języku z nazw produktów, w postaci „Produkt 1 vs Produkt 2”.
• Slug URL: pozostawiony pusty jest tworzony z tytułu. Musi być unikalny w każdym języku. Wygenerowany slug, który już istnieje, otrzymuje sufiks -2, -3. Wpisany ręcznie slug, który jest już używany, zostaje odrzucony.
• Meta tytuł: pozostawiony pusty zastępowany jest tytułem. Google wyświetla około 60 znaków.
• Meta opis: około 155 znaków. Pozostawiony pusty jest generowany z nazw produktów.

Podgląd w wynikach wyszukiwania pokazuje na bieżąco nazwę sklepu, rzeczywisty URL, tytuł i opis edytowanego języka, z zielonym lub czerwonym licznikiem dla każdej długości.

Wstęp i werdykt

Wstęp wyświetla się nad tabelą, werdykt pod nią. To właśnie te dwa teksty odróżniają Twoją stronę od karty technicznej: wyjaśnij, dla kogo jest każdy produkt i co je naprawdę różni.

Kryteria redakcyjne

Jedno kryterium w wierszu, w formacie Etykieta | wartość produktu 1 | wartość produktu 2 | wartość produktu 3. Dodaj * na końcu wartości, aby oznaczyć ją jako najlepszą. Przykład:

Rzeczywisty czas pracy | 18 h* | 12 h | 15 h
Zdjęcia nocne | Bardzo dobre | Doskonałe* | Doskonałe*
Waga w dłoni | Lekki* | Średni | Ciężki

Te kryteria tworzą grupę „Nasza analiza” w tabeli.

Pytania i odpowiedzi

Jedno pytanie w wierszu, w formacie Pytanie | Odpowiedź. Wyświetlają się jako akordeon na dole strony i są dodawane do JSON-LD jako FAQPage.

Indeksowanie i publikacja

• Zezwól na indeksowanie: po wyłączeniu strona jest nadal dostępna, ale ma znacznik noindex i nie trafia do map witryny.
• Opublikowane: po wyłączeniu strona zwraca odwiedzającym błąd 404. Można ją nadal zobaczyć przez podpisany link podglądu, widoczny w formularzu i w akcji Zobacz na liście.
• Przypisanie do sklepów: w trybie multistore wybierz sklepy, w których istnieje porównanie.

Po zapisaniu formularz pokazuje publiczne adresy URL porównania w każdym języku. Przycisk Zapisz i zostań pozostawia formularz otwarty.

Zduplikowane porównania

Porównanie obejmujące dokładnie te same produkty co inne, w dowolnej kolejności, jest odrzucane przy zapisie z numerem istniejącego porównania. Dwie strony o tych samych produktach konkurowałyby ze sobą w Google: edytuj raczej istniejącą stronę.

Generowanie z kategorii

Przycisk Generuj z kategorii tworzy porównanie dla każdej pary spośród najlepszych produktów kategorii.

1. Wybierz kategorię.
2. Wybierz sposób doboru produktów: najlepiej sprzedające się, pozycja w kategorii, najnowsze najpierw lub najwyższa cena najpierw.
3. Podaj liczbę produktów, od 2 do 12: 6 produktów daje 15 porównań, 12 produktów daje 66.
4. Pozostaw Opublikuj od razu wyłączone, co jest zalecane, i wybierz, czy strony mają być indeksowalne.

Uwzględniane są tylko produkty aktywne i widoczne w katalogu sklepu. Tytuły i slugi są tworzone we wszystkich językach, a pary już porównane są pomijane. Wygenerowane strony zawierają tylko tabelę: przed publikacją dodaj co najmniej wstęp i werdykt, strony bez treści redakcyjnej rzadko zajmują dobre pozycje.

Lista porównań

Lista pokazuje miniatury produktów (wyszarzone dla nieaktywnego produktu), tytuł, nazwy produktów, status indeksowania i publikacji (przełączany jednym kliknięciem), liczbę wyświetleń i datę aktualizacji. Wyświetlenia nie obejmują robotów wyszukiwarek ani podglądów.

• Zobacz otwiera stronę publiczną, z linkiem podglądu, jeśli nie jest opublikowana.
• Duplikuj tworzy nieopublikowaną kopię z nowymi slugami i otwiera jej formularz. Przed zapisaniem kopii zmień co najmniej jeden produkt, w przeciwnym razie zostanie odrzucona jako duplikat.
• Akcje masowe publikują, wycofują z publikacji lub usuwają zaznaczone porównania.

Strona publiczna

Strona korzysta z układu Twojego motywu (ścieżka nawigacji, nagłówek, stopka) i zawiera kolejno: datę aktualizacji, wstęp, przełącznik „Pokaż tylko różnice”, tabelę, werdykt, FAQ, powiązane porównania i link do strony listy.

Tabela

Na górze każdej kolumny: zdjęcie, nazwa, cena z ceną przekreśloną w czasie promocji, przycisk dodania do koszyka (produkty proste, bez personalizacji, dostępne do zamówienia) i link do strony produktu. Dalej tabela jest podzielona na grupy, a wiersze puste we wszystkich kolumnach są ukrywane:

• Najważniejsze: cena (oznaczona najlepsza cena), ocena klientów, dostępność, marka, stan.
• Nasza analiza: Twoje kryteria redakcyjne.
• Specyfikacja techniczna: cechy produktów, jeśli opcja jest włączona.
• Szczegóły: waga, szerokość, wysokość, głębokość, indeks, EAN-13.

Na telefonie

Poniżej 768 px szerokości każdy wiersz pokazuje etykietę nad wartościami: dwa lub trzy produkty mieszczą się w szerokości ekranu, bez przewijania w poziomie.

Przyklejony pasek

Gdy nagłówek tabeli zniknie z ekranu, u góry pojawia się pasek z nazwą i ceną każdego produktu. Automatycznie ustawia się pod stałym nagłówkiem motywu. Jeśli w Twoim motywie jest źle umieszczony, ustaw przesunięcie w CSS motywu:

:root { --dfv-sticky-top: 64px; }

Integracja z motywem

Blok „Porównaj ten produkt” wyświetla się pod stroną produktu przez hook displayFooterProduct. Aby umieścić go gdzie indziej, wyłącz opcję w ustawieniach i dodaj w szablonie motywu:

{hook h='displayDfVersusLinks' product=$product}

Aby dodać stronę listy do menu, użyj jej adresu podanego w panelu informacyjnym modułu.

SEO

Adresy URL, canonical i przekierowania

Znacznik canonical wskazuje URL porównania w wyświetlanym języku. Strona otwarta przez slug innego języka, stary prefiks lub surowy adres modułu jest przekierowywana kodem 301 na adres kanoniczny. Jeśli zmienisz prefiks lub slug, stare adresy przestają być rozpoznawane: zaplanuj przekierowania, jeśli strony były już zaindeksowane.

hreflang

Znaczniki hreflang łączą wersje językowe porównania, z x-default na domyślnym języku sklepu. Wymieniane są tylko języki, w których porównanie ma slug.

Dane strukturalne

Każde porównanie zawiera JSON-LD z WebPage (wraz z datą modyfikacji), BreadcrumbList, ItemList i FAQPage, jeśli wypełniono pytania. ItemList ma format „strony podsumowania”: każdy element wskazuje stronę produktu, która ma już własne znaczniki Product. Strona listy zawiera CollectionPage i ItemList. Od 2023 roku Google pokazuje wyniki rozszerzone FAQ tylko dla niektórych serwisów rządowych i medycznych: znaczniki FAQPage pozostają poprawne, ale nie dają rozszerzonego fragmentu w przypadku sklepu.

Mapa witryny

Dedykowana mapa witryny jest dostępna pod adresem /dfversus-sitemap.xml (dokładny adres w panelu informacyjnym modułu). Zawiera stronę listy oraz każde opublikowane i indeksowalne porównanie z jego alternates hreflang. Zgłoś ją w Google Search Console. Jeśli zainstalowany jest moduł gsitemap PrestaShop, porównania są też dodawane do jego mapy.

Usunięcie produktu

Gdy produkt zostanie usunięty z katalogu, znika z miejsca 3 porównań, które go używają. Porównanie, które traci produkt 1 lub 2, zostaje wycofane z publikacji. Wyłączony produkt nie jest już wyświetlany w porównaniach, a porównanie z mniej niż dwoma widocznymi produktami znika ze strony listy i z map witryny.

Rozwiązywanie problemów

• Strony zwracają błąd 404: sprawdź, czy porównanie jest opublikowane, przypisane do sklepu i zawiera co najmniej dwa aktywne produkty. Jeśli przyjazne adresy URL włączono po instalacji, wygeneruj ponownie plik .htaccess w Ruch i SEO.
• Prefiks koliduje z inną stroną: wybierz w ustawieniach bardziej szczegółowy prefiks, na przykład „porownania-produktow”.
• Oceny klientów się nie wyświetlają: moduł productcomments musi być zainstalowany i aktywny, a opinie zatwierdzone. Sprawdź też opcję „Pokaż oceny klientów”.
• Nie ma przycisku Dodaj do koszyka: jest zarezerwowany dla produktów prostych, bez personalizacji, dostępnych do zamówienia, na stanie lub na zamówienie. Pozostałe produkty pokazują link do strony produktu.
• Przyklejony pasek chowa się pod nagłówkiem motywu: ustaw zmienną --dfv-sticky-top, jak opisano wyżej.