DataFirefly Cache Clear: dokumentacja
Instalacja i obsługa przycisku „Wyczyść pamięć podręczną” od DataFirefly w panelu administracyjnym PrestaShop 8 i 9.
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
- Pobierz archiwum
dfclearcache.zipze swojego konta DataFirefly. - W panelu administracyjnym otwórz Moduły > Menedżer modułów.
- Kliknij Prześlij moduł i wybierz plik ZIP.
- 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
- Kliknij przycisk „Wyczyść pamięć podręczną” w pasku narzędzi, obok akcji strony i przycisku pomocy.
- Ikona obraca się podczas operacji. Czyszczenie działa przez AJAX, strona nie jest przeładowywana.
- 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.