Popularność Koszyka: dokumentacja

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.

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.

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.