Moduł Produkty na Czasie i Popularne Wyszukiwania: kompletny przewodnik

Wprowadzenie

DF Trending dodaje do sklepu PrestaShop 8 lub 9 widżet trendów złożony z trzech niezależnych sekcji: popularne wyszukiwania chwili (chmura klikalnych tagów), produkty zyskujące na popularności (wykrywane na podstawie dynamiki sprzedaży) oraz automatycznie generowana sekcja „teraz na topie”, łącząca odsłony kart produktów i niedawną sprzedaż. Dedykowana zakładka w panelu administracyjnym daje analityczny wgląd w te trzy strumienie.

Instalacja

1. W panelu administracyjnym otwórz Moduły > Menedżer modułów i kliknij Wgraj moduł.
2. Wskaż archiwum dftrending.zip i zatwierdź.
3. Moduł tworzy swoje tabele danych, domyślne wartości konfiguracji oraz zakładkę Statystyki trendów, po czym automatycznie podpina się do strony głównej.

Konfiguracja

Otwórz konfigurację modułu z poziomu Menedżera modułów. Dostępne ustawienia:

• Pokaż popularne wyszukiwania: włącza lub ukrywa chmurę tagów.
• Pokaż produkty zyskujące na popularności: włącza lub ukrywa sekcję opartą na dynamice sprzedaży.
• Pokaż sekcję „teraz na topie”: włącza lub ukrywa sekcję łączącą odsłony i sprzedaż.
• Liczba wyświetlanych wyszukiwań: rozmiar chmury tagów (domyślnie 8).
• Liczba produktów zyskujących na popularności i liczba produktów „teraz na topie”: rozmiar obu siatek produktowych (domyślnie 4).
• Analizowane okno (w dniach): długość okna bieżącego, porównywanego z poprzednim oknem o tej samej długości (domyślnie 7 dni).
• Minimalna sprzedaż uprawniająca do kwalifikacji: próg, poniżej którego produkt nigdy nie jest uznawany za rosnący (domyślnie 2).
• Czas życia cache (w sekundach): czas, przez jaki wyliczone trendy są używane ponownie bez odpytywania bazy (domyślnie 3600).

Zasada działania

Popularne wyszukiwania

Moduł nasłuchuje natywnej wyszukiwarki PrestaShop. Każde zapytanie jest normalizowane (małe litery, zredukowane spacje, długość od 2 do 64 znaków), a następnie agregowane według dnia, języka i sklepu. Chmura wyświetla najczęstsze zapytania z analizowanego okna, a każdy tag prowadzi do odpowiedniej strony wyników.

Produkty zyskujące na popularności

Ilości sprzedane w bieżącym oknie są porównywane z ilościami z poprzedniego okna o tej samej długości. Uwzględniane są wyłącznie prawidłowe zamówienia. Wynik rankingowy waży wzrost przez bieżący wolumen: produkt, który przechodzi z 50 na 90 sprzedaży, wyprzedza produkt, który przechodzi z 2 na 4. Produkty nieaktywne lub niewidoczne są wykluczane.

Sekcja „teraz na topie”

Każda odwiedzona karta produktu wysyła lekki sygnał z przeglądarki, jeden raz na produkt i na sesję. To zliczanie po stronie klienta pozostaje dokładne również za pełnostronicowym cache. Wynik łączy odsłony i niedawną sprzedaż (jedna sprzedaż waży pięć razy więcej niż jedna odsłona), a produkty obecne już w sekcji rosnących są automatycznie odfiltrowywane jako duplikaty.

Umieszczenie widżetu

Domyślnie widżet wyświetla się na stronie głównej (hook displayHome). Moduł implementuje interfejs widżetu PrestaShop: w Wygląd > Pozycje możesz podpiąć go do dowolnego hooka wyświetlania w swoim motywie. Produkty są renderowane z natywnymi miniaturami motywu, w samodzielnej siatce, która nie zależy od jego styli.

Panel statystyk w administracji

Zakładka Statystyki trendów (w menu Moduły) wyświetla trzy panele: ranking wyszukiwań z ostatnich 30 dni wraz z liczbą wystąpień, produkty rosnące z bieżącą sprzedażą, sprzedażą poprzednią i procentem wzrostu oraz produkty najczęściej oglądane w analizowanym oknie. Każdy produkt jest połączony bezpośrednio ze swoją kartą edycji.

Dane i prywatność

Moduł nie zapisuje żadnych danych osobowych: ani identyfikatora klienta, ani adresu IP, ani ciasteczka śledzącego. Przechowywane są wyłącznie anonimowe liczniki dzienne (zapytanie i liczba, produkt i liczba), a wszystkie dane starsze niż 90 dni są czyszczone automatycznie.

Rozwiązywanie problemów

• Widżet nic nie wyświetla: to normalne w sklepie bez historii, każda sekcja pozostaje ukryta, dopóki nie ma istotnych danych. Sprawdź również, czy sekcje są włączone w konfiguracji.
• Produkty układają się jeden pod drugim: wyczyść cache PrestaShop i wymuś przeładowanie arkuszy stylów (Ctrl+F5) po aktualizacji modułu.
• Odsłony nie są zliczane: sprawdź, czy żaden bloker nie filtruje pliku front.js modułu i czy kontroler front track poprawnie odpowiada (oczekiwana jest odpowiedź JSON).

Historia wersji

• 1.0.2 (2026-07-12): pierwsza wersja publiczna, popularne wyszukiwania, dynamika sprzedaży, sekcja „teraz na topie”, panel statystyk, wewnętrzny cache, automatyczne czyszczenie danych.