# Popularność Koszyka: dokumentacja

> Przewodnik instalacji i konfiguracji modułu Popularność Koszyka: plakietka z liczbą koszyków na karcie produktu, próg, okno czasowe, pamięć podręczna i rozwiązywanie problemów.

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

Moduł **Popularność Koszyka** wyświetla na karcie produktu plakietkę społecznego dowodu słuszności z liczbą koszyków zawierających dany produkt, na przykład „W ponad 20 koszykach”. Ten przewodnik obejmuje instalację, konfigurację każdego ustawienia, zasadę zliczania i rozwiązywanie problemów.

## Instalacja

Moduł instaluje się jak każdy moduł PrestaShop, bez zewnętrznych zależności.

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

Zgodny z PrestaShop od 8.0 do 9.x. Nie jest wymagana żadna zależność Composer ani zewnętrzna biblioteka JavaScript.

## Konfiguracja

Strona konfiguracji zbiera wszystkie ustawienia wyświetlania i zliczania.

### Wyświetlany tekst

Komunikat prezentowany w plakietce, tłumaczalny dla każdego języka. Użyj znacznika `{count}`, aby dynamicznie wstawić liczbę. Przykład: _W ponad {count} koszykach_. Tłumaczenia francuskie, angielskie, hiszpańskie, niemieckie i włoskie są dostarczone domyślnie.

### Próg wyświetlania

Minimalna liczba koszyków, od której pojawia się plakietka. Poniżej tego progu nic się nie wyświetla, co pozwala uniknąć pokazywania mało atrakcyjnej liczby. Wartość domyślna: 20.

### Tryb prezentacji liczby

- **Zaokrąglenie do progu**: licznik jest zaokrąglany w dół według ustalonego kroku (np. 23 koszyki dają „ponad 20”). Dobre rozwiązanie na wiarygodny efekt zmieniający się skokowo.
- **Dokładna liczba**: pokazywana jest rzeczywista wartość, dla sklepów stawiających na pełną przejrzystość.

### Krok zaokrąglenia

Używany wyłącznie w trybie progowym. Określa przedział zaokrąglenia: krok 10 zamienia 23 na „ponad 20”, a 37 na „ponad 30”.

### Okno czasowe (godziny)

Zliczane są tylko koszyki zaktualizowane w tym oknie. Na przykład 168 = 7 dni. Ustaw `0`, aby nie stosować żadnego ograniczenia czasowego.

### Tylko aktywne koszyki

Gdy ta opcja jest włączona, koszyki zamienione już w zamówienie są wyłączone ze zliczania. Odzwierciedlasz w ten sposób wyłącznie bieżący popyt.

### Miejsce wyświetlania

Wybierz, gdzie plakietka pojawia się na karcie: pod blokiem dodawania do koszyka (dodatkowe informacje) albo przy przyciskach zakupu.

### Czas życia pamięci podręcznej (sekundy)

Czas przechowywania wyniku zliczania przed ponownym obliczeniem. Domyślnie 600 sekund (10 minut). Ustaw `0`, aby przeliczać przy każdym wyświetleniu, co nie jest zalecane na produkcji.

Przy każdym zapisie ustawień pamięć podręczna zliczania jest czyszczona automatycznie, aby nowe parametry zadziałały natychmiast.

## Jak działa zliczanie

Moduł liczy rzeczywiste koszyki zawierające produkt. Zliczanie jest odduplikowane na poziomie koszyka, więc ten sam koszyk nigdy nie jest liczony dwa razy, i ograniczone do bieżącego sklepu w kontekście wielosklepowym. Okno czasowe i opcja „tylko aktywne koszyki” doprecyzowują wynik tak, aby odzwierciedlał istotny popyt.

## Wydajność i pamięć podręczna

Aby uniknąć zapytania zliczającego przy każdym wyświetleniu produktu, wynik jest zapisywany w dedykowanej tabeli pamięci podręcznej z konfigurowalnym czasem życia. Przeliczenie następuje dopiero po wygaśnięciu wpisu, co chroni wydajność nawet w sklepach o dużym ruchu.

## Tryb wielosklepowy i wielojęzyczność

W trybie wielosklepowym zliczanie jest zawężone do przeglądanego sklepu. Po stronie języków tekst plakietki jest w pełni tłumaczalny: ustawia się go niezależnie dla każdego aktywnego języka sklepu, ze znacznikiem `{count}` w miejscu liczby.

## Integracja z motywem

Plakietka jest renderowana po stronie serwera przez szablon modułu. Jeśli chcesz umieścić ją dokładnie w wybranym miejscu motywu, zmienna Smarty `{$dfcp_message}` zawiera gotowy komunikat i może zostać wstawiona w nadpisaniu karty produktu.

## Rozwiązywanie problemów

### Plakietka się nie wyświetla

Sprawdź, czy rzeczywista liczba koszyków z produktem osiąga ustawiony próg. Jeśli próg wynosi 20, a produkt jest tylko w 5 koszykach, plakietka nie pojawi się i jest to zachowanie zgodne z założeniem. Zmniejsz tymczasowo próg, aby przetestować wyświetlanie.

### Liczba nie aktualizuje się od razu

To efekt pamięci podręcznej. Poczekaj na wygaśnięcie skonfigurowanego czasu życia albo zapisz ustawienia, aby wymusić natychmiastowe wyczyszczenie.

### Licznik wydaje się zbyt niski

Jeśli opcja „tylko aktywne koszyki” jest włączona, a okno czasowe krótkie, liczone są wyłącznie świeże koszyki bez złożonego zamówienia. Rozszerz okno czasowe albo wyłącz tę opcję, aby uzyskać szersze zliczanie.