Konfiguracja Pasporto
Ten poradnik szczegółowo opisuje opcje konfiguracyjne Pasporto, zasady walidacji danych oraz generowane znaczniki danych strukturalnych.
Ekran ustawień
Dział zatytułowany „Ekran ustawień”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). |
Porównanie miejsc wyświetlania
Dział zatytułowany „Porównanie miejsc wyświetlania”- 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.
- Rejestruje zakładkę “Digital Product Passport (DPP)” przez filtr
- W podsumowaniu produktu (
summary):- Wstawiana bezpośrednio do kolumny podsumowania przez akcję
woocommerce_single_product_summaryz priorytetem28. - 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.
- Wstawiana bezpośrednio do kolumny podsumowania przez akcję
Specyfikacja pól i walidacja
Dział zatytułowany „Specyfikacja pól i walidacja”Wszystkie parametry paszportu konfiguruje się w klasycznym edytorze produktu w zakładce Ogólne boksu danych produktu:
1. Unique Product ID (UPI / GTIN)
Dział zatytułowany „1. Unique Product ID (UPI / GTIN)”- 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.
2. Passport URL
Dział zatytułowany „2. Passport URL”- 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").
3. Primary Material
Dział zatytułowany „3. Primary Material”- Klucz w bazie:
primary_material - Format: Tekst.
- Zastosowanie: Skład materiałowy produktu (np. “100% bawełna z recyklingu”, “Stop aluminium 6061-T6”).
4. Recycled Content (%)
Dział zatytułowany „4. Recycled Content (%)”- Klucz w bazie:
recycled_content - Format: Wartość liczbowa, automatycznie przycinana do zakresu od
0do100. - Zastosowanie: Certyfikowany udział surowców wtórnych.
5. Carbon Footprint (kg CO2e)
Dział zatytułowany „5. Carbon Footprint (kg CO2e)”- 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ę.
6. Circularity Class
Dział zatytułowany „6. Circularity Class”- 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.
7. Declaration of Conformity
Dział zatytułowany „7. Declaration of Conformity”- 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.
Integracja z danymi strukturalnymi (JSON-LD)
Dział zatytułowany „Integracja z danymi strukturalnymi (JSON-LD)”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
additionalPropertyjako obiektyPropertyValuez prawidłowymi nazwami i jednostkami (%,kg CO2e).