Przejdź do głównej zawartości

Konfiguracja Pasporto

Ten poradnik szczegółowo opisuje opcje konfiguracyjne Pasporto, zasady walidacji danych oraz generowane znaczniki danych strukturalnych.

Przejdź do WooCommerce > Product Passport (DPP) w panelu administracyjnym WordPressa. Strona jest dostępna dla każdego użytkownika z uprawnieniem manage_woocommerce.

Ustawienia są zapisywane w pojedynczej opcji WordPressa pasporto_settings:

Ustawienie Domyślnie Opis
Enable Product Passports 1 (włączone) Włącza lub wyłącza wyświetlanie paszportu na stronach produktów oraz rozszerzanie danych strukturalnych JSON-LD. Wyłączenie ukrywa sekcję bez kasowania danych w produktach.
Display Location tab Określa miejsce prezentacji sekcji. Opcje: tab (In its own product tab) lub summary (Under single product summary).
  • We własnej zakładce produktu (tab):
    • Rejestruje zakładkę “Digital Product Passport (DPP)” przez filtr woocommerce_product_tabs.
    • Pozycjonowana po domyślnych zakładkach WooCommerce z priorytetem 40.
    • Rekomendowana dla obszernych danych technicznych i parametrów, gdy nie chcesz wydłużać sekcji zakupu.
  • W podsumowaniu produktu (summary):
    • Wstawiana bezpośrednio do kolumny podsumowania przez akcję woocommerce_single_product_summary z priorytetem 28.
    • Pojawia się tuż nad przyciskiem dodania do koszyka.
    • Rekomendowana, gdy zależy Ci na natychmiastowej widoczności parametrów ekologicznych przed podjęciem decyzji o zakupie.

Wszystkie parametry paszportu konfiguruje się w klasycznym edytorze produktu w zakładce Ogólne boksu danych produktu:

  • Klucz w bazie: upi
  • Format: Tekst (oczyszczany funkcją sanitize_text_field).
  • Zastosowanie: Przyjmuje GS1 Digital Link, GTIN (EAN/UPC), EPC lub inny unikalny kod dostarczony przez producenta.
  • Klucz w bazie: passport_url
  • Format: Prawidłowy adres URL (oczyszczany funkcją esc_url_raw).
  • Zastosowanie: Adres publicznej strony lub rejestru z pełnym paszportem cyfrowym. Generuje przycisk Open the product passport (target="_blank" rel="noopener noreferrer").
  • Klucz w bazie: primary_material
  • Format: Tekst.
  • Zastosowanie: Skład materiałowy produktu (np. “100% bawełna z recyklingu”, “Stop aluminium 6061-T6”).
  • Klucz w bazie: recycled_content
  • Format: Wartość liczbowa, automatycznie przycinana do zakresu od 0 do 100.
  • Zastosowanie: Certyfikowany udział surowców wtórnych.
  • Klucz w bazie: carbon_footprint
  • Format: Liczba nieujemna (wartości mniejsze od 0 są odrzucane).
  • Zastosowanie: Ślad węglowy produktu w cyklu życia podany w kilogramach ekwiwalentu CO2 na sztukę.
  • Klucz w bazie: circularity_class
  • Format: Wybór z listy: "" (Not specified), A, B, C, D, E.
  • Zastosowanie: Klasa cyrkularności zadeklarowana przez producenta. Pasporto nie oblicza ani nie modyfikuje tej oceny.
  • Klucz w bazie: doc_url
  • Format: Prawidłowy adres URL (oczyszczany funkcją esc_url_raw).
  • Zastosowanie: Bezpośredni odnośnik do unijnej deklaracji zgodności (DoC). Wyświetla się jako aktywny link w tabeli.

Pasporto nie generuje osobnego, konkurującego bloku schema. Zamiast tego dołącza się do natywnego mechanizmu WooCommerce za pomocą filtra woocommerce_structured_data_product.

Gdy pola paszportu są wypełnione, Pasporto rozszerza istniejący węzeł Product:

  • Jeśli WooCommerce nie ustawił identyfikatora na poziomie głównym, Pasporto wpisuje kod UPI do pola identifier.
  • Wszystkie aktywne parametry środowiskowe są dopisywane do tablicy additionalProperty jako obiekty PropertyValue z prawidłowymi nazwami i jednostkami (%, kg CO2e).