Dane strukturalne w PrestaShop: jak dodać JSON-LD produktu

Karty produktów zawierają cenę, dostępność i opinie, ale strona, którą czyta Google, nie zawsze mówi o tym jasno. Efekt: brak ceny i dostępności w wyszukiwaniu, a czasem dwa bloki znaczników, które się wykluczają, bo motyw i inny moduł opisują ten sam produkt. Schema Pro zapisuje te dane strukturalne w JSON-LD na podstawie rzeczywistych wartości sklepu. Ten przewodnik pokazuje, które typy publikować, jak opisać warianty, jak sprawdzić wynik i co się dzieje, gdy licencja wygaśnie.

Czym są dane strukturalne JSON-LD i do czego służą w PrestaShop?

JSON-LD to blok danych w kodzie strony, który opisuje produkt słownikiem Schema.org: nazwa, cena, waluta, dostępność, referencja i opinie.

Google czyta ten blok, aby zrozumieć stronę, i może pokazać rozszerzony wynik z ceną, dostępnością lub oceną. Może go też zignorować: poprawny markup to warunek, a nie obietnica wyświetlenia.

PrestaShop publikuje już natywny JSON-LD: Organization, WebPage, BreadcrumbList i Product. Ten markup pozostaje ogólny: brak wariantów, brak wysyłki i polityki zwrotów. Schema Pro przejmuje rozpoznane szablony natywne i zostawia nietknięty markup innych dostawców, którego nie zna.

Moduł obejmuje Product, ProductGroup, Organization lub LocalBusiness, WebSite, BreadcrumbList, FAQPage, CollectionPage i ItemList. Każdy typ włącza się osobno na karcie Ogólne, w sekcji Typy schematów.

Dla kogo jest Schema Pro i czego nie robi?

Jest dla sklepów, które sprzedają produkty z wariantami lub opiniami oraz polityką wysyłki i zwrotów, i chcą publikować te informacje bez zmiany motywu.

Dotyczy to sklepów z kartami w kilku językach, z artykułem w kolorach i rozmiarach albo z warunkami zwrotów, które muszą trafić do danych. Moduł bierze wartości ze sklepu: cenę, stan magazynowy, obrazy, referencję, markę i kategorie.

Nie jest potrzebny, jeśli motyw publikuje już kompletny i dokładny JSON-LD, bez wariantów do opisania, bez reguły wysyłki i zwrotów do dodania i bez FAQ do oznaczenia. Nie zastępuje też pracy redakcyjnej: klarowny tytuł i użyteczny opis pozostają podstawą.

Cztery ograniczenia warto znać przed instalacją. Moduł nie tworzy widocznego bloku FAQ: publikuje dane pytań, które już są wyświetlane na stronie. Nie liczy stawek przewoźników: wpisujesz jedną wspólną regułę, a moduł nie zna kosztu konkretnego klienta. Nie ustala Twoich prawnych obowiązków zwrotu. A jego audyt nie potwierdza kwalifikowalności w Google i nie wykrywa wszystkich konfliktów motywu.

Jak dodać dane strukturalne do stron produktów bez zmiany kodu?

Wgraj archiwum na stronie modułów, aktywuj licencję, a następnie wybierz typy i uzupełnij dane firmy na stronie konfiguracji.

W Moduły > Menedżer modułów przycisk Załaduj moduł importuje ZIP. Moduł pojawia się z przyciskiem Konfiguruj. Dopóki licencja nie jest ważna, Menedżer modułów odmawia włączenia i pokazuje: „Schema Pro wymaga ważnej licencji, aby można go było włączyć.”

Strona konfiguracji pokazuje formularz Aktywacja licencji. Wpisz Klucz licencji i Sekret licencji z konta klienta, a następnie kliknij Aktywuj licencję. Gdy licencja jest ważna, przycisk „Otwórz ustawienia Schema Pro” otwiera stronę ustawień.

Ustawienia są podzielone na pięć kart: Ogólne, Organizacja, Ustawienia produktów, FAQ i Audyt. Na karcie Ogólne zaznacz Typy schematów, pozostaw zaznaczoną opcję „Wyłącz natywny markup”, aby moduł zastąpił JSON-LD PrestaShopu własnym, i nie wyłączaj opcji „Włącz buforowanie”. Każda sekcja zapisuje się osobno.

W sekcji Organizacja podaj prawdziwe dane: Typ organizacji, nazwę, URL logo, adres, telefon, e-mail i numer VAT. Te pola opisują firmę; nie gwarantują panelu wiedzy Google.

Po zmianie kliknij Wyczyść pamięć podręczną, otwórz kartę produktu i poszukaj bloku JSON-LD w kodzie źródłowym.

Jak opisać warianty produktu: Product czy ProductGroup?

Produkt z kombinacjami opisuje ProductGroup, który zbiera każdy wariant w hasVariant i wskazuje oś zmienności w variesBy.

Weź koszulkę w trzech kolorach i czterech rozmiarach. Każda kombinacja ma własną referencję, cenę, stan i czasem obraz. Moduł przenosi te wartości do wariantów i stawia na początku wariant wybrany oraz domyślny, gdy zostanie osiągnięty limit rozmiaru wyniku.

Na karcie Ustawienia produktów przypisz grupy atrybutów do rozpoznawanych osi: kolor, rozmiar, materiał, wzór lub płeć. Bez tego przypisania silnik nie wie, co odróżnia dwa warianty.

Dla prostego produktu wystarczy Product: nazwa, opis, obrazy, referencja, marka, dostępne identyfikatory, stan, cena, waluta i dostępność. Cena idzie za kontekstem odwiedzającego, a ukryta cena nie tworzy oferty. Podawaj GTIN tylko wtedy, gdy nadał go producent: nie wymyślaj identyfikatora, aby uciszyć komunikat audytu.

Dlaczego moje rozszerzone fragmenty się nie pojawiają, choć schemat jest poprawny?

Ponieważ Google sam decyduje, co pokazać: poprawny markup nie uruchamia rozszerzonego fragmentu, a kilka typowych przyczyn wyjaśnia brak.

Pierwsza to brak opinii. Gwiazdki opierają się na zagregowanej ocenie z zatwierdzonych i kwalifikujących się opinii z wybranego źródła. Bez opinii moduł pomija ocenę i Google nie ma czego pokazać.

Druga to zduplikowany markup. Jeśli motyw lub inny moduł publikuje drugi Product na tej samej stronie, oba bloki się wykluczają. Otwórz kod źródłowy i sprawdź, czy został jeden spójny blok.

Trzecia to dana, która nie zgadza się z widoczną stroną: inna cena, waluta lub dostępność niż widzi klient. Wartości muszą iść za kartą produktu.

Czwarta dotyczy typów, które Google przestał pokazywać: nie ma już rozszerzonych fragmentów FAQ ani pola wyszukiwania w linkach witryny. Moduł nadal publikuje FAQPage i WebSite, ale dla tych typów nie pojawia się żaden fragment.

Na koniec czas wdrożenia nie jest regulowany. Google ponownie skanuje stronę we własnym tempie. Test wyników rozszerzonych i inspekcja adresu URL w Search Console sprawdzają konkretny adres; nie podają daty pojawienia się.

Jak sprawdzić dane strukturalne sklepu przed publikacją?

Karta Audyt pokazuje JSON-LD produktu wyszukanego po nazwie, w wybranym języku i walucie, a następnie analizuje aktywny katalog.

W Podglądzie produktu wpisz nazwę, wybierz język i walutę, i porównaj cenę, stan oraz dostępność z publiczną kartą. Powtórz próbę na prostym produkcie, a potem na produkcie z wariantami.

Audyt przechodzi aktywne produkty małymi partiami i porządkuje uwagi w Błędy, Zalecenia i informacje opcjonalne. Przycisk Eksportuj CSV daje listę do poprawy. Brak GTIN nadanego przez producenta nie jest automatycznie błędem.

Ten audyt obejmuje tylko sklep: do kontroli zewnętrznej przepuść publiczny adres przez test wyników rozszerzonych Google i zachowaj wynik. Dokumentacja modułu opisuje każdą kartę.

Co się stanie, gdy licencja wygaśnie lub serwer licencji nie odpowiada?

Bez ważnej licencji Schema Pro wyłącza się i nie publikuje żadnych danych strukturalnych; chwilowa awaria serwera licencji nie unieważnia ważnej licencji. Pozycja w menu jest ukryta, ale ustawienia i FAQ zostają zachowane.

Tak działa wersja 2.0.2. Wystarczy licencja wygasła, zawieszona, cofnięta, brakująca lub nieuznana dla tej domeny. Moduł pozostaje zainstalowany, ale nieaktywny: jego strona konfiguracji pozwala wpisać nową licencję.

Odnowiona subskrypcja pozostaje aktywna przez siedem dni po zapisanej dacie wygaśnięcia. Potem moduł pyta serwer najwyżej raz na godzinę. Błąd wewnętrzny, limit zapytań lub przesunięty zegar nie unieważniają ważnej licencji: siedem dni liczy się od pierwszego niepowodzenia.

Aby przywrócić działanie modułu, otwórz stronę konfiguracji, wpisz Klucz licencji i Sekret licencji, a następnie kliknij Aktywuj licencję. Strona potwierdza aktywację i proponuje przycisk „Otwórz ustawienia Schema Pro”. Przycisk Dezaktywuj usuwa licencję z tego sklepu i zostawia ustawienia.

Markup nie zastępuje ani karty produktu, ani polityki zwrotów: opisuje je dla wyszukiwarek. Aby uzupełnić całość, Advanced Custom Field dodaje pola i redakcyjne FAQ, paszport cyfrowy produktu publikuje publiczną stronę dla każdego produktu, a Google Analytics 4 i Search Console pokazują, co robią potem odwiedzający.