# DataFirefly Fix Product Category: przypisywanie produktów do kategorii nadrzędnych

> Instalacja Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, wysyłając plik ZIP, albo skopiuj folder dffixproductcategory do katalogu /modules/ sklepu i kliknij Zainstaluj. Instalacja dodaje zakładkę Korekta kategorii…

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

## Instalacja

Zainstaluj moduł w **Moduły > Menedżer modułów > Załaduj moduł**, wysyłając plik ZIP, albo skopiuj folder `dffixproductcategory` do katalogu `/modules/` sklepu i kliknij Zainstaluj.

Instalacja dodaje zakładkę **Korekta kategorii produktów** w menu Katalog i rejestruje hooki trybu automatycznego. Moduł nie tworzy żadnej tabeli: zapisuje tylko do natywnej tabeli `category_product`.

Korekta masowa dodaje powiązania w całym katalogu. Przed pierwszą korektą wykonaj kopię zapasową tabeli `category_product`, aby móc cofnąć zmiany, jeśli wynik nie pasuje do organizacji katalogu.

## Zasada działania

Dla każdej kategorii produktu moduł przechodzi drzewo aż do samej góry i dodaje kategorie nadrzędne, do których produkt nie jest jeszcze przypisany. Uwzględniane są wszystkie kategorie produktu, a nie tylko kategoria domyślna.

Przykład: produkt przypisany tylko do _Buty > Bieganie > Trail_ zostaje dodany do _Bieganie_ i do _Buty_. Kategoria Root nigdy nie jest dodawana, a kategoria Strona główna tylko wtedy, gdy włączona jest odpowiednia opcja.

- Żadne istniejące powiązanie nie jest usuwane.
- Kategoria domyślna produktu nigdy się nie zmienia: ścieżka nawigacji i adres URL produktu pozostają takie same.
- Produkt trafia na ostatnią pozycję w każdej dodanej kategorii, co zachowuje ręczne sortowanie.
- Drzewo jest odczytywane na podstawie rodzica każdej kategorii, więc wynik jest poprawny nawet wtedy, gdy drzewo zagnieżdżone PrestaShop nie zostało zregenerowane.

## Korekta masowa

Otwórz **Katalog > Korekta kategorii produktów**. Panel Korekta masowa przetwarza cały katalog partiami, z paskiem postępu.

### Symuluj

Kliknij **Symuluj**. Nic nie jest zapisywane. Liczniki pokazują liczbę produktów w zakresie, produkty do poprawy i brakujące powiązania. Tabela podglądu wyświetla pierwsze 100 produktów z kategoriami, które zostaną im dodane.

### Popraw katalog

Kliknij **Popraw katalog** i potwierdź. Partie są przetwarzane do końca katalogu, a licznik Dodane powiązania pokazuje wynik. Korektę można uruchomić ponownie w dowolnym momencie: produkty już poprawione nie są zmieniane.

### Tylko aktywne produkty

Zaznacz to pole, aby ograniczyć symulację i korektę do aktywnych produktów bieżącego sklepu. Domyślnie przetwarzane są wszystkie produkty, także wyłączone, aby były poprawnie przypisane w dniu ich ponownego włączenia.

## Ustawienia

### Uwzględnij kategorię Strona główna

Domyślnie wyłączone. Po włączeniu kategoria Strona główna jest dodawana jak każda inna kategoria nadrzędna. W multisklepie każdy sklep ma własną kategorię Strona główna i ustawienie dotyczy każdej z nich.

### Tryb automatyczny przy zapisie produktu

Domyślnie włączony. Każdy utworzony lub zmodyfikowany produkt jest przypisywany do swoich kategorii nadrzędnych. Przetwarzanie odbywa się na końcu żądania, po zapisaniu kategorii produktu, co obejmuje kartę produktu PrestaShop 8 i 9, import CSV i webservice.

### Tryb automatyczny przy przeniesieniu kategorii

Domyślnie włączony. Gdy zmienisz rodzica kategorii, wszystkie produkty z jej gałęzi zostaną przypisane do nowych kategorii nadrzędnych. Zmiana nazwy lub opisu niczego nie uruchamia. Dotychczasowe kategorie nadrzędne pozostają przypisane do produktów: w razie potrzeby usuń je ręcznie.

### Wykluczone kategorie

Wybierz kategorie, które nigdy nie mogą być dodawane jako nadrzędne, na przykład kategorię witryny Promocje lub Nowości. Pole filtra wyszukuje kategorię po nazwie, a Ctrl (Cmd na Macu) pozwala zaznaczyć kilka. Wykluczona kategoria jest pomijana, ale jej własne kategorie nadrzędne są nadal dodawane.

### Rozmiar partii

Liczba produktów przetwarzanych na żądanie podczas korekty masowej, od 20 do 2000. Wartość domyślna, 200, pasuje do większości hostingów. Zmniejsz ją, jeśli żądanie przekracza maksymalny czas wykonania na serwerze.

## Nawigacja fasetowa

Po każdym dodaniu powiązań moduł czyści cache bloków filtrów `ps_facetedsearch`, aby filtry kategorii nadrzędnych uwzględniały nowe produkty. Ponieważ powiązania istnieją w bazie danych, opcja wyświetlania produktów z podkategorii w module nawigacji fasetowej nie jest potrzebna.

## Dobre praktyki

- Przed pierwszą korektą uruchom symulację i przejrzyj podgląd, aby zatwierdzić wynik.
- Ustaw wykluczenia przed korektą masową, a nie po niej: moduł nigdy nie usuwa utworzonego powiązania.
- Po dużym imporcie ponownie uruchom korektę masową, aby sprawdzić, czy żaden produkt nie został pominięty.
- Wyczyść cache sklepu, jeśli lista nie pokazuje od razu nowych produktów.

## Rozwiązywanie problemów

### Tryb automatyczny nie działa dla niektórych pracowników

PrestaShop pomija hooki modułu, gdy profil zalogowanego pracownika nie ma uprawnienia **Wyświetl** dla tego modułu (**Zaawansowane > Zespół > Uprawnienia**, sekcja Moduły). Nadaj to uprawnienie profilom edytującym katalog albo uruchom korektę masową po ich zmianach.

### Kategoria usunięta z produktu wraca po zapisie

To oczekiwane działanie trybu automatycznego: każda kategoria nadrzędna kategorii produktu jest dodawana ponownie. Dodaj tę kategorię do wykluczeń albo usuń z produktu także odpowiednią podkategorię.

### Korekta masowa zatrzymuje się z błędem

Zmniejsz rozmiar partii i uruchom ponownie: produkty już przetworzone są pomijane w kolejnym przebiegu. Błędy trybu automatycznego są zapisywane w **Zaawansowane > Logi** i nigdy nie blokują zapisu produktu.

## Zgodność

- PrestaShop od 8.0 do 9.x, ten sam plik ZIP obsługuje obie gałęzie.
- Multisklep i wielojęzyczność.
- Architektura ModuleAdminController, bez zależności Composer.
- Interfejs w języku francuskim, angielskim, hiszpańskim, niemieckim, włoskim, niderlandzkim, polskim i portugalskim.
