# dfbulkcategory — Masowe przypisywanie kategorii

> Prezentacja dfbulkcategory dodaje dwie akcje grupowe do listy produktów w back-office PrestaShop: Dodaj do kategorii i Usuń z kategorii. Zaznacz produkty natywnymi checkboxami, wybierz jedną lub kilka kategorii w oknie…

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

## Prezentacja

dfbulkcategory dodaje dwie akcje grupowe do listy produktów w back-office PrestaShop: **Dodaj do kategorii** i **Usuń z kategorii**. Zaznacz produkty natywnymi checkboxami, wybierz jedną lub kilka kategorii w oknie modalnym z drzewem i wyszukiwarką, potwierdź — operacja wykonuje się w AJAX bez przeładowania strony.

Moduł jest kompatybilny z **PrestaShop 8.0.0 do 9.99.99** i działa w multistore. Nie tworzy żadnej tabeli SQL i nie modyfikuje żadnego pliku core.

## Instalacja

1. Pobierz plik ZIP modułu ze swojego konta DataFirefly.
2. W back-office PrestaShop przejdź do **Moduły → Menedżer modułów → Zainstaluj moduł**.
3. Przeciągnij plik `dfbulkcategory.zip` i zatwierdź.
4. Moduł jest gotowy od razu: żadna konfiguracja nie jest wymagana.

Przy instalacji moduł rejestruje ukrytą zakładkę administracyjną wymaganą przez kontrole dostępu PrestaShop 9. Do menu back-office nie jest dodawany żaden widoczny wpis.

### Aktualizacja z wersji 1.0.0

Po prostu podmień moduł na nową wersję przez **Zainstaluj moduł** (lub przycisk Aktualizuj). Skrypt upgrade'u wykonuje się automatycznie i instaluje zakładkę administracyjną wymaganą przez PrestaShop 9 na istniejących instalacjach. Żadna ręczna akcja nie jest potrzebna.

## Użytkowanie

### Dodawanie produktów do kategorii

1. Otwórz **Katalog → Produkty**.
2. Zaznacz produkty do zmiany (checkbox w nagłówku zaznacza całą stronę).
3. Otwórz menu **Akcje grupowe** i kliknij **Dodaj do kategorii**.
4. W oknie modalnym zaznacz jedną lub kilka kategorii w drzewie, potem kliknij **Zastosuj**.

Zaznaczone kategorie są dodawane do istniejących kategorii każdego produktu — nic nie jest nadpisywane.

### Usuwanie produktów z kategorii

Ta sama zasada z zakładką **Usuń z kategorii** w oknie modalnym. Zaznaczone kategorie są usuwane z każdego wybranego produktu.

Domyślna kategoria produktu nigdy nie jest usuwana: jeśli znajduje się wśród kategorii do usunięcia, moduł automatycznie ją zachowuje, aby produkt zawsze miał kategorię główną.

### Tryb łączony (dodawanie i usuwanie w jednej operacji)

Zakładka **Oba** wyświetla dwa panele obok siebie: po lewej kategorie do dodania, po prawej te do usunięcia. To idealny tryb do przenoszenia produktów z jednej kategorii do drugiej w jednym potwierdzeniu.

### Wyszukiwanie i nawigacja w drzewie

Pole wyszukiwania filtruje drzewo w czasie rzeczywistym i automatycznie rozwija gałęzie zawierające wyniki. Przyciski **Rozwiń wszystko** i **Zwiń wszystko** pozwalają szybko poruszać się po dużych strukturach.

### Kategorie wyłączone

Domyślnie wyświetlane są tylko aktywne kategorie. Włącz przełącznik **Pokaż wyłączone kategorie** u góry okna, aby je uwzględnić — przydatne podczas restrukturyzacji katalogu. Wyłączone kategorie są oznaczone plakietką.

## Multistore

Każda operacja wykonuje się w kontekście sklepu aktywnego w back-office:

- Wyświetlane drzewo kategorii należy do bieżącego sklepu.
- Moduł sprawdza, czy każdy wybrany produkt faktycznie należy do tego sklepu przed modyfikacją.
- Powiązania kategorii innych sklepów nie są naruszane.

W kontekście „Wszystkie sklepy” najpierw wybierz konkretny sklep w selektorze multistore, aby poprawnie zaadresować powiązania.

## Kompatybilność z PrestaShop 9

Od wersji 1.1.0 moduł jest w pełni kompatybilny z PrestaShop 9:

- Adresy URL AJAX są generowane po stronie serwera zgodnie z mechanizmem oczekiwanym przez PrestaShop 9 (z tokenem).
- Ukryta zakładka administracyjna jest rejestrowana, aby spełnić wzmocnione kontrole dostępu — pracownicy niebędący superadministratorami mogą używać modułu, o ile mają dostęp do katalogu.
- Działanie na PrestaShop 8.0, 8.1 i 8.2 pozostaje bez zmian.

## Rozwiązywanie problemów

### Przyciski nie pojawiają się w menu Akcje grupowe

Wyczyść cache PrestaShop (**Zaawansowane → Wydajność → Wyczyść cache**) i przeładuj stronę produktów przez Ctrl+F5. Sprawdź też, czy moduł jest zainstalowany i aktywny w Menedżerze modułów.

### Błąd „Odmowa dostępu” przy zastosowaniu

Na PrestaShop 9 ten błąd zwykle oznacza brak zakładki administracyjnej modułu (instalacja sprzed 1.1.0). Przeinstaluj moduł lub zastosuj aktualizację: skrypt upgrade'u automatycznie odtworzy zakładkę.

### Produkt nie został zmodyfikowany

Komunikat wyniku wyszczególnia pominięte produkty. Typowe przyczyny: produkt nie jest powiązany z aktywnym sklepem (multistore) albo został usunięty między zaznaczeniem a potwierdzeniem.

## Changelog

### 1.1.0 — 2 lipca 2026

- Kompatybilność z PrestaShop 9 (obsługiwany zakres: 8.0.0 — 9.99.99)
- Adresy URL AJAX generowane po stronie serwera (zgodne z PS9)
- Ukryta zakładka administracyjna rejestrowana przy instalacji dla kontroli dostępu PrestaShop 9
- Automatyczny skrypt aktualizacji dla istniejących instalacji 1.0.0
- Etykiety kategorii systematycznie filtrowane per sklep
- Bezpieczne wyświetlanie komunikatów błędów w oknie modalnym

### 1.0.0 — 11 lutego 2026

- Pierwsza wersja publiczna
- Akcje grupowe Dodaj / Usuń na liście produktów
- Okno modalne z drzewem kategorii, wyszukiwaniem w czasie rzeczywistym, trybem łączonym
- Opcja wyłączonych kategorii, obsługa multistore, zachowanie kategorii domyślnej
