# 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… - Strona: - Język: pl - Zaktualizowano: 2026-07-29 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfgpsr-sw/index.md), [en](https://www.datafirefly.com/en/documentation/dfgpsr-sw/index.md), [es](https://www.datafirefly.com/es/documentation/dfgpsr-sw/index.md), [de](https://www.datafirefly.com/de/documentation/dfgpsr-sw/index.md), [it](https://www.datafirefly.com/it/documentation/dfgpsr-sw/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgpsr-sw/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfgpsr-sw/index.md) - Indeks: 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. DfGpsr SW to techniczne narzędzie wyświetlania. Pomaga zaprezentować wymagane informacje, ale poprawność i kompletność wprowadzonych danych pozostaje Twoją odpowiedzialnością, podobnie jak ocena, czy rozporządzenie ma zastosowanie do Twoich produktów. Ten przewodnik nie stanowi porady prawnej. ## 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. Zgodny z Shopware 6.5.x, 6.6.x i 6.7.x na jednym codebase. Nie jest potrzebny żaden build storefrontu ani administracji, a plugin nie dodaje żadnej zależności Composera. To właśnie gwarantuje identyczną instalację na trzech wersjach, w tym w nowej administracji 6.7. ## 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. Jeśli sprzedajesz produkty własnej marki, wpisz producenta jeden raz w konfiguracji globalnej: cały katalog jest pokryty bez dotykania produktów. Pola per produkt służą wtedy wyłącznie do wyjątków. ## 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. Pamiętaj, aby dostarczyć swoje ostrzeżenia w języku każdego kraju docelowego: GPSR wymaga, aby informacje o bezpieczeństwie były zrozumiałe dla konsumenta na danym rynku. ## 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.