Statystyki Live sprzedaży & wyświetleń produktów: konfiguracja i pomoc
Szybki start
- Prześlij ZIP modułu w "Modules > Module Manager" i otwórz "Configure".
- Włącz "Enable module" oraz wybrane statystyki produktów.
- Na pierwszy test pozostaw "Minimum count to display" na 0.
- W razie potrzeby włącz "Show recent purchases modal".
- Opcjonalnie włącz "Show on product listings", a następnie zapisz.
- Odwiedź produkt w zwykłej sesji gościa w przeglądarce i sprawdź oznaczenie wyświetleń z wartością większą od zera.
- Sprawdź produkt z ważnymi zamówieniami i kliknij oznaczenie sprzedaży, aby przetestować Ostatnie zakupy.
Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.
Instrukcja konfiguracji
Instalacja i pierwsza konfiguracja
- Prześlij ZIP Product Sales & Views Live Stats przez "Modules > Module Manager".
- Otwórz "Configure".
- Pozostaw "Enable module" włączone i wybierz wyświetlane liczniki.
- Na pierwszy test pozostaw "Minimum count to display" na
0, a następnie zapisz. - Odwiedź produkt w zwykłej przeglądarce z identyfikatorem gościa PrestaShop. Odśwież i sprawdź widżet.
- Przetestuj oznaczenie sprzedaży na produkcie z ważnym zamówieniem i otwórz okno ostatnich zakupów.
Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.
Ustawienia wyświetlania
| Ustawienie | Wartość po instalacji | Co robi |
|---|---|---|
| "Enable module" | Tak | Włącza wyświetlanie w sklepie i śledzenie wyświetleń przez hooki modułu. |
| "Show views count" | Tak | Pokazuje różne śledzone identyfikatory gości dla produktu w ruchomym okresie. |
| "Show sales count" | Tak | Pokazuje liczbę różnych ważnych zamówień zawierających produkt, a nie sprzedane sztuki. |
| "Show live viewers" | Tak | Pokazuje różnych gości ze śledzonym wyświetleniem w ostatnim oknie czasowym na żywo. |
| "Show recent purchases modal" | Tak | Pozwala otworzyć okno Ostatnie zakupy przez AJAX po kliknięciu oznaczenia sprzedaży na stronie produktu. |
| "Show on product listings" | Nie | Dodaje na listach oznaczenie samej sprzedaży przez displayProductListReviews. |
| "Minimum count to display" | 0 | Ukrywa widżet produktu, jeśli zarówno włączone, skorygowane wyświetlenia, jak i sprzedaż są poniżej progu. Sami oglądający na żywo nie omijają tej kontroli. Oznaczenia na listach stosują próg do sprzedaży. |
Każda statystyka produktu pojawia się tylko wtedy, gdy jest włączona i większa od zera. Próg 0 nie powoduje wyświetlania oznaczeń zerowych. Oznaczenia na listach mogą pojawiać się niezależnie od przełącznika "Show sales count" na stronie produktu.
Obliczanie liczników
Hook displayHeader zapisuje wyświetlenie tylko na stronach produktów z identyfikatorem produktu i gościa. Kontrole botów odbywają się przed zapisem. Ten sam gość, produkt i sklep nie są zapisywani ponownie przez 30 minut.
Wyświetlana statystyka odsłon liczy różne identyfikatory gości w całym okresie raportowania, nawet jeśli jeden gość ma kilka zapisanych rekordów. Statystyka sprzedaży liczy różne zamówienia z valid = 1 w tym okresie i sklepie. Istniejące ważne zamówienia mogą być uwzględnione od razu; historyczne odsłony sprzed instalacji nie są importowane.
Oglądający na żywo to różni goście zapisani w ostatnim oknie czasowym. Nie jest to ciągły licznik obecności online. Przeglądarka nie wysyła cyklicznych sygnałów podtrzymujących obecność, a eliminowanie duplikatów może przez 30 minut uniemożliwiać aktualizację czasu przy ponownych odsłonach.
Filtrowanie botów korzysta ze zgodnej współdzielonej tabeli mpr_sessions, jeśli jest dostępna. W przeciwnym razie sprawdza user-agent względem typowych wzorców botów i automatyzacji.
Wartości wewnętrzne
Obecny formularz ustawień sprzedawcy udostępnia siedem powyższych ustawień wyświetlania. Poniższe wartości istnieją w pamięci modułu, ale nie mają osobnych kontrolek w tym formularzu. Są to klucze przechowywania, a nie plik konfiguracji do importu.
| Klucz | Wartość po instalacji | Użycie podczas działania |
|---|---|---|
TIMEFRAME_VALUE |
30 | Wielkość przedziału raportowania. |
TIMEFRAME_TYPE |
days |
Akceptuje hours, days lub months. |
VIEWS_BOOST_MULTIPLY |
1.0 | Mnoży liczbę różnych wyświetleń. |
VIEWS_BOOST_FLAT |
0 | Dodaje wartość po przemnożeniu i zaokrągleniu wyświetleń. |
SALES_BOOST_MULTIPLY |
1.0 | Mnoży liczbę różnych zamówień. |
SALES_BOOST_FLAT |
0 | Dodaje wartość po przemnożeniu i zaokrągleniu sprzedaży. |
MODAL_LIMIT |
10 | Maksymalna liczba zwracanych wierszy szczegółów ostatnich zamówień. |
ANONYMIZE |
1 | Maskuje imiona i nazwiska kupujących; nie maskuje miasta ani kraju. |
LIVE_WINDOW |
15 | Okno ostatnich wyświetleń w minutach. |
Wyświetlane odsłony i sprzedaż korzystają z max(0, round(raw * multiplier) + flat). Pozostaw mnożniki na 1.0, a stałe dodatki na 0, aby pokazywać surowe liczniki. Integracja programistyczna może zmienić okres na 24 godziny, 30 dni lub 3 miesiące. Nie ma ustawienia początkowego licznika dla produktu, pola wzorca tekstowego ani wykluczania produktów lub kategorii.
Ostatnie zakupy i położenie w sklepie
Okno pobiera szczegóły ostatnich ważnych zamówień wybranego produktu, w tym domyślnie zamaskowane imię i nazwisko kupującego, miasto, kraj, czas względny, nazwę produktu i ilość. Wiersz ostatniego zakupu to wiersz szczegółów zamówienia; kilka kombinacji w jednym zamówieniu może utworzyć więcej niż jeden wiersz. To inna jednostka niż łączna sprzedaż liczona jako różne zamówienia.
Widżet produktu używa displayProductAdditionalInfo. Wyświetlanie na listach używa displayProductListReviews; przy włączonych listach zasoby przygotowywane są dla stron kategorii, wyszukiwania, producenta, dostawcy, nowości, bestsellerów i obniżek cen.
W niestandardowym motywie pomijającym te hooki dodaj właściwe wywołanie raz:
{hook h='displayProductAdditionalInfo' product=$product}
{hook h='displayProductListReviews' product=$product}
Kontroler AJAX obsługuje action=getRecentOrders i action=getStats, każde z id_product. W integracjach własnych generuj URL modułu narzędziami linków PrestaShop. Dołączony skrypt ładuje okno zakupów; obecność endpointu statystyk nie oznacza ciągłego samodzielnego odświeżania widżetu.
Weryfikacja i rozwiązywanie problemów
- Do testowania odsłon używaj zwykłej przeglądarki. Narzędzia automatyczne mogą być odfiltrowane jako boty. Potwierdź, że przeglądarka ma identyfikator gościa PrestaShop.
- Odwiedź ten sam produkt dwa razy w ciągu 30 minut. Nie powinno to dodać drugiej zapisanej odsłony. Użyj innej sesji gościa, aby sprawdzić liczenie różnych odwiedzających.
- Porównuj sprzedaż z ważnymi zamówieniami utworzonymi w okresie raportowania, a nie z łączną liczbą zamówionych sztuk lub wszystkimi statusami zamówień.
- Jeśli oznaczenie się nie pojawia, sprawdź włączone ustawienia, zerowe liczniki, próg i hooki motywu.
- Jeśli okno nie działa, sprawdź odpowiedź AJAX, błędy JavaScript i połączenie z bazą sklepu. Pamiętaj, że anonimizacja ukrywa tylko imiona i nazwiska.
Style motywu
Używaj .mprpsvls-widget, .mprpsvls-bar i .mprpsvls-listing-badge w arkuszu motywu. Theme Detector udostępnia między innymi --mprpsvls-primary, --mprpsvls-bg i --mprpsvls-border.
.mprpsvls-widget { margin: 12px 0 18px; }
.mprpsvls-bar { --mprpsvls-primary: #1f7a4d; }
.mprpsvls-listing-badge { font-size: 0.75rem; }
Wyłączanie lub odinstalowanie
Wyłącz "Enable module", aby zatrzymać normalne wyświetlanie i śledzenie. Odinstalowanie usuwa konfigurację modułu, menu, rejestrację w Theme Detector i tabelę śledzenia odsłon. Najpierw wykonaj kopię tej tabeli, jeśli potrzebujesz jej historii. Istniejące zamówienia PrestaShop pozostają nienaruszone.
Pytania
3
Czy moduł liczy wyświetlenia i sprzedaż osobno dla każdego sklepu w trybie multistore?
Tak. Wyświetlenia produktów są zapisywane z identyfikatorem sklepu. Wyświetlenia, prawidłowe zamówienia, ostatnio oglądający i ostatnie zakupy są filtrowane według bieżącego sklepu. Statystyka sprzedaży liczy różne prawidłowe zamówienia w tym sklepie, a nie sprzedane sztuki.
Jakie dane odwiedzających zapisuje rejestrator wyświetleń?
Każdy wiersz wyświetlenia zawiera identyfikatory produktu, sklepu i gościa, znacznik czasu oraz wewnętrzny identyfikator wiersza. Nie zawiera imion, nazwisk, adresów e-mail ani adresów IP. Ostatnie zakupy są odczytywane z istniejących zamówień, danych klientów i adresów. Imiona i nazwiska są domyślnie maskowane, a miasto i kraj pozostają widoczne. Sporadyczne czyszczenie usuwa wyświetlenia starsze niż dwukrotność okresu raportowania; odinstalowanie usuwa tabelę wyświetleń.
Jakie dodatkowe obciążenie wprowadzają statystyki na stronach produktów?
Moduł rejestruje kwalifikujące się wyświetlenia produktów, odpytuje włączone liczniki i dodaje swoje zasoby na stronach produktów. Zasoby list są ładowane po włączeniu wyświetlania na listach. Wyniki liczników są używane ponownie w ramach tego samego żądania. Wyłącz zbędne statystyki i zmierz reprezentatywne strony produktów oraz list przed wyborem końcowych ustawień.
Znane problemy
13
Integracja z motywem mogła nie działać z innymi modułami
Powrót do karty animował nieaktualne liczniki
Zapisz i zostań odrzucało ustawienia
Widżet pojawiał się poza stronami produktów
Widżet uruchamiał się dwukrotnie
Odświeżanie zatrzymywało się po pierwszym powrocie do karty
Brak widżetu w PrestaShop 1.6
Wzmocnienie zabezpieczeń
Panel administracyjny modułu mógł się nie otwierać
Brakujące tłumaczenia
Style widżetu niezgodne z łączeniem zasobów
Strony żądań statystyk mogły być indeksowane
Licznik wyświetleń zlicza wizyty botów i crawlerów
Crawlery wyszukiwarek zawyżają licznik wyświetleń produktu. Sam Googlebot dodaje setki „wyświetleń” dziennie.
Informacja o rozwiązaniu
Dodano wykrywanie botów na podstawie User-Agenta z wykorzystaniem utrzymywanej listy sygnatur znanych crawlerów.
Zgłoszenia funkcji
2
Zaimplementowane
Aktywność produktów na żywo
Odświeżanie po powrocie do karty
Dziennik zmian
v1.2.02026-10-04
- Addedself-healing integrity checks for automatic diagnostics and repair
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
Starsze wersje
v1.1.02026-01-29
- AddedPS 9 / Hummingbird theme compatibility
- Addedconfigurable counter labels with translation support
- ImprovedRedis-backed view counter — eliminates per-request DB writes
- Fixedsales counter not updating on multi-currency stores
v1.0.112026-01-20
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedAdd noindex header to stats ajax endpoint
- FixedAdd theme detector support
- FixedUse local CSS path for CCC bundling compatibility
v1.0.02025-10-18
- Initialrelease: real-time product views and sales counters
- InitialLive view counter on listing cards and product detail pages
- InitialSales counter sourced from actual order history
- InitialCompatible with PS 1.7.x and PS 8.x
Demo
Przetestuj pełny moduł przed zakupem
Licencję kupisz później, a ustawienia zostaną.
- Twoje 30-dniowe demo Przetestuj go we własnym sklepie przez 30 dni od pierwszej instalacji.
- Gotowy sklep demo Poznaj gotowy sklep demo w przeglądarce.
- Bez rejestracji Bez konta, adresu e-mail ani domeny sklepu.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.