# DataFirefly Cache Clear: dokumentacja

> Wprowadzenie DataFirefly Cache Clear dodaje przycisk „Wyczyść pamięć podręczną” do paska narzędzi panelu administracyjnego PrestaShop. Jedno kliknięcie czyści pamięć podręczną Smarty, XML, Media i Symfony, resetuje OPcache PHP i czyści…

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

## Wprowadzenie

DataFirefly Cache Clear dodaje przycisk „Wyczyść pamięć podręczną” do paska narzędzi panelu administracyjnego PrestaShop. Jedno kliknięcie czyści pamięć podręczną Smarty, XML, Media i Symfony, resetuje OPcache PHP i czyści pamięć obiektów, jeśli jest włączona, bez przechodzenia przez Zaawansowane > Wydajność i bez przeładowania strony.

## Instalacja

1. Pobierz archiwum `dfclearcache.zip` ze swojego konta DataFirefly.
2. W panelu administracyjnym otwórz **Moduły > Menedżer modułów**.
3. Kliknij **Prześlij moduł** i wybierz plik ZIP.
4. Moduł instaluje się i włącza automatycznie.

Konfiguracja nie jest potrzebna: zaraz po włączeniu przycisk pojawia się w pasku narzędzi każdej strony administracyjnej.

## Aktualizacja z wersji 1.0.x

Prześlij plik ZIP wersji 1.1.0 w **Moduły > Menedżer modułów**, na zainstalowaną wersję. Skrypt aktualizacji resetuje OPcache, aby nowy kod był używany od razu. Niczego nie trzeba ponownie konfigurować.

## Użycie

1. Kliknij przycisk **„Wyczyść pamięć podręczną”** w pasku narzędzi, obok akcji strony i przycisku pomocy.
2. Ikona obraca się podczas operacji. Czyszczenie działa przez AJAX, strona nie jest przeładowywana.
3. Zielone powiadomienie potwierdza operację i wymienia wyczyszczone pamięci podręczne, na przykład „Pamięć podręczna została wyczyszczona. (Smarty, XML, Media, Symfony, OPcache)”.

## Co jest czyszczone

- **pamięć podręczna Smarty** (skompilowane szablony sklepu i panelu);
- **pamięć podręczna XML**;
- **pamięć podręczna mediów** (połączone i zminifikowane CSS/JS);
- **pamięć podręczna Symfony** w PrestaShop 8/9;
- **OPcache PHP**, jeśli rozszerzenie jest aktywne, a hosting pozwala na jego reset;
- **pamięć obiektów** (Memcached, APCu), tylko jeśli jest włączona w Zaawansowane > Wydajność.

Pamięć podręczna Symfony jest czyszczona natywnym mechanizmem PrestaShop na końcu żądania. Jeśli ten mechanizm jest niedostępny, moduł zmienia nazwę katalogu `var/cache` bieżącego środowiska i usuwa go po wysłaniu odpowiedzi. Katalog nigdy nie jest więc usuwany, gdy korzysta z niego jakaś strona.

## Kto widzi przycisk

Przycisk jest wyświetlany tylko pracownikom, których profil ma dostęp do modułu: superadministratorom i profilowi pracownika, który zainstalował moduł. Pozostałe profile go nie widzą, dzięki czemu nie ma przycisku, który zawiódłby po kliknięciu.

## Dziennik czyszczeń

Każde czyszczenie jest zapisywane w **Zaawansowane > Logi** z ID pracownika, w postaci „DataFirefly Cache Clear: cache cleared (Smarty, XML, Media, Symfony, OPcache)”. Częściowe czyszczenie pojawia się z poziomem „ostrzeżenie”.

## Zgodność

- PrestaShop 8.0 do 9.x
- PHP 7.4 do 8.x
- Jeden sklep i multisklep
- Języki: FR, EN, ES, DE, IT, NL, PL, PT (domyślnie angielski)
- Używany hook: `displayBackOfficeHeader`

## Rozwiązywanie problemów

### Przycisk się nie pojawia

Sprawdź, czy moduł jest włączony w Menedżerze modułów i czy Twój profil należy do profili z dostępem do modułu (zob. „Kto widzi przycisk”).

### Komunikat „Sesja wygasła”

Sesja panelu administracyjnego wygasła, gdy strona była otwarta. Odśwież stronę, w razie potrzeby zaloguj się ponownie i kliknij jeszcze raz.

### Komunikat „Pamięć podręczna wyczyszczona częściowo”

Jeden krok się nie powiódł, pozostałe zostały wykonane. Szczegóły błędu pojawiają się w konsoli przeglądarki (F12), a czyszczenie jest zapisywane w logach jako ostrzeżenie. Najczęstszą przyczyną jest brak uprawnień do zapisu w katalogach pamięci podręcznej.

### OPcache nie pojawia się w powiadomieniu

Rozszerzenie OPcache jest wyłączone albo hosting ogranicza `opcache_reset()` (dyrektywa `opcache.restrict_api`). Krok jest wtedy pomijany bez błędu. Nie jest to usterka modułu.