SEO Rich Data - instalacja i konfiguracja

Cel modułu

Moduł Kowal_SeoRichData dodaje do Magento 2 dane strukturalne schema.org w formacie JSON-LD. Generowane dane mogą obejmować produkty, oferty, ceny, dostępność, oceny, recenzje, breadcrumbs, dane organizacji, nazwę strony, search box, profile społecznościowe, FAQ oraz wideo.

Konfiguracja modułu znajduje się w panelu administracyjnym Magento:

Stores > Configuration > Kowal > SEO Rich Data

Wymagania

• Magento 2.
• Dostęp do CLI Magento.
• Dostęp do Composer repository z pakietem kowal/module-seo-rich-data.
• Wymagany pakiet bazowy: kowal/base.
• Uprawnienia do uruchamiania komend bin/magento.

Instalacja przez Composer

1. Dodaj repozytorium pakietu:

composer config repositories.kowal composer https://repo.kowal.store

2. Jeśli repozytorium jest prywatne, dodaj token dostępu GitHub:

composer config http-basic.repo.kowal.store <YOUR E-MAIL> <YOUR-TOKEN>

3. Zainstaluj moduł:

composer require kowal/module-seo-rich-data

4. Włącz moduł:

php bin/magento module:enable Kowal_SeoRichData

5. Uruchom aktualizację Magento:

php bin/magento setup:upgrade

6. W środowisku produkcyjnym wykonaj kompilację DI:

php bin/magento setup:di:compile

7. W środowisku produkcyjnym, jeśli projekt tego wymaga, wygeneruj statyczne pliki:

php bin/magento setup:static-content:deploy

8. Wyczyść cache:

php bin/magento cache:flush

Instalacja ręczna

1. Skopiuj moduł do katalogu:

app/code/Kowal/SeoRichData

2. Włącz moduł:

php bin/magento module:enable Kowal_SeoRichData

3. Uruchom aktualizację Magento:

php bin/magento setup:upgrade

4. Wyczyść cache:

php bin/magento cache:flush

Czynności po instalacji

Po instalacji moduł dodaje atrybut produktu:

Atrybut obsługuje wartości:

Jeśli produkt nie ma ustawionej wartości atrybutu, moduł traktuje go jako NewCondition.

Zakres konfiguracji

Wszystkie pola konfiguracyjne są dostępne dla zakresów Default, Website i Store View, zgodnie z ustawieniami Magento.

Pola typu Enabled, Show ... i podobne używają standardowych wartości Magento:

Breadcrumbs

Sekcja odpowiada za dane strukturalne ścieżki nawigacji.

Wartości pola Type:

Include Your Site Name in Search Results

Sekcja odpowiada za dane typu WebSite, które mogą pomóc Google rozpoznać nazwę witryny.

Organization

Sekcja odpowiada za dane typu Organization.

Kraj z tej sekcji może być użyty jako fallback dla kraju wysyłki i kraju polityki zwrotów, jeśli odpowiednie pola w sekcji produktu pozostają puste.

Social Profiles

Sekcja dodaje profile społecznościowe organizacji. Aby dane miały sens, sekcja Organization powinna być włączona.

Puste pola są pomijane.

Search Box

Sekcja odpowiada za dane SearchAction, które mogą umożliwić wyświetlanie pola wyszukiwania sklepu w wynikach Google.

Category Rich Data

Sekcja odpowiada za generowanie danych produktów na stronach kategorii.

Włączenie tej opcji może pogorszyć wydajność stron kategorii, ponieważ moduł musi zebrać dane dla wielu produktów.

Product Rich Data

Sekcja odpowiada za główne dane produktu typu Product oraz za dane offers.

Podstawowe pola produktu

Wartości pola Description:

Produkty konfigurowalne i grupowane

Wartości:

Oceny i recenzje

Wartości pola Rating Format:

Integracja z Yotpo wymaga dostępności modułu obsługującego Yotpo. Jeśli moduł nie jest zainstalowany, konfiguracja Yotpo nie powinna być włączana.

Brand, manufacturer i identyfikatory produktu

Pole EAN / GTIN Attribute generuje właściwość zależnie od liczby cyfr:

Moduł usuwa znaki inne niż cyfry z wartości EAN / GTIN przed wygenerowaniem JSON-LD.

Shipping details

Sekcja wysyłki odpowiada za wygenerowanie shippingDetails w offers. Dane są dodawane tylko wtedy, gdy sekcja jest włączona i ma komplet wymaganych wartości.

Waluta kosztu wysyłki jest pobierana z waluty oferty produktu.

Przykład znaczenia wartości:

Merchant return policy

Sekcja polityki zwrotów odpowiada za wygenerowanie hasMerchantReturnPolicy w offers. Dane są dodawane tylko wtedy, gdy sekcja jest włączona i ma wymagane wartości.

Wartości pola Return Policy Category:

Wartości pola Return Method:

Wartości pola Return Fees:

Waluta pola Return Shipping Fee jest pobierana z waluty oferty produktu.

Custom Properties

Pole Custom Properties pozwala dodać własne właściwości do JSON-LD produktu.

Format:

wlasciwosc_jsonld,kod_atrybutu

Jeśli podany jest tylko jeden element, moduł traktuje go jednocześnie jako nazwę właściwości JSON-LD i kod atrybutu.

Domyślna wartość:

sku
mpn,sku

Znaczenie domyślnej wartości:

Przykład dodania własnego atrybutu:

color,color
material,material

Zalecana konfiguracja minimalna dla produktów

Aby ograniczyć ostrzeżenia Google Search Console dla danych produktowych, skonfiguruj co najmniej:

Czyszczenie cache po zmianach konfiguracji

Po zmianie konfiguracji wykonaj:

php bin/magento cache:flush

Jeśli sklep używa dodatkowego cache HTTP, Varnish lub CDN, wyczyść również te warstwy cache.

Weryfikacja działania

1. Otwórz stronę produktu na frontendzie.
2. Sprawdź źródło strony i znajdź:

<script type="application/ld+json">

3. Zweryfikuj, czy JSON-LD zawiera oczekiwane pola, np.:

{
  "@type": "Product",
  "brand": {
    "@type": "Brand",
    "name": "Example Brand"
  },
  "gtin13": "5901234123457",
  "offers": [
    {
      "@type": "Offer",
      "shippingDetails": {},
      "hasMerchantReturnPolicy": {}
    }
  ]
}

4. Przetestuj adres URL produktu w narzędziu Google Rich Results Test lub w Google Search Console.

Uwagi wdrożeniowe

• Nie włączaj shippingDetails ani hasMerchantReturnPolicy, jeśli wartości w konfiguracji nie odpowiadają rzeczywistej polityce sklepu.
• Jeśli polityki wysyłki lub zwrotów różnią się per produkt, region, metoda dostawy albo koszyk, jedna globalna konfiguracja może nie być wystarczająca.
• Po zmianie atrybutów Brand, Manufacturer lub EAN / GTIN Attribute warto przeindeksować dane produktu, jeśli sklep używa cache lub indeksów wpływających na odczyt atrybutów.
• W sklepach wielojęzycznych i wielowalutowych sprawdź konfigurację osobno dla każdego Store View.