# Zgodność z GPSR (bezpieczeństwo produktów): kompletny przewodnik

> Prezentacja Moduł Zgodność z GPSR (datafireflygpsr) przygotowuje Twój sklep do rozporządzenia (UE) 2023/988 w sprawie ogólnego bezpieczeństwa produktów, obowiązującego od 13 grudnia 2024. Wyświetla na każdej karcie produktu producenta, osobę…

- Strona: <https://www.datafirefly.com/pl/documentation/datafireflygpsr/>
- Język: pl
- Zaktualizowano: 2026-08-01
- Inne języki: [fr](https://www.datafirefly.com/documentation/datafireflygpsr/index.md), [en](https://www.datafirefly.com/en/documentation/datafireflygpsr/index.md), [es](https://www.datafirefly.com/es/documentation/datafireflygpsr/index.md), [de](https://www.datafirefly.com/de/documentation/datafireflygpsr/index.md), [it](https://www.datafirefly.com/it/documentation/datafireflygpsr/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafireflygpsr/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafireflygpsr/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Prezentacja

Moduł **Zgodność z GPSR** (`datafireflygpsr`) przygotowuje Twój sklep do **rozporządzenia (UE) 2023/988** w sprawie ogólnego bezpieczeństwa produktów, obowiązującego od 13 grudnia 2024. Wyświetla na każdej karcie produktu **producenta**, **osobę odpowiedzialną z siedzibą w Unii Europejskiej**, **ostrzeżenia bezpieczeństwa** i **piktogramy regulacyjne**, w języku klienta.

Moduł dostarcza narzędzia techniczne do zbierania i wyświetlania wymaganych informacji. Zgodność regulacyjna zależy także od poprawności wprowadzanych danych i analizy ryzyka właściwej dla każdego produktu. Moduł nie zastępuje porady prawnej.

## Zgodność

- PrestaShop 8.0 do 9.x
- PHP 7.4 do 8.3
- MySQL 5.7+ lub MariaDB 10.3+
- Pojedynczy sklep i multisklep
- Motyw Classic, Hummingbird i motywy własne
- Interfejs i dane dostarczone po francusku, angielsku, hiszpańsku, niemiecku i włosku
- Żadnych zależności (ani Composera, ani frameworka), żadnego CDN

## Instalacja

1. W zapleczu otwórz **Moduły > Menedżer modułów**.
2. Kliknij **Załaduj moduł** i wybierz plik `datafireflygpsr.zip`.
3. Po instalacji kliknij **Konfiguruj**.

Przy instalacji moduł tworzy swoje tabele, rejestruje hooki (zasoby zaplecza i frontu, zakładka karty produktu, blok wyświetlania w sklepie), dodaje menu **Katalog > GPSR** i wgrywa dane przykładowe: cztery piktogramy (ostrzeżenie, wiek 0-3 lata, oznakowanie CE, produkt łatwopalny) i dwa przykładowe ostrzeżenia (ryzyko zadławienia, nadzór osoby dorosłej), przetłumaczone na pięć języków.

## Szybki start

1. Utwórz swoje **podmioty gospodarcze** (co najmniej producenta i, w razie potrzeby, osobę odpowiedzialną w UE) w **Katalog > GPSR > Podmioty**.
2. Sprawdź lub uzupełnij bibliotekę **piktogramów** i **ostrzeżeń**.
3. W konfiguracji modułu zdefiniuj ewentualnie **domyślnego** producenta i osobę odpowiedzialną w UE.
4. Otwórz kartę produktu, przejdź do zakładki **GPSR**, uzupełnij informacje, a następnie kliknij **Zapisz GPSR**.
5. Sprawdź wyświetlanie po stronie sklepu na karcie produktu.

## Konfiguracja modułu

- **Włącz wyświetlanie GPSR**: włącza lub wyłącza wyświetlanie informacji w sklepie.
- **Tryb wyświetlania**: _Dedykowana zakładka_ (zakładka „Bezpieczeństwo produktu” na karcie) lub _Blok inline_ (pod informacjami o produkcie).
- **Pokaż piktogramy**: pokazuje lub ukrywa siatkę piktogramów w sklepie.
- **Pokaż ostrzeżenia**: pokazuje lub ukrywa listę ostrzeżeń w sklepie.
- **Ukryj, gdy puste**: nie wyświetla żadnej ramki, gdy produkt nie ma uzupełnionych danych GPSR.
- **Domyślny producent** i **Domyślna osoba odpowiedzialna w UE**: podmioty stosowane automatycznie do produktów bez wartości specyficznej (zobacz „Wartości domyślne”).

## Zarządzanie podmiotami gospodarczymi

Podmioty gospodarcze zarządzane są jednorazowo i wykorzystywane w całym katalogu, z poziomu **Katalog > GPSR > Podmioty**. Dostępne są cztery **typy**:

- **Producent**: podmiot, który wytwarza produkt lub zleca jego wytworzenie pod swoją nazwą.
- **Importer**: podmiot, który wprowadza na rynek Unii produkt pochodzący z kraju trzeciego.
- **Pełnomocnik**: osoba upoważniona przez producenta do działania w jego imieniu w UE.
- **Osoba odpowiedzialna w UE**: osoba odpowiedzialna z siedzibą w Unii, wymagana, gdy producent ma siedzibę poza UE.

Każdy podmiot ma swoją nazwę, pełny adres, kraj, e-mail, telefon, stronę internetową i numer VAT.

Popraw adres tylko raz na podmiocie: zmiana propaguje się natychmiast na wszystkie produkty, które go używają, bez ponownego wpisywania produkt po produkcie.

## Zarządzanie piktogramami

Z poziomu **Katalog > GPSR > Piktogramy** twórz, edytuj lub usuwaj piktogramy bezpieczeństwa. Każdy piktogram ma kod, obraz (SVG lub PNG, przesyłany w module), pozycję wyświetlania oraz, dla każdego języka, nazwę i podpis.

- Cztery piktogramy są dostarczone w zestawie: ostrzeżenie ogólne, przedział wiekowy 0-3 lata, oznakowanie CE, produkt łatwopalny.
- Możesz tworzyć ich tyle, ile potrzeba, i przesyłać własne grafiki.

Pozostajesz odpowiedzialny za dobór piktogramów odpowiednich dla każdego produktu według obowiązujących przepisów.

## Zarządzanie ostrzeżeniami

Z poziomu **Katalog > GPSR > Ostrzeżenia** zarządzaj biblioteką ostrzeżeń bezpieczeństwa. Każde ostrzeżenie ma kod, pozycję oraz, dla każdego języka, swój tekst.

- Dwa przykładowe ostrzeżenia są dostarczone: ryzyko zadławienia (małe elementy) i użytkowanie pod nadzorem osoby dorosłej.
- Teksty są przetłumaczone na pięć języków i personalizowalne.

## Uzupełnianie danych GPSR produktu

Otwórz kartę produktu w zapleczu: dodana jest zakładka **GPSR**. Znajdziesz w niej:

- wybór **producenta** i **osoby odpowiedzialnej w UE** spośród Twoich podmiotów;
- pola **GTIN** i **numer partii**;
- obowiązujące **ostrzeżenia** (pola wyboru);
- siatkę wybieralnych **piktogramów**;
- strefę **dodatkowej informacji o bezpieczeństwie** jako wolny tekst, wielojęzyczną.

Kliknij **Zapisz GPSR**, aby zapisać.

Zapis danych GPSR odbywa się przez **dedykowany kontroler AJAX**, niezależny od formularza produktu Symfony. To świadomy wybór architektoniczny: gwarantuje identyczne i niezawodne zachowanie na PrestaShop 8 i 9, których strony produktu głęboko się różnią. Przycisk „Zapisz GPSR” jest więc odrębny od przycisku „Zapisz” karty produktu.

## Wartości domyślne i automatyczny fallback

Jeśli większość Twoich produktów dzieli tego samego producenta lub tę samą osobę odpowiedzialną w UE, zdefiniuj ich raz w konfiguracji modułu jako **wartości domyślne**. Każdy produkt bez wskazanego producenta lub osoby odpowiedzialnej odziedziczy te wartości automatycznie przy wyświetlaniu w sklepie. Ręcznie uzupełniasz tylko wyjątki.

## Wyświetlanie po stronie klienta

Zależnie od wybranego trybu informacje GPSR wyświetlają się:

- w **dedykowanej zakładce** karty produktu, przez hook `displayProductExtraContent`;
- albo jako **blok inline** pod informacjami o produkcie, przez hook `displayProductAdditionalInfo`.

Blok prezentuje producenta, osobę odpowiedzialną w UE, ostrzeżenia, piktogramy (z podpisami), informację dodatkową oraz, jeśli uzupełnione, GTIN i numer partii. Opcja **Ukryj, gdy puste** zapobiega pustym ramkom na produktach bez danych.

## Pulpit pokrycia

Menu **Katalog > GPSR** otwiera pulpit, który pokazuje udział katalogu z uzupełnionymi danymi GPSR: liczbę pokrytych produktów, liczbę podmiotów, piktogramów i ostrzeżeń. Pomaga wskazać produkty pozostałe do uzupełnienia.

## Wielojęzyczność

Ostrzeżenia, podpisy piktogramów i informacja dodatkowa są tłumaczalne na francuski, angielski, hiszpański, niemiecki i włoski. Wyświetlanie automatycznie podąża za aktywnym językiem klienta, czego wymaga rozporządzenie nakazujące informacje o bezpieczeństwie w języku kraju sprzedaży. Etykiety interfejsu tłumaczy się przez **Zaawansowane > Tłumaczenia > Tłumaczenia zainstalowanych modułów**, wybierając `datafireflygpsr`.

## Zgodność z PrestaShop 9

Moduł jest zaprojektowany i testowany od PrestaShop 8.0 do 9.x:

- kontrolery zaplecza używają `ModuleAdminController`, zgodnego z 8 i 9;
- zapis danych produktu odbywa się przez dedykowany kontroler AJAX, a nie przez formularz produktu Symfony;
- kontroler AJAX zwraca bezpośrednio JSON, bez niezgodnego override sygnatury.

## FAQ i rozwiązywanie problemów

### Zakładka GPSR nie pokazuje moich podmiotów

Sprawdź, czy utworzyłeś co najmniej jeden podmiot w **Katalog > GPSR > Podmioty** i czy jest aktywny. Listy rozwijane karty produktu pokazują wyłącznie aktywne podmioty.

### Informacje nie wyświetlają się w sklepie

Upewnij się, że wyświetlanie GPSR jest włączone w konfiguracji, że produkt ma uzupełnione dane (albo że zdefiniowano domyślnego producenta lub osobę odpowiedzialną), a następnie wyczyść cache PrestaShop. Jeśli opcja **Ukryj, gdy puste** jest aktywna, produkt bez danych celowo niczego nie wyświetla.

### Kliknięcie „Zapisz GPSR” nie zapisuje

Przycisk „Zapisz GPSR” jest odrębny od przycisku „Zapisz” karty produktu i wyzwala dedykowane żądanie AJAX. Wyczyść cache, przeładuj stronę produktu i sprawdź w konsoli przeglądarki, czy żadne rozszerzenie nie blokuje żądania.

### Jak dodać własny piktogram?

W **Katalog > GPSR > Piktogramy** utwórz piktogram, prześlij swój obraz (SVG lub PNG) i uzupełnij jego nazwę i podpis dla każdego języka.

### Czy moduł jest zgodny z PrestaShop 9?

Tak. Moduł jest zaprojektowany i testowany od PrestaShop 8.0 do 9.x, w pojedynczym sklepie i w multisklepie.

## Odinstalowanie

Odinstalowanie usuwa tabele modułu, jego zakładki administracyjne i wyrejestrowuje hooki. Podmioty, piktogramy, ostrzeżenia i powiązania produktów zostają skasowane. Jeśli planujesz ponowną instalację, zachowaj wcześniej kopię zapasową bazy danych.
