Schema Pro

Przegląd

Schema Pro to moduł dla PrestaShop, który automatycznie generuje czyste, kompletne i zgodne z Google dane strukturalne Schema.org w formacie JSON-LD. Wbudowany markup PrestaShop bywa ograniczony (a czasem generuje „kruche” JSON-y), dlatego Schema Pro tworzy JSON-LD po stronie PHP za pomocą json_encode(), aby uniknąć błędów formatowania i zapewnić spójność na wszystkich stronach. Cel jest prosty: pomóc wyszukiwarkom lepiej zrozumieć treści i zwiększyć szanse na wyświetlanie wyników rozszerzonych (cena, dostępność, oceny, okruszki nawigacyjne, FAQ itd.), co poprawia widoczność i CTR.

Najważniejsze korzyści:

• Pełny, zgodny JSON-LD (e-commerce + strony treści)
• Obsługa ProductGroup + wariantów (specyfikacja Google 2024)
• Polityki wysyłki i zwrotów (OfferShippingDetails, MerchantReturnPolicy)
• Wbudowany audyt (wynik, błędy, ostrzeżenia, eksport)
• Inteligentny cache z automatyczną invalidacją

Dlaczego ten moduł

Dane strukturalne to realna dźwignia SEO dla sklepów PrestaShop: pomagają Google interpretować strony produktów, listy kategorii, tożsamość marki (Organization/LocalBusiness) oraz elementy nawigacji (BreadcrumbList). W praktyce wiele sklepów ma niepełny lub zduplikowany markup (kilka modułów), albo niespójne dane produktowe (warianty źle zadeklarowane, brak identyfikatorów, brak informacji o wysyłce/zwrotach). Schema Pro centralizuje wszystko w jednym, konfigurowalnym i czytelnym dla Google markupu, poprawiając jego jakość i redukując błędy walidacji.

Funkcje

Dane strukturalne produktu (Product)

Schema Pro generuje wzbogacony schema Product na stronach produktów: nazwa, opis, obrazy (wszystkie obrazy, nie tylko okładka), SKU/referencja, marka (producent), identyfikatory (EAN/GTIN, MPN, ISBN/UPC jeśli dostępne), kategoria, URL, stan produktu oraz Offers (cena, waluta, dostępność, sprzedawca, ważność ceny). Celem jest przekazanie Google jasnego i kompletnego sygnału o ofercie. Moduł może również dołączać oceny i opinie (AggregateRating i Reviews) z kompatybilnego źródła, wzmacniając wiarygodność, gdy danych jest wystarczająco dużo.

Produkty z wariantami (ProductGroup + warianty)

Dla produktów z rozmiarami, kolorami lub innymi atrybutami Schema Pro może wygenerować ProductGroup zgodny z zaleceniami Google (2024). Warianty są deklarowane przez hasVariant, a każdy wariant ma własne dane (SKU, EAN, cena, stan magazynowy, obraz, URL wariantu). Moduł automatycznie wykrywa osie wariantowania przez variesBy (np. kolor, rozmiar) i pozwala ograniczyć liczbę wariantów w JSON-LD, aby zachować wydajność i rozsądny rozmiar markupu. To szczególnie przydatne w modzie, akcesoriach, meblach i katalogach z wieloma kombinacjami.

Marka i sklep (Organization / LocalBusiness)

Schema Pro generuje schema Organization (lub LocalBusiness, Store, OnlineStore itd.) w całym serwisie: nazwa handlowa, nazwa prawna, opis, e-mail, telefon, VAT, logo, adres i profile społecznościowe (sameAs). Dla firm z lokalizacją stacjonarną pola LocalBusiness (godziny otwarcia, współrzędne geo, przedział cen) wzmacniają spójność między sklepem, lokalną obecnością i wynikami Google. Poprawna konfiguracja wspiera też rozumienie encji (Knowledge Graph) oraz zaufanie użytkowników.

WebSite + SearchAction, BreadcrumbList, FAQPage, CollectionPage

Moduł może dodać:

• WebSite + SearchAction (sitelinks search box) dla lepszej integracji z Google.
• Dynamiczny BreadcrumbList (produkt, kategoria, CMS, producent) dla spójnych okruszków w SERP.
• FAQPage przez menedżer FAQ w panelu, przypisywany do produktów, kategorii, stron CMS lub własnych URL-i.
• CollectionPage + ItemList na stronach kategorii, z listą produktów z aktualnej strony (z uwzględnieniem paginacji), aby wspierać indeksację listingów bez nadmiaru markupu.

Wysyłka i zwroty (OfferShippingDetails, MerchantReturnPolicy)

Schema Pro pozwala zdefiniować politykę wysyłki i politykę zwrotów, a następnie referencjonować je w każdej Offer przez @id (co ogranicza powielanie danych w JSON-LD). Możesz ustawić kraje dostawy, koszty, czas przygotowania i tranzytu, a także okno zwrotu, opłaty, metodę i URL polityki. Informacje te zwiększają transparentność i mogą poprawić kwalifikowalność do wyników rozszerzonych oraz powierzchni Shopping, zależnie od kryteriów Google.

Wbudowany audyt i wydajność (cache)

Zakładka Audyt skanuje katalog (produkty, kategorie, organizację) i wskazuje braki (obrazy, cena, EAN/GTIN, marka, SKU, opisy itd.) z wynikiem oraz klasyfikacją (błąd, ostrzeżenie, informacja). Dla wydajności Schema Pro oferuje cache JSON-LD z automatyczną invalidacją, gdy zmieniają się dane istotne (produkt, kategoria, CMS, opinie, konfiguracja), dzięki czemu sklep pozostaje szybki nawet przy dużych katalogach.

Wymagania

Schema Pro jest tworzony z myślą o nowoczesnych wersjach PrestaShop i aktualnym środowisku serwerowym.

• PrestaShop: minimum 8.0.0 (zgodny z 8.x i 9.x)
• PHP: minimum 8.1 (zgodny z 8.1–8.4 w zależności od konfiguracji)
• MySQL 5.7+ lub MariaDB 10.3+
• HTTPS zalecany (best practice SEO i bezpieczeństwo)

Nie jest wymagany CRON: JSON-LD generuje się „w locie”, a cache (jeśli włączony) poprawia czasy odpowiedzi w produkcji.

Instalacja

Instalacja z panelu (zalecana)

1. Przejdź do Moduły > Menedżer modułów
2. Kliknij Prześlij moduł
3. Wybierz archiwum ZIP modułu (np. wepresta_schema_pro.zip)
4. Poczekaj na zakończenie instalacji
5. Kliknij Konfiguruj

Instalacja przez FTP

1. Rozpakuj archiwum
2. Wgraj folder modułu do /modules/
3. W panelu wyszukaj moduł
4. Kliknij Zainstaluj, a potem Konfiguruj

Co robi instalacja

Moduł tworzy swoje tabele (FAQ, mapowanie atrybutów, cache), rejestruje hooki (wstrzyknięcie na froncie, invalidacja cache), dodaje pozycję menu w back-office i może wyłączyć natywny markup PrestaShop, aby uniknąć duplikatów. Po instalacji zaleca się skonfigurować Organizację i włączyć potrzebne typy schema przed uruchomieniem audytu.

Szybki start

Aby uzyskać czysty markup w mniej niż 10 minut:

1. Zainstaluj moduł i otwórz Konfiguruj
2. W General włącz przynajmniej: Product, Organization, WebSite, BreadcrumbList
3. Włącz wyłączenie natywnego markupu, jeśli nie używasz innego generatora JSON-LD
4. W Organization uzupełnij: nazwa, logo, e-mail, telefon, adres, profile social
5. W Products włącz ProductGroup, jeśli masz warianty, i sprawdź mapowanie (Kolor → color, Rozmiar → size)
6. (Opcjonalnie) Dodaj polityki wysyłki i zwrotów, aby wzbogacić Offers
7. Uruchom Audyt i popraw braki (obrazy, EAN, marka, opisy)
8. Przetestuj stronę produktu w Google Rich Results Test i upewnij się, że nie ma duplikatów

Konfiguracja

Zakładka General

Zawiera ustawienia globalne: aktywacja typów schema, wyłączenie natywnego markupu PrestaShop (aby uniknąć duplikacji) oraz cache. Na etapie wdrożenia często lepiej zostawić cache wyłączony, aby od razu widzieć zmiany. Gdy konfiguracja jest stabilna, włącz cache w produkcji, aby ograniczyć koszt generowania.

Zakładka Organization

Wybierz typ encji (Organization, OnlineStore, LocalBusiness, Store itd.) i uzupełnij kluczowe dane: nazwa, nazwa prawna, opis, logo, VAT, pełny adres oraz URL-e profili społecznościowych. Dla LocalBusiness dodaj, jeśli to możliwe, godziny otwarcia, współrzędne geo i przedział cen. Puste pola nie są emitowane w JSON-LD (lepiej pominąć niż wysyłać puste wartości).

Zakładka Products

Włącz ProductGroup, jeśli katalog zawiera warianty, ustaw limit wariantów, jeśli trzeba, oraz skonfiguruj domyślny stan produktu. Sprawdź źródło opinii i ustaw minimalny próg, aby uniknąć słabego AggregateRating (częsta dobra praktyka). Następnie skonfiguruj mapowanie atrybutów PrestaShop na właściwości Schema.org (kolor, rozmiar, materiał, wzór, płeć), aby zasilać variesBy i wzbogacić warianty.

Zakładka FAQ

Twórz pary Pytanie/Odpowiedź w panelu i przypisuj je do produktów, kategorii, stron CMS lub własnych URL-i. FAQ są wielojęzyczne i sortowalne. Schema FAQPage generuje się tylko wtedy, gdy na bieżącej stronie istnieją aktywne FAQ, co ogranicza zbędny markup. Pytania powinny być naturalne i realnie pomocne; Google często ignoruje sztuczne FAQ.

Zakładka Audyt

Audyt wykrywa błędy blokujące (np. produkt bez obrazu, cena 0), ostrzeżenia (brak EAN/GTIN, brak marki, zbyt krótkie opisy) oraz informacje (brak opinii, wyłączony ProductGroup itd.). Używaj go do priorytetyzacji poprawek, eksportuj raport, jeśli potrzeba, i uruchamiaj skan ponownie, aby mierzyć poprawę wyniku.

Multistore i wielojęzyczność

Schema Pro wspiera multistore: każdy sklep może mieć własną konfigurację (aktywne typy, organizacja, polityki wysyłki/zwrotów, FAQ, cache). W trybie multistore najpierw wybierz sklep w selektorze kontekstu PrestaShop, a dopiero potem edytuj ustawienia. Wielojęzyczność jest natywna: JSON-LD generuje się w języku odwiedzającego (produkty, kategorie, FAQ, organizacja), co zapobiega niespójnym sygnałom (np. FAQ po francusku na stronie angielskiej).

Zgodność

Wersje PrestaShop

• PrestaShop 8.0.x: zgodny
• PrestaShop 8.1.x: zgodny
• PrestaShop 8.2.x: zgodny
• PrestaShop 9.0.x: zgodny

Wersje PHP

• PHP 8.1: zgodny
• PHP 8.2: zgodny
• PHP 8.3: zgodny
• PHP 8.4: zgodny

Bazy danych

• MySQL 5.7+
• MySQL 8.0
• MariaDB 10.3+

FAQ

Czy moduł spowalnia sklep?

Nie. JSON-LD jest wstrzykiwany do <head> i pozostaje lekki. Z włączonym cache typowy wpływ to ok. 1–2 ms na stronę. Bez cache wpływ zależy od złożoności produktu (warianty, opinie), ale zwykle jest pomijalny. Automatyczna invalidacja cache zapobiega podawaniu nieaktualnych danych, a front pozostaje szybki.

Czy można używać z innym modułem SEO?

Tak, ale trzeba unikać duplikatów. Jeśli inny moduł generuje również JSON-LD Product/Organization/Breadcrumb/FAQ, Google może to zignorować lub pogorszyć interpretację. Dobra praktyka: wyłącz część „dane strukturalne” w innym module albo włącz wyłączenie natywnego markupu i upewnij się, że aktywny jest tylko jeden generator JSON-LD.

Czy dane strukturalne gwarantują rich snippets?

Nie. Zdecydowanie zwiększają szanse, ale Google decyduje. Sklep z poprawnym, kompletnym, niezdublowanym markupiem i solidnymi danymi produktu (obrazy, cena, stock, identyfikatory, prawdziwe opinie) maksymalizuje kwalifikowalność i często poprawia CTR nawet bez gwarancji wyników rozszerzonych.

Rozwiązywanie problemów

Brak widocznego JSON-LD

• Sprawdź, czy moduł jest zainstalowany i włączony
• Włącz co najmniej jeden typ schema w General
• Upewnij się, że działa hook wstrzyknięcia na froncie (np. displayHeader)
• Wyczyść cache PrestaShop (Smarty) i w razie potrzeby cache modułu

Duplikaty schema

• Włącz wyłączenie natywnego markupu, jeśli to konieczne
• Wyłącz konkurencyjne generatory JSON-LD
• Sprawdź źródło strony i ponownie przetestuj w Google Rich Results Test

Błędy w walidatorach Google

• Dodaj co najmniej jeden obraz do produktu
• Zweryfikuj cenę/walutę/dostępność
• Użyj audytu do poprawy EAN/GTIN, marki, SKU, opisów
• Sprawdź konfigurację wysyłki/zwrotów, jeśli jest włączona

Changelog

Wersja 1.0.0

• Pełne generowanie JSON-LD: Product, ProductGroup, Organization/LocalBusiness, WebSite, BreadcrumbList, FAQPage, CollectionPage
• Obsługa ProductGroup + wariantów (hasVariant, variesBy, productGroupID)
• Polityki wysyłki (OfferShippingDetails) i zwrotów (MerchantReturnPolicy) referencjonowane przez @id
• Mapowanie atrybutów PrestaShop do właściwości Schema.org
• Wbudowany audyt z punktacją i eksportem CSV
• Inteligentny cache z automatyczną invalidacją
• Nowoczesny back-office (kontrolery Symfony), wsparcie multistore i wielojęzyczności

Wsparcie

Wsparcie jest dostępne przez Twoją strefę klienta / kanał wsparcia WePresta. Aby przyspieszyć diagnozę, podaj:

• Wersję PrestaShop i PHP
• Problemowy URL + wynik Rich Results Test
• Kod źródłowy strony (wyszukaj application/ld+json)
• Wyeksportowany raport audytu (CSV)
• Logi PrestaShop, jeśli dostępne

Licencja

Dystrybuowane na licencji Academic Free License (AFL 3.0).
Copyright © WePresta (ADAMAS GROUP SA). Wszelkie prawa zastrzeżone.