# DataFirefly Specific Price Cleaner: czyszczenie wygasłych, zduplikowanych i osieroconych cen specjalnych

> Instalacja Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, wysyłając plik ZIP. Podczas instalacji moduł tworzy swoje tabele i dodaje zakładkę Katalog > Czyszczenie cen specjalnych. Instalacja nie…

- Strona: <https://www.datafirefly.com/pl/documentation/dfspecificpricecleaner/>
- Język: pl
- Zaktualizowano: 2026-11-16
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfspecificpricecleaner/index.md), [en](https://www.datafirefly.com/en/documentation/dfspecificpricecleaner/index.md), [es](https://www.datafirefly.com/es/documentation/dfspecificpricecleaner/index.md), [de](https://www.datafirefly.com/de/documentation/dfspecificpricecleaner/index.md), [it](https://www.datafirefly.com/it/documentation/dfspecificpricecleaner/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfspecificpricecleaner/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfspecificpricecleaner/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. Podczas instalacji moduł tworzy swoje tabele i dodaje zakładkę **Katalog > Czyszczenie cen specjalnych**. Instalacja nie zmienia żadnej ceny.

Aby zaktualizować z wersji 1.0.x, wystarczy wgrać nowy plik ZIP. Historia i kopie z 1.0.x zostają zachowane, podobnie jak ustawienia zadania cron (włączenie, tryb, częstotliwość). Po aktualizacji otwórz zakładkę **Harmonogram** i sprawdź, czy ci odpowiadają.

## Panel

Strona **Stan** analizuje tabelę cen specjalnych dla całego katalogu lub wybranego zakresu (sklep, kategoria, ID produktów). Pokazuje:

- liczbę cen specjalnych, w tym cen aktywnych w tej chwili;
- liczbę wierszy, które można bezpiecznie wyczyścić domyślnym czyszczeniem (wygasłe, duplikaty, osierocone);
- to, czego domyślnie nigdy się nie usuwa: ceny powiązane z aktywnym koszykiem, reguły cen katalogowych, ceny przyszłe, ceny bez daty końcowej, ceny używane przez inny moduł;
- szczegóły według kategorii problemu, z wierszami do usunięcia i chronionymi w każdej z nich;
- konflikty priorytetów i wygasłe reguły cen katalogowych do ręcznego przeglądu;
- aktualny rozmiar tabeli zmierzony przez bazę danych.

![Panel stanu cen specjalnych: wiersze do wyczyszczenia, kategorie problemów i ochrony](https://www.datafirefly.com/wp-content/uploads/2026/11/panel-stanu-cen-specjalnych-dfspecificpricecleaner-pl.webp)

Panel pokazuje, o ile wierszy mniej będzie miała tabela po czyszczeniu. Wpływ na szybkość stron zależy od sklepu: moduł go nie mierzy.

## Kreator czyszczenia w 6 krokach

Kliknij **Uruchom kreator czyszczenia**. Kroki to: Wybierz, Symuluj, Sprawdź, Kopia, Wyczyść, Raport. Przed krokiem Wyczyść nic nie jest usuwane.

### 1. Wybierz

Zaznacz kategorie do wyczyszczenia. Każdy licznik pokazuje wiersze, które zostałyby usunięte przy aktywnych ochronach. Ustaw termin dla cen wygasłych (np. wygasłe od co najmniej 7 dni) i dla zakończonych koszyków. **Ochrony** są domyślnie zaznaczone; odznacz którąś tylko wtedy, gdy dokładnie wiesz, dlaczego wiersz musi zniknąć. **Filtry zaawansowane** ograniczają czyszczenie do sklepu, kategorii, ID produktów, klienta, grupy, kraju, waluty, rodzaju wartości lub daty wygaśnięcia.

![Kreator czyszczenia, krok 1: wybór kategorii, ochron i filtrów zaawansowanych](https://www.datafirefly.com/wp-content/uploads/2026/11/kreator-czyszczenia-wybor-kategorii-dfspecificpricecleaner-pl.webp)

### 2. Symuluj

**Uruchom symulację** oblicza plan bez usuwania czegokolwiek: wiersze zaplanowane i chronione według kategorii. Plan jest zamrożony: usunąć można tylko te wiersze. Wiersz pasujący do kilku kategorii jest planowany raz, w pierwszej z nich. Plan możesz wyeksportować do CSV.

![Wynik symulacji: zaplanowane i chronione wiersze według kategorii, nic nie usunięto](https://www.datafirefly.com/wp-content/uploads/2026/11/symulacja-czyszczenia-cen-specjalnych-dfspecificpricecleaner-pl.webp)

### 3. Sprawdź

Lista zaplanowanych wierszy pokazuje dla każdego produkt, cel, wartość, okres i przydatne sygnały. Odznacz wiersz, aby go zachować: wykluczone wiersze nigdy nie są usuwane.

![Sprawdzenie zamrożonego planu wiersz po wierszu, każdy wiersz można wykluczyć](https://www.datafirefly.com/wp-content/uploads/2026/11/sprawdzenie-wierszy-przed-usunieciem-dfspecificpricecleaner-pl.webp)

### 4. Kopia

**Utwórz kopię** kopiuje każdy zaplanowany wiersz, kolumna po kolumnie, do historii modułu. Przed kontynuowaniem możesz pobrać tę kopię jako CSV. Jeśli kopia jest wyłączona w ustawieniach, moduł wyraźnie o tym informuje: usunięcie będzie ostateczne.

![Pełna kopia zaplanowanych wierszy przed usunięciem, do pobrania w CSV](https://www.datafirefly.com/wp-content/uploads/2026/11/kopia-zapasowa-przed-czyszczeniem-dfspecificpricecleaner-pl.webp)

### 5. Wyczyść

Zaznacz **Sprawdziłem symulację i chcę usunąć te N wierszy.**, a następnie kliknij **Usuń N wierszy**. Bez kopii trzeba dodatkowo wpisać liczbę wierszy. Usuwanie przebiega partiami, każda we własnej transakcji, a każdy wiersz jest ponownie sprawdzany tuż przed usunięciem: wiersz, który od czasu symulacji został powiązany z koszykiem, odtworzony przez regułę lub użyty przez moduł, jest pomijany. Możesz wstrzymać i wznowić.

![Wyraźne potwierdzenie przed czyszczeniem w partiach transakcyjnych ze wznawianiem](https://www.datafirefly.com/wp-content/uploads/2026/11/wyrazne-potwierdzenie-czyszczenia-dfspecificpricecleaner-pl.webp)

### 6. Raport

Raport podaje według kategorii wiersze zaplanowane, usunięte, pominięte, wykluczone i chronione oraz czas trwania. Pokazuje też, co zrobiono po czyszczeniu: wyczyszczona pamięć podręczna cen PrestaShop i zaktualizowany indeks cen wyszukiwania fasetowego dla odpowiednich produktów. Z raportu możesz przywrócić dane, pobrać kopię lub szczegółowy raport w CSV albo wysłać sobie raport e-mailem.

![Raport czyszczenia według kategorii, wyczyszczona pamięć cen i przywracanie jednym kliknięciem](https://www.datafirefly.com/wp-content/uploads/2026/11/raport-czyszczenia-cen-specjalnych-dfspecificpricecleaner-pl.webp)

Jeśli karta zostanie zamknięta lub serwer przerwie pracę w trakcie czyszczenia, nic nie zostaje zrobione do połowy. Panel pokazuje niedokończone czyszczenie z przyciskiem **Otwórz i wznów**; możesz też porzucić resztę.

## Kategorie czyszczenia

- **Wygasłe ceny**: data końcowa minęła, te ceny nie dotyczą już nikogo.
- **Dokładne duplikaty**: ten sam produkt, cel, daty, ilość i wartość co starszy wiersz; zachowywany jest najstarszy. Unikalny indeks PrestaShop zwykle im zapobiega: sprawdzenie pozostaje przydatne dla danych importowanych.
- **Osierocone**: usunięty produkt (lub brak w sklepie ceny), kombinacja, klient, grupa klientów, kraj, waluta, sklep lub grupa sklepów.
- **Ceny bez efektu**: „zachowaj cenę bazową” bez rabatu. Te, które mogą anulować inny rabat, są chronione.
- **Ceny zakończonych koszyków**: ceny utworzone dla koszyka (oferta, negocjacje, prezent...), który został zamówiony lub nie był zmieniany przez wybrany czas, albo usunięty.
- **Priorytety usuniętych produktów** i **priorytety identyczne z globalnym**.
- **Wybór ręczny**: wiersze wybrane na liście cen.

## Ochrony

- **Wygenerowana przez regułę cen katalogowych**: PrestaShop odtwarza ją z reguły. Zawsze chroniona: zmień lub usuń regułę.
- **Powiązana z koszykiem**: utworzona dla koszyka klienta przez moduł ofert, B2B, konfiguratora lub prezentów. Usunąć ją może tylko kategoria Zakończone koszyki.
- **Zaczyna się w przyszłości**: zaplanowane promocje.
- **Bez daty końcowej (bezterminowa)**: domyślnie zachowywane, nawet jeśli wydają się niepotrzebne.
- **Używana przez inny moduł**: moduł wciąż wskazuje cenę we własnych tabelach. Panel wymienia wykryte moduły.
- **Może anulować inny rabat**: cena bez efektu może wygrać z rabatem grupowym lub globalnym i anulować go dla swojego celu.

## Lista cen

Zakładka **Ceny specjalne** pokazuje wszystkie ceny specjalne z tymi samymi filtrami co kreator oraz sygnałami dla cen powiązanych z koszykiem, utworzonych przez regułę lub używanych przez moduł zewnętrzny. Zaznacz wiersze, aby uruchomić symulację tylko dla tego wyboru.

![Lista cen specjalnych z filtrami zaawansowanymi i sygnałami koszyka, reguły i modułu](https://www.datafirefly.com/wp-content/uploads/2026/11/lista-cen-specjalnych-filtry-dfspecificpricecleaner-pl.webp)

## Historia i przywracanie

Zakładka **Historia i przywracanie** wymienia każde czyszczenie i każdą zaplanowaną symulację z autorem, raportem i kopią. Czyszczenia są przechowywane z kopią przez okres wybrany w ustawieniach (domyślnie 90 dni), a potem usuwane automatycznie.

![Historia czyszczeń i zaplanowanych symulacji, z kopiami i przywracaniem](https://www.datafirefly.com/wp-content/uploads/2026/11/historia-czyszczen-kopie-dfspecificpricecleaner-pl.webp)

**Przywróć** odtwarza wiersze z oryginalnym ID, a następnie porównuje każdy z kopią. Raport pokazuje potem liczbę przywróconych wierszy i datę.

![Przywracanie jednym kliknięciem: potwierdzenie przed przywróceniem wierszy z oryginalnym ID](https://www.datafirefly.com/wp-content/uploads/2026/11/przywracanie-jednym-kliknieciem-dfspecificpricecleaner-pl.webp)

![Przywracanie zakończone: wiersze przywrócone z ID i sprawdzone jako identyczne z kopią](https://www.datafirefly.com/wp-content/uploads/2026/11/przywracanie-sprawdzone-wiersz-po-wierszu-dfspecificpricecleaner-pl.webp)

## Harmonogram

Zakładka **Harmonogram** konfiguruje automatyczne czyszczenie wywoływane przez zadanie cron hostingu. Ochrony kreatora są zawsze aktywne.

- **Tryb**: _Tylko symulacja_ (raport, nic nie jest usuwane), zalecany na początek, lub _Czyszczenie_ z automatyczną kopią.
- **Częstotliwość**: co godzinę, dzień, tydzień lub miesiąc. Wywołania przed kolejnym terminem są ignorowane.
- **Kategorie**, termin dla cen wygasłych i zakończonych koszyków, ograniczenie do cen przypisanych klientowi lub do jednego sklepu.
- **Maksymalnie N wierszy na uruchomienie**: reszta zostanie przetworzona przy następnym.
- **Raport e-mail** po każdym uruchomieniu, na wybrany adres lub adres sklepu.

Skopiuj wyświetlony **adres URL cron** i wywołuj go z hostingu, na przykład co godzinę: moduł stosuje wybraną częstotliwość. Dodaj `&dry=1`, aby wymusić symulację. Zachowaj ten adres w tajemnicy: chroni go token, a w razie potrzeby możesz wygenerować nowy. Wywołanie z błędnym tokenem otrzymuje błąd 403; jeśli uruchomienie już trwa, wywołanie otrzymuje błąd 423.

![Harmonogram: symulacja lub czyszczenie przez cron, częstotliwość, kategorie i raport e-mail](https://www.datafirefly.com/wp-content/uploads/2026/11/harmonogram-czyszczenia-cron-dfspecificpricecleaner-pl.webp)

![Raport czyszczenia otrzymany e-mailem, szczegółowy według kategorii](https://www.datafirefly.com/wp-content/uploads/2026/11/raport-czyszczenia-e-mail-dfspecificpricecleaner-pl.webp)

## Ustawienia

- **Kopia zapasowa przed każdym usunięciem**: zdecydowanie zalecana, umożliwia przywracanie jednym kliknięciem.
- **Przechowywanie kopii** w dniach (0 = bezterminowo).
- **Profile uprawnione do czyszczenia i przywracania**, oprócz uprawnienia „Usuń” zakładki.
- **Zachowaj historię i kopie przy odinstalowaniu**.
- **Usuwaj przez obiekty PrestaShop**: domyślnie tak, aby uruchamiały się hooki usuwania (moduły ERP, feedów i synchronizacji pozostają poinformowane). Nie: bezpośrednio przez SQL, szybciej przy bardzo dużych wolumenach.
- **Wierszy na partię** (domyślnie 500): każda partia to jedna transakcja. Zmniejsz wartość, jeśli serwer przerywa długie żądania.
- **Odśwież indeks cen wyszukiwania fasetowego** dla odpowiednich produktów (do 300).
- **Wyczyść teraz starą historię**: usuwa czyszczenia starsze niż okres przechowywania oraz nigdy nieuruchomione symulacje.

![Ustawienia: kopia zapasowa, przechowywanie, uprawnione profile i przetwarzanie w partiach](https://www.datafirefly.com/wp-content/uploads/2026/11/ustawienia-bezpieczenstwa-kopii-dfspecificpricecleaner-pl.webp)

## Bloki na karcie produktu i klienta

Na karcie produktu blok **Stan cen specjalnych** pokazuje liczbę cen produktu, te, które można wyczyścić, oraz stan każdej z nich (aktywna, wygasła, przyszła, koszyk, reguła, moduł). Przycisk **Symuluj czyszczenie tego produktu** otwiera już przefiltrowany kreator.

![Blok na karcie produktu: stan cen specjalnych produktu i bezpośrednia symulacja](https://www.datafirefly.com/wp-content/uploads/2026/11/blok-karty-produktu-ceny-dfspecificpricecleaner-pl.webp)

Na karcie klienta blok wymienia ceny przypisane klientowi i powiązane koszyki, z czyszczeniem ukierunkowanym na tego klienta.

![Blok na karcie klienta: ceny dla klienta, powiązane koszyki i ukierunkowane czyszczenie](https://www.datafirefly.com/wp-content/uploads/2026/11/blok-karty-klienta-ceny-dfspecificpricecleaner-pl.webp)

## Uprawnienia pracowników

Przeglądanie modułu wymaga uprawnienia „Wyświetl” zakładki. Czyszczenie i przywracanie wymagają uprawnienia „Usuń” zakładki w **Zaawansowane > Zespół > Uprawnienia** oraz zaznaczenia profilu w ustawieniach modułu. Profil SuperAdmin jest zawsze uprawniony. Profil bez tych praw widzi strony tylko do odczytu.

## Dla twórców modułów

Tuż przed usunięciem partii moduł wywołuje hook `actionDfSpecificPriceCleanerBeforeDelete` z ID czyszczenia i listą ID cen. Moduł może dodać do tablicy `veto` ID cen, które chce zachować: te wiersze są wtedy pomijane i pozostają na miejscu.

## Rozwiązywanie problemów

### Niektóre wiersze są „pomijane” podczas czyszczenia

Zmieniły się od czasu symulacji: zostały powiązane z koszykiem, odtworzone przez regułę lub użyte przez moduł. Tak ma być. Uruchom nową symulację, aby je ponownie przejrzeć.

### Symulacja nie planuje żadnego wiersza

Wszystkie pasujące wiersze są chronione albo żaden nie pasuje do filtrów. Licznik „chronione” każdej kategorii pokazuje, co jest zachowywane i dlaczego.

### Czyszczenie zatrzymuje się przy dużym wolumenie

Zmniejsz **Wierszy na partię** w ustawieniach, a następnie wznów czyszczenie z panelu. Partie już przetworzone nie są powtarzane.

### Adres cron odpowiada 403, 423 lub SKIPPED

403: błędny token, skopiuj ponownie adres z zakładki Harmonogram. 423: uruchomienie wciąż trwa. SKIPPED: harmonogram wyłączony, termin jeszcze nie nadszedł lub nie wybrano żadnej kategorii.

### Raport zaleca przebudowę indeksu

Powyżej 300 produktów moduł sam nie aktualizuje indeksu cen wyszukiwania fasetowego. Przebuduj indeks w konfiguracji modułu wyszukiwania fasetowego.

## Ograniczenia

- Konflikty priorytetów i wygasłe reguły katalogowe są zgłaszane, nigdy nie są usuwane automatycznie.
- Raport e-mail jest wysyłany w języku pracownika (przycisk w raporcie) lub w domyślnym języku sklepu (cron).
- Bez kopii zapasowej usunięcia nie można cofnąć.

## Zgodność

- PrestaShop od 1.7.8 do 9.x z tym samym plikiem ZIP. Testowano na 1.7.8.11, 8.2.1 i 9.1.5, z PHP 7.4, 8.1 i 8.5.
- Multisklep: analizę i czyszczenie można ograniczyć do jednego sklepu.
- Architektura ModuleAdminController, bez zależności Composer.
- Interfejs przetłumaczony na francuski, angielski, hiszpański, niemiecki, włoski, niderlandzki, polski i portugalski.
