Dane strukturalne Schema.org

Automatyczne dane strukturalne JSON-LD (Schema.org) na stronach produktów. Pomagają wyszukiwarkom wyświetlać rich snippets w wynikach.

Automatyczne generowanie

Dane generują się automatycznie na stronach produktów. Nie potrzebujesz dodatkowej wtyczki SEO.

Jeśli używasz Yoast, Rank Math lub SEOPress, plugin uzupełnia ich dane zamiast duplikować.

Typ Product

Na stronie produktu generowany jest obiekt Product:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Koszulka bawełniana Premium",
  "description": "Koszulka z certyfikowanej bawełny organicznej, rozmiary S-XXL.",
  "image": [
    "https://twojsklep.pl/wp-content/uploads/koszulka-1.jpg",
    "https://twojsklep.pl/wp-content/uploads/koszulka-2.jpg"
  ],
  "sku": "KSZ-001",
  "gtin13": "5901234123457",
  "brand": {
    "@type": "Brand",
    "name": "MojaMarka"
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Producent XYZ Sp. z o.o.",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "ul. Fabryczna 1",
      "addressLocality": "Warszawa",
      "postalCode": "00-001",
      "addressCountry": "PL"
    },
    "email": "kontakt@xyz.pl",
    "url": "https://xyz.pl"
  },
  "countryOfOrigin": {
    "@type": "Country",
    "name": "PL"
  },
  "offers": { ... },
  "aggregateRating": { ... }
}

Pola Product

Pole Schema.org	Źródło danych	Wymagane
`name`	Nazwa produktu WooCommerce	Tak
`description`	Opis krótki produktu	Tak
`image`	Zdjęcie główne + galeria	Tak
`sku`	SKU produktu	Nie
`gtin13` / `gtin8`	Pole GTIN/EAN z Polski	Nie
`brand`	Producent/marka z Polski	Nie
`manufacturer`	Dane GPSR producenta	Nie
`countryOfOrigin`	Kraj pochodzenia z GPSR	Nie
`category`	Kategoria produktu	Nie
`material`	Atrybut “materiał” (jeśli istnieje)	Nie
`color`	Atrybut “kolor” (jeśli istnieje)	Nie
`weight`	Waga produktu WooCommerce	Nie

Typ Offer

Zagnieżdżony obiekt Offer z ceną i dostępnością:

{
  "@type": "Offer",
  "url": "https://twojsklep.pl/produkt/koszulka-bawelniana/",
  "price": "89.00",
  "priceCurrency": "PLN",
  "priceValidUntil": "2026-12-31",
  "availability": "https://schema.org/InStock",
  "itemCondition": "https://schema.org/NewCondition",
  "seller": {
    "@type": "Organization",
    "name": "Mój Sklep"
  },
  "shippingDetails": {
    "@type": "OfferShippingDetails",
    "deliveryTime": {
      "@type": "ShippingDeliveryTime",
      "handlingTime": {
        "@type": "QuantitativeValue",
        "minValue": 1,
        "maxValue": 2,
        "unitCode": "d"
      },
      "transitTime": {
        "@type": "QuantitativeValue",
        "minValue": 1,
        "maxValue": 3,
        "unitCode": "d"
      }
    },
    "shippingDestination": {
      "@type": "DefinedRegion",
      "addressCountry": "PL"
    }
  },
  "hasMerchantReturnPolicy": {
    "@type": "MerchantReturnPolicy",
    "merchantReturnDays": 14,
    "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
    "returnMethod": "https://schema.org/ReturnByMail"
  }
}

Pola Offer

Pole Schema.org	Źródło danych
`price`	Cena produktu
`priceCurrency`	Waluta WooCommerce
`priceValidUntil`	Data zakończenia promocji
`availability`	Status magazynowy
`itemCondition`	Zawsze NewCondition
`seller`	Nazwa sklepu z ustawień
`deliveryTime`	Czas dostawy z modułu Polski
`hasMerchantReturnPolicy`	Prawo odstąpienia z modułu Polski

Mapowanie dostępności

Status WooCommerce	Schema.org
`instock`	`https://schema.org/InStock`
`outofstock`	`https://schema.org/OutOfStock`
`onbackorder`	`https://schema.org/BackOrder`

Typ Offer dla produktów zmiennych

Produkty zmienne generują AggregateOffer:

{
  "@type": "AggregateOffer",
  "lowPrice": "69.00",
  "highPrice": "129.00",
  "priceCurrency": "PLN",
  "offerCount": 6,
  "availability": "https://schema.org/InStock",
  "offers": [
    {
      "@type": "Offer",
      "price": "69.00",
      "sku": "KSZ-001-S",
      "availability": "https://schema.org/InStock"
    }
  ]
}

Typ AggregateRating

Przy produktach z opiniami generowany jest AggregateRating:

{
  "@type": "AggregateRating",
  "ratingValue": "4.5",
  "bestRating": "5",
  "worstRating": "1",
  "ratingCount": 23,
  "reviewCount": 18
}

Dane z systemu opinii WooCommerce. Z aktywnym modułem Zweryfikowane opinie uwzględniane są tylko opinie z potwierdzonego zakupu.

Typ Review

Poszczególne opinie generowane są jako obiekty Review:

{
  "@type": "Review",
  "author": {
    "@type": "Person",
    "name": "Jan K."
  },
  "datePublished": "2025-05-20",
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": "5",
    "bestRating": "5"
  },
  "reviewBody": "Świetna jakość materiału, polecam."
}

Produkty spożywcze - NutritionInformation

Produkty spożywcze generują obiekt NutritionInformation:

{
  "@type": "NutritionInformation",
  "calories": "250 kcal",
  "fatContent": "12 g",
  "saturatedFatContent": "3 g",
  "carbohydrateContent": "30 g",
  "sugarContent": "5 g",
  "proteinContent": "8 g",
  "sodiumContent": "0.8 g",
  "fiberContent": "2 g",
  "servingSize": "100 g"
}

Filtrowanie danych strukturalnych

Modyfikacja całego obiektu

add_filter('polski/schema/product', function (array $schema, WC_Product $product): array {
    // Dodanie własnego pola
    $schema['award'] = 'Produkt Roku 2025';
    return $schema;
}, 10, 2);

Modyfikacja Offer

add_filter('polski/schema/offer', function (array $offer, WC_Product $product): array {
    // Dodanie informacji o gwarancji
    $offer['warranty'] = [
        '@type' => 'WarrantyPromise',
        'durationOfWarranty' => [
            '@type'    => 'QuantitativeValue',
            'value'    => 24,
            'unitCode' => 'MON',
        ],
    ];
    return $offer;
}, 10, 2);

Wyłączenie Schema.org dla wybranych produktów

add_filter('polski/schema/enabled', function (bool $enabled, int $product_id): bool {
    // Wyłącz dla produktów z kategorii "tymczasowe"
    if (has_term('tymczasowe', 'product_cat', $product_id)) {
        return false;
    }
    return $enabled;
}, 10, 2);

Walidacja danych strukturalnych

Przetestuj dane strukturalne:

Google Rich Results Test - oficjalne narzędzie Google
Schema.org Validator - walidator Schema.org

Z WP_DEBUG = true wtyczka loguje brakujące pola Schema.org do debug.log.

Integracja z wtyczkami SEO

Plugin wykrywa wtyczki SEO i dostosowuje zachowanie:

Wtyczka	Zachowanie
Yoast SEO	Uzupełnia istniejący schemat Yoast o pola Polski
Rank Math	Uzupełnia schemat Rank Math o pola Polski
SEOPress	Uzupełnia schemat SEOPress o pola Polski
Brak	Generuje pełny schemat samodzielnie

Przy duplikacji danych użyj filtra:

add_filter('polski/schema/standalone', '__return_false'); // Wyłącz samodzielne generowanie

Rozwiązywanie problemów

Google nie wyświetla rich snippets - rich snippets mogą pojawić się po kilku tygodniach od zaindeksowania. Upewnij się, że dane przechodzą walidację w Rich Results Test.

Duplikacja danych strukturalnych - jeśli inna wtyczka generuje schemat Product, użyj filtra polski/schema/standalone do wyłączenia samodzielnego generowania.

Brak ocen w Schema.org - produkt musi mieć co najmniej 1 opinię z oceną gwiazdkową.

Zgłaszanie problemów: github.com/wppoland/polski/issues

Ta strona ma wyłącznie charakter informacyjny i nie stanowi porady prawnej. Przed wdrożeniem skonsultuj się z prawnikiem. Polski for WooCommerce jest oprogramowaniem open source (GPLv2) dostarczanym bez gwarancji.