- poprawiono regex-y do czyszczenia mark-upu Json LD z plików modułów
Najważniejsze funkcje modułu
Jeden graf JSON-LD i kontrola publikowanych encji
- Jeden dokument JSON-LD. Moduł składa włączone dane w jeden graf Schema.org z
@contexti@graph, zamiast tworzyć osobny fragment JSON dla każdego typu danych. - Powiązania przez
@id. Encje mogą odwoływać się między sobą, na przykład oferta produktu do organizacji, a strona do witryny i okruszków nawigacyjnych. - Generowanie po stronie PHP. JSON jest budowany przez klasę modułu i kodowany przez
json_encode(); szablon otrzymuje gotowy znacznik<script type="application/ld+json">. - Wyrenderowanie po przygotowaniu strony. Moduł korzysta z
displayFooter, aby mieć dostęp do danych widocznej listy produktów oraz pytań FAQ przekazanych do Smarty. - Niezależne przełączniki. Organization, LocalBusiness, Product, BreadcrumbList, WebSite, WebPage, CheckoutPage, ContactPage, SearchResultsPage, Article, CollectionPage i FAQPage są włączane niezależnie.
Organization, OnlineStore i dane handlowe
- Typ organizacji. Można skonfigurować encję jako
OnlineStore,OnlineBusiness,Organization,CorporationalboStore. - Źródło danych firmy. Nazwa, adres i kontakt mogą korzystać z ustawień sklepu PrestaShop albo z wartości wprowadzonych ręcznie w module.
- Identyfikacja podmiotu. Moduł obsługuje między innymi nazwę prawną, nazwy alternatywne, opis, logo, obrazy, adres, e-mail, telefon, profile
sameAs, NIP, VAT ID, kod ISO 6523, GLN i datę założenia — jeżeli dane zostaną uzupełnione. - Punkty kontaktowe. W konfiguracji zaawansowanej można dodać powtarzalne kanały kontaktu z typem kontaktu, telefonem, e-mailem, językami i obszarem obsługi.
- Warunki handlowe. Organizacja może otrzymać konfigurację zasad zwrotów, usług dostawy oraz poziomów programu lojalnościowego. Dane są publikowane wyłącznie wtedy, gdy administrator poda kompletne, prawdziwe wartości.
LocalBusiness dla punktów stacjonarnych i obsługi lokalnej
- Jeden punkt albo wiele oddziałów. Podstawowe pola tworzą domyślną encję LocalBusiness, a powtarzalna lista oddziałów pozwala opublikować osobne encje ze stabilnymi identyfikatorami.
- Adres i dane lokalne. Dla lokalizacji można podać typ działalności, nazwę, markę, adres, telefon, e-mail, adres strony, kod oddziału, zakres cen, obsługiwany obszar, akceptowane płatności i waluty.
- Współrzędne i mapa. Dostępne są pola szerokości oraz długości geograficznej, adresu mapy i adresów obrazów.
- Godziny standardowe i szczególne. Moduł obsługuje godziny otwarcia według dni tygodnia oraz wiersze z zakresem dat dla sezonowych lub wyjątkowych godzin.
- Walidacja adresu. Przy ręcznie skonfigurowanej aktywnej lokalizacji wymagane są kompletne dane adresowe: ulica, miasto, kod pocztowy i dwuliterowy kod kraju ISO.
Produkt, oferta i warianty
- Product albo ProductGroup. Produkt bez dostępnych wariantów otrzymuje encję
Product; produkt z dostępnymi kombinacjami może zostać opisany jakoProductGroupz encjamihasVariant. - Dane pobierane z PrestaShop. Moduł wykorzystuje nazwę, opis, kategorię, obrazy, referencję SKU, MPN, EAN-13, UPC, producenta, masę, wymiary, cenę, walutę, dostępność i stan produktu — gdy są dostępne i mają zastosowanie.
- Oferty zależne od możliwości zakupu. Encja
Offerjest dodawana tylko wtedy, gdy katalog nie jest w trybie katalogowym, produkt może być zamawiany i cena jest widoczna na stronie produktu. - Warianty z własnym adresem. Każdy opublikowany wariant otrzymuje powiązanie z kombinacją PrestaShop; gdy generator URL zwraca jeden adres kanoniczny, moduł dodaje parametr
id_product_attribute. - Mapowanie cech wariantu. Grupy atrybutów można przypisać do właściwości, takich jak kolor lub rozmiar, a pozostałe osie wariantów są przekazywane jako
additionalPropertyz publiczną nazwą atrybutu. - Dane rozszerzające produkt. Konfiguracja zaawansowana pozwala mapować cechy produktu na właściwości, materiał, wzór, certyfikaty i dane energetyczne. Moduł przekazuje też cenę jednostkową, gdy dane jednostki i współczynnika w produkcie pozwalają ją wyliczyć.
- GTIN i zdjęcia. Builder sprawdza poprawność długości i cyfry kontrolnej GTIN, a dane obrazów produktu obejmują dostępne obrazy produktu, nie tylko okładkę.
- Granica liczby wariantów. Domyślny limit wynosi 100 kombinacji na sklep, a bezwzględny limit techniczny to 250. Po jego przekroczeniu moduł nie buduje rozbudowanego
ProductGroupz wszystkimi wariantami, aby nie rozdmuchać odpowiedzi strony. - Dostawa i zwroty. Można przekazać szczegóły wysyłki oraz politykę zwrotów na poziomie organizacji albo włączyć osobne nadpisanie dla ofert produktu.
Strony, treści i widoczne elementy sklepu
- BreadcrumbList. Moduł buduje okruszki z widocznej nawigacji, a gdy nie są dostępne, stosuje obsługę stron produktu, kategorii, producenta, dostawcy, CMS i rozpoznanych stron blogowych.
- WebSite na stronie głównej. Encja
WebSitejest publikowana dla strony głównej sklepu po jej włączeniu. - WebPage i strony specjalne. Moduł tworzy
WebPagez typem dobieranym do bieżącego kontrolera, a osobne przełączniki obsługująCheckoutPage,ContactPageiSearchResultsPage. - Article. Integracja dotyczy wpisów z
ph_simpleblogismartblog; może przekazać tytuł, opis, obraz, daty oraz autora widocznego na stronie. - CollectionPage. Dla list kategorii, producenta, dostawcy, nowości, promocji i bestsellerów moduł buduje listę widocznych produktów. Limit pozycji jest konfigurowalny od 1 do 200, domyślnie 50.
- FAQPage z treści widocznej dla użytkownika. Pytania i odpowiedzi są pobierane wyłącznie z danych przekazanych przez aktualnie wyrenderowaną stronę pod kluczami
pd_faqs,product_faqslubfaqs.
Panel administracyjny i utrzymanie danych
- Obszar roboczy i podgląd. Panel modułu grupuje ustawienia schematów oraz zawiera podgląd generowanego JSON-LD na podstawie bieżącej konfiguracji.
- Kontrola zapisu. Moduł waliduje między innymi wymagane dane ręcznej organizacji, e-maile, kody kraju, adresy HTTP(S), zakresy liczbowe, godziny, wiersze powtarzalne i konfigurację dostawy oraz zwrotów.
- Multistore. Konfiguracja jest zapisywana w kontekście sklepu; każdy sklep może publikować własne dane firmy, lokalizacji i handlowe.
- Usuwanie starszego JSON-LD. Narzędzia modułu mogą wykonać kopię zapasową i usunąć wykryte starsze fragmenty JSON-LD z plików motywu albo modułów, a następnie odtworzyć wybrane dane z archiwum.
Znaczenie dla SEO i GEO — bez obietnic bez pokrycia
JSON-LD przekazuje wyszukiwarkom i systemom przetwarzającym dane ustrukturyzowaną informację o sklepie, firmie, produktach, lokalizacjach oraz widocznych treściach. Dla GEO ważna jest zgodność nazw, adresów, kontaktów, obszarów obsługi i profili z rzeczywistymi danymi przedsiębiorstwa; moduł nie uzupełnia ich za administratora ani nie sprawdza ich prawdziwości poza walidacją formatu. Dane strukturalne nie zastępują jakości strony, dostępności treści, indeksowania, polityki wyszukiwarki ani konfiguracji Google Search Console. Wynik należy sprawdzać na opublikowanej stronie konkretnego sklepu po włączeniu odpowiednich encji i uzupełnieniu danych.
Ważne granice działania
- Moduł nie wysyła danych do Google, nie zgłasza adresów do indeksu i nie wymusza wyników rozszerzonych.
- Nie zarządza treścią FAQ. Plik
faq.jsonjest materiałem do importu pytań i odpowiedzi; sam moduł Schema.org nie odczytuje go bezpośrednio podczas generowania strony. FAQPage,CollectionPageiArticlezależą od danych faktycznie dostępnych na aktualnej stronie oraz od obsługiwanych integracji.- Niestandardowy motyw lub moduł, który nie wywołuje
displayFooteralbo nie przekazuje widocznych danych do Smarty, wymaga sprawdzenia w konkretnym sklepie. - Przed zakupem potwierdź wersję paczki dla swojego PrestaShop i PHP. Wymagania środowiska muszą być zgodne zarówno z modułem, jak i używaną wersją platformy.
Link do demo modułu:
Demo panel administracyjny:
https://moduly-prestashop.eu/znaczniki-rozszerzone/admin-dev
Demo panel przedni:
https://moduly-prestashop.eu/znaczniki-rozszerzone
Sprawdzenie poprawności działania danych strukturalnych:
https://validator.schema.org
Porównaj JSON-LD z tym, co widzi kupujący
Wybierz produkt prosty, produkt z kombinacjami i stronę bez produktu. Sprawdź wszystkie źródła danych strukturalnych: moduł, motyw i inne rozszerzenia. Poradnik Schema.org pokazuje kolejność kontroli.
Co sprawdzić przed uruchomieniem?
- Cena, waluta, dostępność i wariant powinny odpowiadać widocznej ofercie w tym samym kontekście.
- Oceny muszą pochodzić z rzeczywistych, dostępnych opinii. Nie uzupełniaj brakujących recenzji wymyślonymi wartościami.
- Poprawność składni sprawdź osobno od wymagań konkretnego wyniku rozszerzonego Google. Sam poprawny typ Schema.org nie gwarantuje takiego wyniku.