DataFirefly Specific Price Cleaner: czyszczenie wygasłych, zduplikowanych i osieroconych cen specjalnych
Instalacja, panel, kreator w 6 krokach, kategorie i ochrony, historia i przywracanie, harmonogram, ustawienia i rozwiązywanie problemów.
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 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.

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.

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.

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.

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ć.

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.

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.

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.

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


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.


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.

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.

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

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.