# 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… - Strona: - Język: pl - Zaktualizowano: 2026-07-30 - Inne języki: [fr](https://www.datafirefly.com/documentation/dftrending/index.md), [en](https://www.datafirefly.com/en/documentation/dftrending/index.md), [es](https://www.datafirefly.com/es/documentation/dftrending/index.md), [de](https://www.datafirefly.com/de/documentation/dftrending/index.md), [it](https://www.datafirefly.com/it/documentation/dftrending/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftrending/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftrending/index.md) - Indeks: ## 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. Żadnych zależności Composera, żadnego zewnętrznego frameworka: archiwum jest samodzielne i działa tak samo od PrestaShop 8.0 do 9.x, zarówno w pojedynczym sklepie, jak i w trybie multistore. ## 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). Każdy zapis ustawień automatycznie czyści wewnętrzny cache: nowe wartości są widoczne w sklepie natychmiast. ## 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.