Cache Pro — Full Page Cache with Brotli, Warm-Up & AJAX

Cache Pro to moduł pamięci podręcznej pełnych stron dla PrestaShop. Zapisuje gotową do wysłania kopię każdej strony Twojego sklepu i wysyła ją odwiedzającym, zanim PrestaShop musi zbudować stronę od nowa. Zapisane strony są serwowane znacznie szybciej, serwer pracuje dużo mniej, a sklep zachowuje szybkość, gdy rośnie ruch.

Pamięć podręczna jest zaprojektowana dla prawdziwych sklepów: zalogowani klienci i odwiedzający z koszykiem zawsze dostają zwykłe, dokładne strony, ceny odpowiadają walucie i językowi odwiedzającego, a gdy zmieniasz produkt, cenę, promocję lub stan magazynowy, czyszczone są tylko strony, które je pokazują.

Najważniejsze zalety:

• Zapisane strony wysyłane, zanim PrestaShop zbuduje stronę, bez żadnego zapytania SQL modułu
• Precyzyjne czyszczenie: zmiana produktu, ceny, promocji, stanu magazynowego, obrazu, marki lub dostawcy usuwa tylko dotknięte strony
• Wstępne ładowanie strony głównej, kategorii, produktów i stron CMS we wszystkich językach, z panelu administracyjnego lub z zadania cyklicznego
• Przetestuj moją pamięć podręczną jednym kliknięciem i panel: skuteczność, przyspieszenie, strony według typu, powody pominięcia pamięci podręcznej, ostatnie czyszczenia, kontrole
• Wykluczenia według adresu URL, zakresu adresów IP, ciasteczka, produktu, kategorii lub strony CMS; strony 2, 3… i sortowania mają własną kopię
• Wielojęzyczność, wielowalutowość i multistore
• Prekompresja Gzip (oraz Brotli, gdy serwer ma rozszerzenie PHP) i opcjonalna minifikacja HTML
• Adres chroniony tajnym tokenem dla zadań cron, ERP, PIM i skryptów wdrożeniowych
• Jedno pobranie dla PrestaShop 1.7.8, 8.0+ i 9.1+ (PHP 7.4 minimum)

Zobacz moduł i oferty

---

Przegląd

Za każdym razem, gdy odwiedzający otwiera stronę, PrestaShop się uruchamia, wykonuje swoje moduły, odpytuje bazę danych, kompiluje szablony i wreszcie buduje HTML. W sklepie z wieloma produktami, regułami cen i modułami trwa to setki milisekund, czasem sekundy, i powtarza się dla każdego odwiedzającego, chociaż większość stron jest identyczna dla wszystkich.

Z Cache Pro pierwsza wizyta buduje stronę jak zwykle, a moduł zachowuje jej kopię. Kolejni odwiedzający dostają tę kopię od razu:

1. Odwiedzający żąda strony.
2. Moduł szuka zapisanej kopii dla tego sklepu, adresu, języka, waluty i urządzenia (desktop lub mobilne).
3. Jeśli istnieje ważna kopia, jest wysyłana natychmiast (już skompresowana), a PrestaShop na tym kończy.
4. W przeciwnym razie strona jest budowana normalnie, wysyłana odwiedzającemu i zapisywana dla kolejnych.

Efektem jest znacznie krótszy czas odpowiedzi serwera (TTFB) na stronach najważniejszych dla odwiedzających i dla Google oraz serwer, który obsługuje więcej odwiedzających. Zapisana strona potrzebuje ułamka zapytań do bazy danych strony generowanej.

Kto dostaje zapisane strony

Zapisane strony są dla odwiedzających, którzy widzą tę samą stronę co wszyscy inni. Każdy, czyja strona jest osobista, jest obsługiwany bezpośrednio przez PrestaShop, więc nic nie jest nigdy pokazywane niewłaściwej osobie.

Odwiedzający lub żądanie	Co się dzieje
Anonimowy odwiedzający na stronie katalogu	Zapisana strona
Zalogowany klient	Zwykła strona
Odwiedzający z produktami w koszyku	Zwykła strona (opcjonalnie: zapisana strona z odświeżonym blokiem koszyka, zobacz Odwiedzający z koszykiem)
Wykluczony adres IP, ciasteczko, adres URL, produkt, kategoria lub strona CMS	Zwykła strona
Wysłanie formularza, żądanie Ajax	Zwykła strona
Włączony tryb konserwacji lub geolokalizacja	Zwykła strona

Zapisywane strony: strona główna, strony produktów, strony kategorii (w tym strony 2, 3… i sortowania), strony CMS, bestsellery, nowości, obniżki cen, marki, dostawcy i mapa witryny. Koszyk, zamówienie, konto klienta, wyniki wyszukiwania, formularz kontaktowy i strony innych modułów (blog…) nigdy nie są zapisywane.

Panel: zapisane strony, skuteczność, przyspieszenie i powody wizyt bez pamięci podręcznej

---

Funkcje

Pamięć podręczna pełnych stron, w każdym języku i walucie

Osobna kopia jest przechowywana dla każdego sklepu, adresu, języka, waluty i urządzenia (desktop lub mobilne) oraz dla odwiedzających, którzy mają wybrane przez Ciebie ciasteczka (na przykład zgodę na ciasteczka). Odwiedzający przeglądający sklep we frankach szwajcarskich nigdy nie dostaje strony odwiedzającego w euro, a zmiana waluty lub języka od razu pokazuje właściwe ceny.

Parametry śledzenia, takie jak utm_source, gclid czy fbclid, są ignorowane, więc link kampanii korzysta z tej samej zapisanej strony co zwykły adres. Strony 2, 3… i sortowania kategorii mają własną kopię. Adres z nieznanym parametrem nigdy nie jest zapisywany.

Precyzyjne czyszczenie

Nie powinieneś czyścić pamięci podręcznej po każdej zmianie. Cache Pro nasłuchuje tego, co dzieje się w PrestaShop, i usuwa tylko dotknięte strony:

Co się zmienia	Co jest czyszczone
Produkt (zmiana, dodanie, usunięcie), kombinacja, obraz, marka lub dostawca	Jego własne strony i listy, które go pokazują (kategorie, strona główna, bestsellery…)
Cena, cena specjalna lub promocja, stan magazynowy (także przez zamówienie)	Strony pokazujące produkt
Kategoria lub strona CMS	Cały sklep (menu i stopki je pokazują)
Waluta, podatek, język, cecha, atrybut, grupa klientów, kraj, reguła cenowa katalogu	Cały sklep
Moduły włączone, wyłączone lub przeniesione, zmiana motywu, domyślny język lub waluta, tryb katalogu, dane kontaktowe lub wyświetlanie cen w Parametrach sklepu	Cały sklep, przy następnej stronie panelu administracyjnego
Zapisane ustawienia innego modułu (opcjonalnie)	Cały sklep tego panelu administracyjnego
Przycisk Wyczyść pamięć podręczną w PrestaShop	Cały sklep

Strona pokazująca promocję, która zaczyna się lub kończy później, jest zapisywana tylko do tego momentu, więc zaplanowana promocja pojawia się na czas. Z panelu możesz też wyczyścić wszystko, jeden typ stron lub jedną stronę według jej adresu. Czyszczenie działa nawet przy wyłączonej pamięci podręcznej, więc strona nigdy nie może wrócić nieaktualna.

Precyzyjne czyszczenie: wyczyść jedną stronę według adresu i śledź ostatnie czyszczenia oraz ich przyczynę

Wstępne ładowanie

Pusta pamięć podręczna oznacza wolne strony dla pierwszych odwiedzających. Wstępne ładowanie odwiedza Twoje strony z wyprzedzeniem: stronę główną, kategorie, bestsellery, nowości, marki, dostawców, produkty i strony CMS, w każdym aktywnym języku i, jeśli chcesz, w wersji mobilnej. Korzysta z Twojej mapy witryny XML, jeśli istnieje, w przeciwnym razie z katalogu.

Uruchom je z panelu i obserwuj pasek postępu albo pozwól, aby wykonywało je zadanie cykliczne (cron). Wybierz szybkość (2, 5, 10 lub 20 stron naraz) odpowiednią dla Twojego hostingu. Sklep chroniony hasłem (środowisko testowe) jest obsługiwany dzięki uwierzytelnianiu HTTP.

Wstępne ładowanie: odwiedź swoje strony we wszystkich językach przed klientami, z paskiem postępu

Przetestuj moją pamięć podręczną i panel

Przetestuj moją pamięć podręczną odwiedza Twoją stronę główną dwa razy i w kilka sekund mówi, czy pamięć podręczna działa (pierwsza wizyta wygenerowana i zapisana, druga obsłużona z pamięci podręcznej, folder pamięci podręcznej niedostępny do pobrania z sieci).

Panel pokazuje, co pamięć podręczna robi dla Twojego sklepu w ciągu ostatnich 7 dni:

• liczba zapisanych stron, zajęte miejsce na dysku i limit
• skuteczność i przyspieszenie (czas odpowiedzi z pamięci podręcznej w porównaniu ze stroną generowaną)
• strony i skuteczność według typu strony
• powody, dla których niektóre wizyty ominęły pamięć podręczną (klient, koszyk, wykluczenie, nieznany parametr, konserwacja…)
• wykres dzienny
• ostatnie czyszczenia i ich przyczyna
• kontrole: folder pamięci podręcznej, licencja, PHP, Gzip i Brotli, cURL, konserwacja, geolokalizacja, inne moduły pamięci podręcznej stron, waluty, motyw, miejsce na dysku

Przetestuj moją pamięć podręczną: dwie wizyty na stronie głównej i ich czasy odpowiedzi, jednym kliknięciem

Wykluczenia

Zostaw poza pamięcią podręczną strony, które muszą być zawsze generowane:

• Adresy URL: zwykły tekst (/blog), znaki wieloznaczne (/*/promo-*) lub wyrażenia regularne
• Adresy IP i zakresy (203.0.113.0/24): Twój zespół zawsze widzi strony na żywo
• Ciasteczka: odwiedzający, którzy mają jedno z wymienionych przez Ciebie ciasteczek (testy A/B, personalizacja)
• Produkty, kategorie i strony CMS według identyfikatora
• Typy stron: wyłącz typy, których nie chcesz zapisywać

Wykluczenia: pomiń w pamięci podręcznej wybrane adresy URL, produkty, kategorie, strony CMS, adresy IP i ciasteczka

Odwiedzający z koszykiem

Domyślnie odwiedzający, który ma produkty w koszyku, dostaje zwykłe strony, więc koszyk, sumy i ceny są zawsze dokładne. To najbezpieczniejszy wybór.

Jeśli wolisz, aby ci odwiedzający również dostawali zapisane strony, opcja zaawansowana Zwracaj zapisane strony i odświeżaj blok koszyka wysyła zapisaną stronę i odświeża blok koszyka małym żądaniem zaraz po załadowaniu strony. Przycisk Wykryj blok koszyka mojego motywu wypełnia blok dla motywów Classic i Hummingbird; inne motywy wymagają hooka i selektora CSS bloku. Strona takiego odwiedzającego nigdy nie jest zapisywana.

Odwiedzający z koszykiem: serwuj zapisane strony i odświeżaj blok koszyka po załadowaniu strony

Multistore

Przy kilku sklepach każdy sklep ma własne ustawienia, zapisane strony, statystyki i wstępne ładowanie. Panel administracyjny prosi o wybór sklepu, gdy otwierasz Cache Pro z widoku „wszystkie sklepy”.

Zadanie cykliczne i API

Cache Pro daje adres chroniony tajnym tokenem:

• adres zadania cyklicznego (cron), który usuwa wygasłe strony, utrzymuje pamięć podręczną w limicie rozmiaru i uruchamia wstępne ładowanie
• API dla Twojego ERP, PIM lub skryptów wdrożeniowych: wyczyść wszystko, typ strony, produkt, kategorię, stronę CMS, markę, dostawcę lub adres, uruchom wstępne ładowanie, odczytaj statystyki

Parametry znajdziesz w części Cron i API.

Kompresja i minifikacja HTML

Strony są zapisywane prekompresowane w formacie Gzip, a także w formacie Brotli, gdy serwer ma rozszerzenie PHP Brotli. Odwiedzający dostaje najlepszy format akceptowany przez jego przeglądarkę, bez żadnej pracy kompresji w momencie żądania. Opcjonalna minifikacja usuwa komentarze i odstępy między znacznikami w zapisanej kopii; skrypty, style i teksty pozostają nietknięte.

Bezpieczne zachowanie pod obciążeniem

• Strona jest zapisywana w całości albo wcale: odwiedzający nigdy nie dostaje uciętej strony.
• Gdy strona wygasa, jeden odwiedzający ją odświeża, a pozostali nadal dostają poprzednią kopię (najwyżej 5 minut), więc popularna strona nigdy nie ustawia odwiedzających w kolejce. Czyszczenie nigdy nie zwraca starej kopii.
• Zapisane strony mieszczą się w limicie rozmiaru (domyślnie 1 GB): najstarsze strony są usuwane jako pierwsze.
• Folder pamięci podręcznej jest chroniony i sprawdzany przez diagnostykę.

---

Wymagania

• PrestaShop 1.7.8, 8.0+ lub 9.1+ (jedno pobranie dla wszystkich wersji). PrestaShop 1.7.7 i starsze oraz 9.0 nie są obsługiwane.
• PHP 7.4 lub nowszy
• Rozszerzenia PHP: cURL (wstępne ładowanie i test), zlib (Gzip)
• Prawo zapisu do folderu modules/wepresta_cache_pro/cache modułu
• Ważna licencja WePresta
• Jeden moduł pamięci podręcznej stron naraz: wyłącz każdą inną pamięć podręczną pełnych stron

---

Instalacja

1. Pobierz plik ZIP modułu ze swojego konta klienta WePresta.
2. W panelu administracyjnym PrestaShop otwórz Moduły > Menedżer modułów i kliknij Załaduj moduł.
3. Wybierz plik ZIP i rozpocznij instalację.

Instalacja tworzy dwie małe tabele w bazie danych, rejestruje hooki, tworzy folder pamięci podręcznej i go chroni. Pamięć podręczna pozostaje wyłączona, dopóki jej nie włączysz. W przypadku Apache folder jest chroniony plikiem .htaccess; w przypadku nginx dodaj location ~ ^/modules/wepresta_cache_pro/cache/ { deny all; } do konfiguracji serwera. Panel informuje, czy folder można pobrać z sieci.

Aktualizacja z wersji 1.0.0

Zainstaluj nowe archiwum na starym z Menedżera modułów. Moduł aktualizuje się sam: zachowany zostaje stan włączony lub wyłączony, czasy przechowywania, Twoje wykluczenia (adresy URL, ciasteczka, adresy IP) i szybkość wstępnego ładowania; cztery wykluczenia adresów URL sugerowane przez wersję 1.0.0 (wyszukiwanie, konto, koszyk, kontakt) są usuwane, bo tych stron i tak nigdy się nie zapisuje; przestarzałe pliki są usuwane, a pamięć podręczna jest raz czyszczona. Odwiedzający z koszykiem dostają teraz zwykłe strony: włącz opisaną wyżej opcję, jeśli chcesz, aby dostawali zapisane strony.

---

Pierwsze kroki

1. Otwórz Cache Pro w menu Moduły (menu WePresta w PrestaShop 9). Kontrole na dole panelu mówią, co poprawić, jeśli trzeba.
2. Kliknij Włącz z zalecanymi ustawieniami.
3. Kliknij Przetestuj moją pamięć podręczną: odpowiedź pokazuje dwie wizyty i ich czasy odpowiedzi.
4. Kliknij Uruchom wstępne ładowanie i zostaw stronę otwartą do końca albo zaplanuj zadanie opisane niżej.
5. Odwiedź swój sklep w oknie prywatnym: odśwież stronę i patrz, jak panel liczy zapisane strony i trafienia.

Aby samemu śledzić stronę, otwórz narzędzia deweloperskie przeglądarki, załaduj stronę dwa razy i odczytaj nagłówek odpowiedzi X-WP-Cache: MISS za pierwszym razem, HIT za drugim, BYPASS, gdy PrestaShop odpowiedział celowo (klient, koszyk, wykluczenie…).

---

Ustawienia

Ogólne

• Włącz pamięć podręczną: włącza i wyłącza zapisane strony. Klienci i odwiedzający z koszykiem zawsze dostają zwykłe strony.
• Minifikuj HTML: komentarze i odstępy między znacznikami są usuwane z zapisanej kopii.
• Zwracaj wygasłą stronę podczas jej odświeżania: domyślnie włączone, patrz wyżej.
• Czyść pamięć podręczną po skonfigurowaniu innego modułu: baner, menu lub blok edytowane w ustawieniach innego modułu pojawiają się od razu.
• Nagłówki diagnostyczne: dodają do odpowiedzi X-WP-Cache-Key, -Type, -TTL, -Age (oraz -Reason, gdy strona omija pamięć podręczną).
• Pamięć podręczna przeglądarki: Sprawdzaj za każdym razem (zalecane) albo 1, 5, 15 minut, 1 godzina.
• Maksymalny rozmiar: po osiągnięciu limitu najstarsze strony są usuwane (0 = bez limitu).

Strony w pamięci podręcznej i czas ich przechowywania

Dla każdego typu strony wybierz, czy jest zapisywany i na jak długo (minimum 60 sekund). Wartości domyślne: strona główna 30 minut, strony produktów 2 godziny, strony kategorii 1 godzina, strony CMS 24 godziny, pozostałe listy 1 godzina. Strona zmieniona w panelu administracyjnym jest odświeżana od razu, niezależnie od swojego czasu.

Strony w pamięci podręcznej i czas ich przechowywania: wybierz, co jest zapisywane i na jak długo

Wykluczenia

Wykluczone adresy URL, identyfikatory produktów, kategorii i stron CMS, adresy IP i zakresy, ciasteczka. Zapis odrzuca nieprawidłowe wyrażenie regularne lub adres i pokazuje to, co wpisałeś.

Adresy i warianty

• Ignorowane parametry: parametry śledzenia, które nie zmieniają strony (długa lista jest wbudowana).
• Dodatkowe parametry z własną kopią: parametry Twojego motywu, które wybierają wersję strony (na przykład sortowanie).
• Zapisuj strony z filtrami: wyniki wyszukiwania fasetowego (?q=…). Domyślnie wyłączone, bo mogą być bardzo liczne.
• Ciasteczka zmieniające stronę: nazwy ciasteczek (zgoda na ciasteczka…), których obecność tworzy osobną kopię.

Wstępne ładowanie i automatyzacja

Szybkość wstępnego ładowania, wersja mobilna, uwierzytelnianie HTTP sklepu, adres zadania cyklicznego, token (który możesz wygenerować ponownie) i przypomnienie o API.

---

Cron i API

Wywołuj adres cron co 10 minut: usuwa wygasłe strony, utrzymuje rozmiar w limicie i uruchamia wstępne ładowanie. Zachowaj adres w tajemnicy, zawiera Twój token.

API znajduje się pod adresem /module/wepresta_cache_pro/api Twojego sklepu. Wyślij token jako token lub w nagłówku X-WPC-Token i wskaż akcję w parametrze action:

• status (GET): wersja, sklep, stan pamięci podręcznej, strony i rozmiar, wstępne ładowanie.
• stats (GET): trafienia, chybienia i wizyty bez pamięci podręcznej (7 i 30 dni), średnie czasy odpowiedzi.
• warmup (GET): uruchamia lub kontynuuje wstępne ładowanie (opcjonalne parametry time, batch, interval i force).
• cleanup (GET): usuwa wygasłe strony i egzekwuje limit rozmiaru.
• cron (GET): czyszczenie, potem wstępne ładowanie w jednym wywołaniu.
• purge (POST): czyści to, co wskazuje scope: all; type (dodaj type = product, category, cms, home lub other); product, category, cms, manufacturer lub supplier (dodaj id); url (dodaj url = adres strony).

Przykład, ze skryptu po imporcie katalogu:

SHOP=https://twoj-sklep.pl

curl -X POST \
  -H "X-WPC-Token: TWOJ_TOKEN" \
  -d action=purge \
  -d scope=category \
  -d id=12 \
  "$SHOP/module/wepresta_cache_pro/api"

---

Zgodność i inne systemy

• Inne moduły pamięci podręcznej: zachowaj tylko jedną pamięć podręczną pełnych stron. Panel ostrzega, jeśli wykryje inną.
• CDN i reverse proxy: strony są wysyłane z nagłówkiem Cache-Control: private, więc CDN ich nie przechowuje i zawsze pyta Twój sklep; pracę wykonuje pamięć podręczna modułu. Używaj CDN dla obrazów, skryptów i stylów.
• nginx: dodaj regułę location z sekcji Instalacja, aby zablokować bezpośrednie pobieranie folderu pamięci podręcznej.
• PHP-FPM: przy PHP-FPM strona jest wysyłana odwiedzającemu, zanim zostanie zapisana; bez niego odwiedzający, który generuje stronę, czeka nieco dłużej.
• Kompresja przez PHP (zlib.output_compression): moduł wysyła wtedy kopię nieskompresowaną i pozwala PHP ją skompresować.
• Statystyki PrestaShop: strony serwowane z pamięci podręcznej nie są liczone przez własne statystyki odwiedzin PrestaShop (Statystyki > Odwiedziny). Do liczenia wizyt używaj Google Analytics lub logów serwera.
• Motywy: dowolny motyw. Odświeżanie bloku koszyka ma gotowe ustawienia dla motywów Classic i Hummingbird.

---

FAQ

Co to jest full page cache w PrestaShop?

Full page cache zapisuje końcowy kod HTML strony i wysyła tę kopię kolejnym odwiedzającym, zamiast przy każdym żądaniu ponownie uruchamiać PrestaShop, jego moduły, zapytania SQL i szablony. W sklepie PrestaShop skraca to czas odpowiedzi serwera dla stron, które ogląda wielu odwiedzających: strony głównej, kategorii, produktów i stron CMS.

W jaki sposób ten moduł może przyspieszyć mój sklep?

Cache Pro wysyła zapisaną kopię strony, zanim PrestaShop ją zbuduje: sam moduł nie wykonuje żadnego zapytania SQL, a strona potrzebuje ułamka zapytań strony generowanej. Zapisane strony są prekompresowane (Gzip, a Brotli, jeśli serwer ma rozszerzenie PHP), HTML można zminifikować, a wstępne ładowanie wypełnia pamięć podręczną, zanim pojawią się klienci. Zysk zależy od hostingu, motywu i modułów: użyj „Przetestuj moją pamięć podręczną”, aby sprawdzić go we własnym sklepie.

Czy koszyk i dane klienta pozostają dokładne?

Tak. Zalogowani klienci i odwiedzający z produktami w koszyku zawsze dostają zwykłe strony zbudowane przez PrestaShop, więc nic osobistego nie jest zapisywane ani pokazywane komuś innemu. Jeśli wolisz, aby odwiedzający z koszykiem również dostawali zapisane strony, opcja zaawansowana wysyła zapisaną stronę i po jej załadowaniu odświeża blok koszyka małym żądaniem, z gotowymi ustawieniami dla motywów Classic i Hummingbird.

Czy pamięć podręczna czyści się automatycznie przy zmianach w katalogu?

Tak. Zmiana produktu, kombinacji, obrazu, marki lub dostawcy usuwa jego własne strony i listy, które go pokazują. Zmiana ceny, ceny specjalnej, promocji lub stanu magazynowego (także przez zamówienie) usuwa strony pokazujące produkt. Kategorie, strony CMS, waluty, podatki, języki, moduły i zmiany motywu odświeżają cały sklep. Strona pokazująca promocję, która zaczyna się lub kończy później, nigdy nie jest przechowywana dłużej niż do tego momentu. Czyszczenie działa nawet przy wyłączonej pamięci podręcznej.

Do czego służy rozgrzewanie (wstępne ładowanie) pamięci podręcznej?

Odwiedza ważne strony, zanim pojawią się odwiedzający: stronę główną, kategorie, bestsellery, nowości, marki, dostawców, produkty i strony CMS, we wszystkich językach i, jeśli chcesz, w wersji mobilnej. Po instalacji, pełnym czyszczeniu lub dużej aktualizacji katalogu pierwsi odwiedzający dostają więc zapisane strony zamiast czekać na zwykłe generowanie. Uruchom je z panelu lub z zadania cyklicznego.

Czy moduł nadaje się do sklepów wielojęzycznych, wielowalutowych i multistore?

Tak. Osobna kopia jest przechowywana dla każdego sklepu, adresu, języka, waluty i urządzenia (desktop lub mobilne) oraz dla odwiedzających, którzy mają wybrane przez Ciebie ciasteczka (na przykład zgodę na ciasteczka). Przy kilku sklepach każdy ma własne ustawienia, zapisane strony, statystyki i wstępne ładowanie.

Czy można ustawić różny czas przechowywania w pamięci podręcznej dla różnych typów stron?

Tak. Każdy typ strony (strona główna, produkty, kategorie, strony CMS, pozostałe listy) ma własny przełącznik i czas przechowywania, z zalecanymi wartościami i minimum 60 sekund. Strona zmieniona w panelu administracyjnym jest odświeżana od razu, niezależnie od swojego czasu.

Czy jest zgodny z PrestaShop 1.7.8, 8 i 9?

Tak: PrestaShop 1.7.8, 8.0+ i 9.1+, z PHP 7.4 lub nowszym. PrestaShop 1.7.7 i starsze oraz 9.0 nie są obsługiwane. Jedno archiwum pasuje do wszystkich tych wersji. Moduł działa z motywami Classic i Hummingbird oraz z motywami zewnętrznymi.

Jak sprawdzić, czy pamięć podręczna działa poprawnie?

Kliknij „Przetestuj moją pamięć podręczną” w panelu: odwiedza Twoją stronę główną dwa razy i mówi, czy pierwsza wizyta została zapisana, a druga obsłużona z pamięci podręcznej, wraz z oboma czasami odpowiedzi. Możesz też załadować stronę dwa razy z otwartymi narzędziami deweloperskimi przeglądarki i odczytać nagłówek odpowiedzi X-WP-Cache: MISS za pierwszym razem, HIT za drugim, BYPASS, gdy PrestaShop odpowiedział celowo. Panel wymienia też powody, dla których niektóre wizyty nie korzystały z pamięci podręcznej.

Które strony nigdy nie są zapisywane?

Koszyk, zamówienie, konto klienta, wyniki wyszukiwania, formularz kontaktowy i strony innych modułów nigdy nie są zapisywane, podobnie jak wysyłanie formularzy, żądania Ajax, tryb konserwacji i geolokalizacja ani strony, które wykluczysz według adresu URL, adresu IP, ciasteczka, produktu, kategorii lub strony CMS. Zalogowani klienci i odwiedzający z koszykiem dostają zwykłe strony (lub zapisane strony z odświeżonym blokiem koszyka, jeśli wybierzesz tę opcję).

Czy pierwsi odwiedzający nadal zobaczą wolne strony?

Pierwsza wizyta na stronie buduje ją jak zwykle i zapisuje; kolejni odwiedzający dostają zapisaną kopię. Wstępne ładowanie usuwa to pierwsze oczekiwanie, odwiedzając Twoje strony z wyprzedzeniem, i możesz je uruchamiać z zadania cyklicznego po każdym czyszczeniu.

Czy moduł poprawia SEO?

Pośrednio. Szybsza odpowiedź serwera na stronach, które Google i Twoi odwiedzający otwierają najczęściej, poprawia doświadczenie użytkowników i techniczną wydajność sklepu, co może pomóc w widoczności. Parametry śledzenia są ignorowane, a strony 2, 3… zachowują własną zawartość, więc wyszukiwarki i odwiedzający dostają właściwą stronę.

Czy jest zgodny z CDN lub innym modułem pamięci podręcznej?

Zachowaj tylko jedną pamięć podręczną pełnych stron: panel ostrzega, jeśli wykryje inną. CDN lub reverse proxy przed sklepem jest w porządku: strony są wysyłane z nagłówkiem Cache-Control: private, więc CDN ich nie przechowuje, a pracę wykonuje Cache Pro; używaj CDN dla obrazów, skryptów i stylów.

Czy można sterować pamięcią podręczną z ERP, PIM lub skryptu?

Tak. Adres zadania cyklicznego i API chronione tajnym tokenem pozwalają Twoim narzędziom wyczyścić wszystko, typ strony, produkt, kategorię, stronę CMS, markę, dostawcę lub adres, uruchomić wstępne ładowanie i odczytać statystyki prostym żądaniem HTTP. Token można w każdej chwili wygenerować ponownie.

Co się dzieje przy aktualizacji z wersji 1.0.0?

Zainstaluj nowe archiwum na starym. Zachowany zostaje stan włączony lub wyłączony, czasy przechowywania, Twoje wykluczenia (adresy URL, ciasteczka, adresy IP) i szybkość wstępnego ładowania; cztery wykluczenia adresów URL sugerowane przez wersję 1.0.0 są usuwane, bo tych stron i tak nigdy się nie zapisuje; przestarzałe pliki są usuwane, a pamięć podręczna jest raz czyszczona. Odwiedzający z koszykiem dostają teraz zwykłe strony; włącz opcję bloku koszyka, jeśli chcesz, aby dostawali zapisane strony.

Czy muszę zmieniać konfigurację serwera?

Nie w przypadku Apache: folder pamięci podręcznej jest chroniony plikiem .htaccess. W przypadku nginx dodaj regułę blokującą bezpośrednie pobieranie folderu pamięci podręcznej; panel informuje, czy folder można pobrać z sieci. Nic więcej nie jest potrzebne na hostingu współdzielonym, VPS, serwerze dedykowanym ani w chmurze.

---

Rozwiązywanie problemów

Strona nie jest zapisywana

Otwórz panel: Strony nieserwowane z pamięci podręcznej wymienia powody (klient, koszyk, wykluczony adres URL, nieznany parametr, konserwacja, geolokalizacja, odpowiedź nie do zapisania…). Sprawdź nagłówek odpowiedzi X-WP-Cache i, przy włączonych nagłówkach diagnostycznych, X-WP-Cache-Reason.

Test mówi, że moduł nie jest osiągany

Odpowiedź nie zawiera żadnego nagłówka pamięci podręcznej: inna pamięć podręczna jest przed sklepem, moduł jest wyłączony albo adres jest chroniony hasłem (uzupełnij uwierzytelnianie HTTP w ustawieniach).

Cena, stan magazynowy lub tekst są nieaktualne

Produkty, ceny, promocje, stany magazynowe, obrazy, kategorie i strony CMS same czyszczą właściwe strony. Zmiany wykonane poza PrestaShop (bezpośredni SQL, importy niekorzystające z obiektów PrestaShop, pliki motywu) nie są widoczne: użyj Wyczyść całą pamięć podręczną, przycisku Wyczyść pamięć podręczną w PrestaShop lub API.

Wstępne ładowanie zgłasza błędy

Lista błędów pokazuje adres i komunikat. Typowe przyczyny: sklep chroniony hasłem (uzupełnij uwierzytelnianie HTTP), zapora blokująca żądania serwera do samego siebie, nieprawidłowy certyfikat SSL w środowisku testowym.

Folder pamięci podręcznej można pobrać

Zablokuj folder w konfiguracji serwera WWW (zobacz Instalacja).

---

Changelog

Wersja 2.0.0

Nowości

• Moduł działa w PrestaShop 1.7.8, 8.0+ i 9.1+, z PHP 7.4 minimum, w jednym archiwum.
• Menu panelu administracyjnego pokazuje Cache Pro, z panelem i ustawieniami, po francusku, angielsku, hiszpańsku, włosku i polsku.
• Przetestuj moją pamięć podręczną odwiedza Twoją stronę główną dwa razy i w kilka sekund mówi, czy pamięć podręczna działa.
• Panel pokazuje skuteczność, przyspieszenie, strony według typu, wykres dzienny, powody wizyt bez pamięci podręcznej, ostatnie czyszczenia i kontrole.
• Wyczyść jedną stronę według adresu, jeden typ stron lub wszystko, z panelu.
• Wstępne ładowanie działa bez otwartej strony: uruchamia je adres zadania cyklicznego, z czterema szybkościami, wszystkimi językami i opcjonalną wersją mobilną.
• API chronione tokenem czyści wszystko, typ strony, produkt, kategorię, stronę CMS, markę, dostawcę lub adres, uruchamia wstępne ładowanie i zwraca statystyki.
• Odwiedzający z koszykiem mogą dostawać zapisane strony z blokiem koszyka odświeżanym po załadowaniu; przycisk wykrywa blok motywów Classic i Hummingbird.
• Wykluczenia według ciasteczka, adresu IP lub zakresu, produktu, kategorii, strony CMS i typu strony, oprócz adresów URL; nieprawidłowe wyrażenie regularne lub adres są odrzucane z wyjaśnieniem.
• Ciasteczka zmieniające stronę, takie jak zgoda na ciasteczka, mają własną zapisaną kopię.
• Strony 2, 3… i sortowania kategorii mają własną zapisaną kopię, podobnie jak każda waluta.
• Strony nigdy nie są przechowywane dłużej niż do początku lub końca zaplanowanej promocji.
• Pamięć podręczna mieści się w maksymalnym rozmiarze dzięki usuwaniu najstarszych stron, a zadanie cykliczne usuwa wygasłe pliki.
• Nagłówek odpowiedzi X-WP-Cache pokazuje HIT, MISS lub BYPASS dla każdej strony.
• Przy kilku sklepach każdy sklep ma własne ustawienia, zapisane strony, statystyki i wstępne ładowanie, a strona prosi o wybór sklepu w widoku „wszystkie sklepy”.

Ulepszenia

• Zapisana strona jest wysyłana bez żadnego zapytania SQL ani zapisu ze strony modułu.
• Strona jest zapisywana w całości albo wcale: odwiedzający nigdy nie dostaje uciętej strony.
• Gdy strona wygasa, jeden odwiedzający ją odświeża, a pozostali dostają poprzednią kopię przez najwyżej 5 minut; czyszczenie nigdy nie zwraca starej kopii.
• Czyszczenie działa nawet przy wyłączonej pamięci podręcznej, więc strona nie może wrócić nieaktualna.
• Przycisk Wyczyść pamięć podręczną w PrestaShop, zmiany modułów i motywu oraz główne ustawienia sklepu odświeżają zapisane strony.
• Archiwum waży około 240 KB zamiast 27 MB.

Poprawki

• Tekst „Powered by Module Starter” i publiczna strona /module/wepresta_cache_pro/display już nie istnieją.
• Strony 2, 3…, sortowania i listy filtrowane nie pokazują już pierwszej strony.
• Zmiana waluty nie pokazuje już cen w innej walucie.
• Strona konserwacji jest wyświetlana, gdy sklep jest w trybie konserwacji.
• Zalogowani klienci i odwiedzający z koszykiem nie dostają już zapisanej strony zbudowanej dla kogoś innego.
• Zmiana produktu, ceny, promocji, stanu magazynowego, kategorii lub strony CMS odświeża zapisane strony od razu, zamiast po upływie ich czasu.
• Wykluczone ciasteczka są uwzględniane, a sugerowane wykluczenia adresów URL, które ukrywały też prawidłowe strony, jak karty podarunkowe, zniknęły.
• Skrypt odświeżający blok koszyka jest teraz w archiwum, więc blok nie pozostaje już pusty.
• Przeglądarki nie przechowują już zapisanej strony po zalogowaniu odwiedzającego lub dodaniu produktu do koszyka.
• Pliki i ustawienia są usuwane przy odinstalowaniu modułu.
• Skuteczność jest dokładna: czyszczenia już jej nie zerują.

Po aktualizacji: zachowany zostaje stan włączony lub wyłączony, czasy przechowywania, Twoje wykluczenia (adresy URL, ciasteczka, adresy IP) i szybkość wstępnego ładowania. Cztery wykluczenia adresów URL sugerowane przez wersję 1.0.0 są usuwane, bo tych stron i tak nigdy się nie zapisuje. Przestarzałe pliki są usuwane, a pamięć podręczna jest raz czyszczona. Odwiedzający z koszykiem dostają teraz zwykłe strony: włącz opcję bloku koszyka, jeśli chcesz, aby dostawali zapisane strony.

Wersja 1.0.0

• Pierwsze wydanie modułu
• Implementacja Full Page Cache
• Obsługa kontekstów wielojęzycznych, wielowalutowych i multistore
• Inteligentna automatyczna invalidacja
• Kompresja Gzip i Brotli
• Minifikacja HTML
• Panel wydajności
• Warm-up cache
• Dynamiczne bloki AJAX

---

Wsparcie

W razie potrzeby skontaktuj się z nami ze swojej strefy klienta WePresta lub e-mailem na adres mail@wepresta.shop, zależnie od opcji wsparcia Twojego planu.

Przed kontaktem z wsparciem przygotuj:

• wersję PrestaShop i PHP
• adres strony, której dotyczy problem, i jej nagłówek X-WP-Cache
• wynik Przetestuj moją pamięć podręczną i kontrole z panelu
• zrzuty ekranu
• logi PrestaShop, jeśli są dostępne

Zobacz moduł i oferty