DfGpsr SW: kompletny przewodnik

DfGpsr SW wyświetla na kartach produktów Shopware informacje o bezpieczeństwie wymagane przez rozporządzenie (UE) 2023/988, czyli ogólne rozporządzenie o bezpieczeństwie produktów (GPSR), obowiązujące od 13 grudnia 2024. Shopware nie oferuje w tym zakresie nic solidnego natywnie. DfGpsr SW wypełnia tę lukę polami niestandardowymi per produkt, konfigurowalnymi globalnymi wartościami zapasowymi per kanał sprzedaży i automatycznym wyświetlaniem pod opisem produktu. Plugin jest celowo zbudowany bez własnego komponentu administracji i bez JavaScriptu w storefroncie: jeden i ten sam ZIP instaluje się identycznie na Shopware 6.5, 6.6 i 6.7, bez żadnej kompilacji. Ten przewodnik obejmuje instalację, konfigurację globalną, uzupełnianie danych per produkt, tłumaczenie, personalizację szablonu i rozwiązywanie problemów.

Czego wymaga GPSR

W sprzedaży internetowej rozporządzenie (UE) 2023/988 wymaga, aby każda oferta jasno pokazywała przed zakupem:

• producenta: nazwę, adres pocztowy i adres e-mail;
• osobę odpowiedzialną z siedzibą w UE (artykuł 16), gdy producent ma siedzibę poza Unią: nazwę, adres pocztowy i adres e-mail;
• ostrzeżenia i informacje dotyczące bezpieczeństwa w języku kraju docelowego.

DfGpsr SW pokrywa te trzy wymagania, a dodatkowo listę dokumentów bezpieczeństwa (instrukcje, karty charakterystyki, certyfikaty) oraz przełącznik ukrywania dla indeksów spoza zakresu rozporządzenia.

Instalacja

1. Pobierz archiwum DfGpsr-v1.0.0.zip ze swojego konta DataFirefly.
2. Skopiuj rozpakowany katalog DfGpsr do custom/plugins/ swojego Shopware albo zainstaluj ZIP przez Administracja → Rozszerzenia → Moje rozszerzenia → Prześlij rozszerzenie.
3. Uruchom instalację i aktywację:

   bin/console plugin:refresh
   bin/console plugin:install --activate DfGpsr
   bin/console cache:clear

4. Przy instalacji plugin tworzy swój zestaw pól niestandardowych df_gpsr na encji produktu. Przy odinstalowaniu bez zachowania danych ten zestaw pól i wszystkie jego wartości są usuwane.

Konfiguracja globalna (wartości zapasowe)

Otwórz Rozszerzenia → Moje rozszerzenia → DataFirefly GPSR Compliance → ⋯ → Konfiguruj. Konfiguracja jest zorganizowana w karty:

• Ogólne: włączenie wyświetlania bloku, pokazywanie lub nie tytułu sekcji oraz opcja wymuszonego wyświetlania nawet bez danych (zarezerwowana dla theming/debug).
• Domyślny producent: nazwa, adres pocztowy i e-mail używane, gdy produkt nie definiuje własnego producenta.
• Domyślna osoba odpowiedzialna w UE: nazwa, adres pocztowy i e-mail.
• Domyślne teksty bezpieczeństwa: ogólne ostrzeżenia i informacje dotyczące bezpieczeństwa.

Wszystkie te wartości są konfigurowalne per kanał sprzedaży dzięki natywnemu selektorowi Shopware u góry konfiguracji. Wybierz kanał, aby przypisać mu konkretne wartości, albo zostaw “Wszystkie kanały sprzedaży” dla wartości wspólnych.

Uzupełnienie danych produktu

Otwórz produkt w Katalogi → Produkty, a następnie zakładkę Specyfikacje → Pola niestandardowe. Grupa GPSR: bezpieczeństwo produktu zawiera następujące pola:

• Ukryj informacje GPSR dla tego produktu: przełącznik do włączenia dla indeksów spoza zakresu rozporządzenia.
• Producent: nazwa, adres pocztowy, adres e-mail.
• Osoba odpowiedzialna w UE: nazwa, adres pocztowy, adres e-mail.
• Ostrzeżenia i Informacje o bezpieczeństwie: edytory tekstu sformatowanego.
• Dokumenty bezpieczeństwa: jeden na linię, w formacie Etykieta|URL albo po prostu URL.

Reguła rozstrzygania jest prosta: dla każdego pola plugin używa wartości produktu, jeśli jest uzupełniona, a w przeciwnym razie schodzi do wartości domyślnej kanału sprzedaży. Pole “Dokumenty” nie ma globalnej wartości zapasowej: jest właściwe dla każdego produktu.

Format dokumentów bezpieczeństwa

Wpisuj jeden dokument na linię. Akceptowane są dwa formaty:

Instrukcja obslugi|https://example.com/instrukcja.pdf
Karta charakterystyki|https://example.com/karta.pdf
https://example.com/certyfikat.pdf

Przy formacie Etykieta|URL etykieta staje się klikalnym tekstem; sam URL wyświetla się w postaci surowej. Wszystkie linki otwierają się w nowej karcie.

Tłumaczenie

Pola są standardowymi polami niestandardowymi Shopware: tłumaczy się je produkt po produkcie przez selektor języka administracji, u góry karty produktu. Wpisz na przykład ostrzeżenia po polsku dla języka PL, a następnie przełącz na DE, aby wprowadzić wersję niemiecką.

Etykiety bloku storefrontu (tytuł “Bezpieczeństwo produktu”, “Producent”, “Osoba odpowiedzialna w UE” itd.) są dostarczane natywnie w pięciu językach: francuskim, angielskim, niemieckim, hiszpańskim i włoskim. Wyświetlają się automatycznie zgodnie z językiem kanału sprzedaży, bez konfiguracji.

Wyświetlanie w storefroncie

Blok GPSR jest wstrzykiwany automatycznie na stronie szczegółów produktu, tuż po opisie, w bloku Twig page_product_detail_description_content_text. Prezentuje producenta i osobę odpowiedzialną obok siebie, a następnie ostrzeżenia, informacje o bezpieczeństwie i listę dokumentów. Blok ukrywa się automatycznie, gdy żadne dane nie są dostępne, ani na produkcie, ani w konfiguracji globalnej.

Personalizacja szablonu

Komponent wyświetlania jest wydzielony w views/storefront/component/df-gpsr/gpsr-info.html.twig i wstrzykiwany przez views/storefront/page/product-detail/description.html.twig. Aby przenieść blok albo zmienić jego rendering, nadpisz jeden z tych dwóch plików w swoim motywie. Podstawowy styl jest inline i celowo neutralny, łatwy do zastąpienia własnymi klasami.

FAQ i rozwiązywanie problemów

Czy GPSR dotyczy mojego sklepu? Jeśli sprzedajesz nieżywnościowe produkty konsumenckie klientom w UE, to bardzo prawdopodobnie tak. Rozporządzenie obowiązuje od 13 grudnia 2024 dla większości produktów, w tym sprzedawanych online i importowanych z krajów trzecich.

Blok się nie wyświetla. Sprawdź, czy opcja “włącz wyświetlanie” jest zaznaczona w konfiguracji, czy produkt albo konfiguracja globalna zawiera przynajmniej jedną daną i czy przełącznik “Ukryj” nie jest włączony na produkcie. Wyczyść cache po każdej zmianie konfiguracji.

Blok się wyświetla, ale jest pusty. To prawdopodobnie pozostawiona aktywna opcja “wyświetlaj nawet bez danych”: wyłącz ją, aby wrócić do normalnego zachowania (automatyczne ukrywanie).

Moje pola niestandardowe renderują się jako zwykłe pole tekstowe w administracji 6.7. Mapowanie komponentów pól niestandardowych zmieniło się wraz z administracją Meteor. Jeśli pole adresu renderuje się jako prosty input zamiast pola tekstowego, to wyłącznie detal wyświetlania w administracji bez wpływu na storefront; zgłoś to do wsparcia w celu korekty.

Wartości domyślne się nie stosują. Sprawdź, czy uzupełniono konfigurację dla właściwego kanału sprzedaży. Wartość ustawiona na “Wszystkie kanały sprzedaży” jest nadpisywana przez wartość specyficzną dla kanału, jeśli taka istnieje.

Co dzieje się przy odinstalowaniu? Z opcją usunięcia danych zestaw pól df_gpsr i wszystkie wartości wprowadzone na produktach są usuwane. Bez tej opcji dane są zachowywane na potrzeby późniejszej ponownej instalacji.