# Przycisk Wyczyść koszyk: kompletny przewodnik

> Prezentacja Moduł Przycisk Wyczyść koszyk (dfclearcart) dodaje na stronie koszyka Twojego sklepu przycisk „Wyczyść koszyk”, który jednym kliknięciem usuwa całą zawartość koszyka: wszystkie produkty, ich warianty i personalizacje, a także…

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

## Prezentacja

Moduł **Przycisk Wyczyść koszyk** (`dfclearcart`) dodaje na stronie koszyka Twojego sklepu przycisk **„Wyczyść koszyk”**, który jednym kliknięciem usuwa całą zawartość koszyka: wszystkie produkty, ich warianty i personalizacje, a także zastosowane bony rabatowe. Moduł jest w pełni samodzielny: brak zależności Composer, brak dodanej tabeli SQL.

Przycisk jest wstrzykiwany w JavaScripcie przez hook zawsze obecny, a następnie umieszczany w bloku koszyka. Wyświetla się więc nawet na szablonach niestandardowych, które nie uruchamiają zwykłych hooków wyświetlania strony koszyka.

## Zgodność

- PrestaShop 8.0 do 9.x
- Pojedynczy sklep i multisklep
- 5 języków: FR, EN, ES, DE, IT
- Szablon Classic i szablony niestandardowe
- Brak zależności (ani Composer, ani frameworka)

## Instalacja

1. W panelu administracyjnym otwórz **Moduły > Menedżer modułów**.
2. Kliknij **Wgraj moduł** i wskaż plik `dfclearcart.zip`.
3. Po instalacji kliknij **Konfiguruj**.

Podczas instalacji moduł rejestruje swoje hooki (ładowanie zasobów we front-office i przycisk na stronie koszyka) i tworzy ustawienia domyślne: przycisk włączony, potwierdzenie włączone, etykiety w pięciu językach.

## Konfiguracja

- **Włącz przycisk**: pokazuje lub ukrywa przycisk „Wyczyść koszyk” na stronie koszyka.
- **Wymagaj potwierdzenia**: wyświetla okno potwierdzenia przed opróżnieniem, aby uniknąć przypadkowych kliknięć.
- **Etykieta przycisku**: tekst wyświetlany na przycisku, konfigurowalny i tłumaczalny w każdym języku.
- **Komunikat potwierdzenia**: treść prośby o potwierdzenie, konfigurowalna i tłumaczalna w każdym języku.

Etykiety są polami wielojęzycznymi: wybierz każdy język w przełączniku pola, aby dostosować tekst. Wartości domyślne są dostarczone w pięciu językach już przy instalacji.

## Działanie

### Co jest usuwane

Po kliknięciu (i po potwierdzeniu, jeśli jest włączone) moduł usuwa **wszystkie produkty** z koszyka, łącznie z ich wariantami i personalizacjami, a następnie zdejmuje **wszystkie bony rabatowe i reguły koszyka**. Koszyk wraca do stanu całkowicie pustego.

### Automatyczne przeładowanie

Po opróżnieniu koszyka strona koszyka jest przeładowywana automatycznie, aby pokazać pusty stan, bez żadnego działania ze strony klienta.

### Wstrzykiwanie niezależne od szablonu

Zasoby (skrypt i styl) są ładowane przez hook `actionFrontControllerSetMedia`, który jest zawsze wywoływany. Skrypt następnie odnajduje blok koszyka i wstawia w nim przycisk. To podejście gwarantuje wyświetlenie przycisku nawet wtedy, gdy szablon nie uruchamia klasycznych hooków wyświetlania strony koszyka.

Jeśli szablon uruchamia hook `displayShoppingCartFooter`, przycisk jest renderowany bezpośrednio w nim, a skrypt podpina się do niego bez tworzenia duplikatu.

### Bezpieczeństwo

Opróżnianie odbywa się przez żądanie AJAX chronione tokenem powiązanym z bieżącym koszykiem i dotyczy wyłącznie koszyka bieżącej sesji. Żadna inna sesja ani żaden inny koszyk nie jest naruszany.

## FAQ i rozwiązywanie problemów

### Przycisk nie pojawia się na stronie koszyka

Wyczyść pamięć podręczną PrestaShop (Ustawienia zaawansowane > Wydajność), a na czas testów wyłącz łączenie i kompresję plików (CCC) oraz wymuś ponowną kompilację szablonów. Następnie przeładuj stronę koszyka w oknie prywatnym. Przycisk wyświetla się tylko wtedy, gdy koszyk zawiera co najmniej jedną pozycję.

### Mój szablon niestandardowy nadal nie pokazuje przycisku

Przycisk jest wstawiany do pierwszego rozpoznanego kontenera koszyka. Jeśli Twój szablon używa bardzo specyficznej struktury, otwórz konsolę przeglądarki: jeśli obiekt `dfClearCart` jest zdefiniowany, zasoby są poprawnie załadowane i wystarczy dostosować selektor wstawiania do Twojego bloku koszyka.

### Koszyk opróżnia się dopiero po ręcznym odświeżeniu

Upewnij się, że używasz najnowszej wersji modułu: przeładowanie strony koszyka jest uruchamiane automatycznie po opróżnieniu.

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

Tak. Moduł jest zgodny z PrestaShop 8 i 9, w trybie multisklepu i wielojęzyczności, bez metod przestarzałych.