# Asystent Wyboru Produktu: dokumentacja > Asystent Wyboru Produktu (moduł dffinder) zamienia złożony katalog w prowadzoną ścieżkę zakupową. W panelu administracyjnym budujesz drzewo pytań, odwiedzający odpowiada na nie krok po kroku i trafia na przefiltrowaną selekcję… - Strona: - Język: pl - Zaktualizowano: 2026-08-02 - Inne języki: [fr](https://www.datafirefly.com/documentation/product-finder/index.md), [en](https://www.datafirefly.com/en/documentation/product-finder/index.md), [es](https://www.datafirefly.com/es/documentation/product-finder/index.md), [de](https://www.datafirefly.com/de/documentation/product-finder/index.md), [it](https://www.datafirefly.com/it/documentation/product-finder/index.md), [nl](https://www.datafirefly.com/nl/documentation/product-finder/index.md), [pt](https://www.datafirefly.com/pt/documentation/product-finder/index.md) - Indeks: **Asystent Wyboru Produktu** (moduł `dffinder`) zamienia złożony katalog w prowadzoną ścieżkę zakupową. W panelu administracyjnym budujesz drzewo pytań, odwiedzający odpowiada na nie krok po kroku i trafia na przefiltrowaną selekcję produktów, dokładnie tak, jak poprowadziłby go doradca w sklepie stacjonarnym. ## Wprowadzenie Moduł jest przeznaczony dla katalogów, w których klient się waha: materace, rowery, sprzęt komputerowy, kosmetyki, części zamienne. Każda odpowiedź w ankiecie jest powiązana z jednym lub kilkoma kryteriami Twojego katalogu (atrybuty, cechy, kategorie, producenci, przedziały cenowe), a moduł zamienia wybory odwiedzającego na natywne wyszukiwanie produktów. - Kreator drzewa pytań metodą przeciągnij i upuść, bez kodu. - Pytania jednokrotnego lub wielokrotnego wyboru, wielojęzyczne tytuły i etykiety. - Licznik pasujących produktów aktualizowany na bieżąco na każdym etapie. - Natywna strona wyników (sortowanie i stronicowanie z szablonu) przez `ProductSearchProviderInterface`. - Wyświetlanie jako widżet na stronie głównej, przez znacznik widget lub na dedykowanej stronie. - Zgodność z PrestaShop 8.0 do 9.x, multistore i wielojęzyczność. ## Instalacja 1. Przejdź do _Moduły > Menedżer modułów > Wgraj moduł_. 2. Wybierz archiwum `dffinder-1.0.0.zip` i zatwierdź instalację. 3. Moduł tworzy swoje tabele, zakładkę administracyjną **DF Product Finder** oraz przepisane trasy `product-finder` i `product-finder/results`. Jeśli po instalacji adresy `product-finder` nie odpowiadają, wygeneruj linki ponownie: _Parametry zaawansowane > Wydajność > Wyczyść pamięć podręczną_, a następnie sprawdź, czy przyjazne adresy URL są włączone w sekcji _Ruch i SEO_. ## Tworzenie pierwszego findera Otwórz _Moduły > DF Product Finder_ i kliknij **Dodaj finder**. Nadaj mu nazwę wewnętrzną i tekst wprowadzający wyświetlany na początku ankiety. Kreator jest zorganizowany w kolumny: pytania po lewej, odpowiedzi każdego pytania, a przy każdej odpowiedzi jej mapowania. ### Dodawanie pytań Kliknij **Dodaj pytanie**. Dla każdego pytania uzupełnij: - **tytuł** (na przykład „Do jakiego zastosowania?") i opcjonalny **tekst pomocniczy**; - **typ wyświetlania**: jednokrotny wybór (jedna odpowiedź, z automatycznym przejściem dalej) lub wielokrotny wybór (kilka odpowiedzi do zaznaczenia); - kolejność, przeciągając pytanie na żądaną pozycję. ### Dodawanie odpowiedzi Pod każdym pytaniem dodaj odpowiedzi proponowane odwiedzającemu (na przykład „Sport", „Miasto", „Dziecko"). Każda odpowiedź ma wielojęzyczną etykietę i można ją przestawiać metodą przeciągnij i upuść w obrębie swojego pytania. ### Mapowanie odpowiedzi na katalog To sedno działania modułu: każda odpowiedź wskazuje na jedno lub kilka kryteriów produktowych. Dostępne typy mapowania to: - **Atrybut**: wartość atrybutu kombinacji (rozmiar, kolor i podobne), wyszukiwana na kombinacjach produktu; - **Cecha**: wartość cechy produktu; - **Kategoria**: przynależność do kategorii; - **Producent**: marka produktu; - **Cena**: przedział `min` i `max` dla ceny bazowej sklepu. Pola atrybutu, cechy, kategorii i producenta mają autouzupełnianie: wpisz kilka liter, aby odnaleźć wartość. Jedna odpowiedź może łączyć kilka mapowań, na przykład kategorię _oraz_ przedział cenowy. Przedziały cenowe filtrują po **cenie bazowej netto** produktu dla bieżącego sklepu (`product_shop.price`). Podatki i ceny specjalne (promocje, ceny dla grup) nie są w tym filtrze uwzględniane. Gdy drzewo jest gotowe, kliknij **Zapisz**. Zapis jest idempotentny: całe drzewo jest odbudowywane przy każdym zapisie, co gwarantuje spójny stan. ## Jak działa silnik dopasowania Moduł łączy wybory odwiedzającego według dwóch prostych reguł: - **LUB** pomiędzy odpowiedziami w obrębie jednego pytania: zaznaczenie „Sport" i „Miasto" rozszerza selekcję o produkty pasujące do jednej _lub_ drugiej odpowiedzi. - **I** pomiędzy pytaniami: kryteria z każdego przejścia kumulują się, zawężając selekcję. Na każdym etapie moduł przelicza przez AJAX liczbę pasujących produktów i pokazuje ją odwiedzającemu, co zapobiega dojściu do pustej selekcji. ## Wyświetlanie findera ### Widżet na stronie głównej Włącz wyświetlanie na stronie głównej w konfiguracji modułu. Widżet prezentuje kartę z wezwaniem do działania prowadzącą do ankiety. ### Znacznik widget Aby wstawić finder w dowolnym miejscu szablonu, użyj znacznika Smarty: ``` {widget name='dffinder' id_finder=1} ``` Zastąp `id_finder` identyfikatorem wybranego findera, widocznym na liście w panelu administracyjnym. ### Dedykowane adresy URL Ankieta jest też dostępna bezpośrednio pod przyjaznymi adresami, wygodnymi w kampaniach: - `twoj-sklep/product-finder`: ankieta; - `twoj-sklep/product-finder/results?answers=1,4,9`: strona wyników. ## Strona wyników Na końcu ankiety odwiedzający trafia na stronę wyników, która rozszerza natywny kontroler listingu PrestaShop. W praktyce bez dodatkowych ustawień otrzymujesz: - szablon listy produktów z Twojego motywu; - sortowanie według daty, ceny lub nazwy; - standardowe stronicowanie. Link **Zacznij od nowa** pozwala odwiedzającemu uruchomić ankietę od początku. ## Multistore i wielojęzyczność Moduł jest powiązany z kontekstem sklepu: każdy finder należy do wybranego przez Ciebie sklepu lub sklepów. Wszystkie teksty (nazwa, wprowadzenie, tytuły pytań, etykiety odpowiedzi) można wprowadzać osobno dla każdego języka dzięki przełącznikowi języka edycji u góry kreatora. ## Rozwiązywanie problemów **Licznik stale pokazuje zero.** Sprawdź, czy mapowania wskazują na wartości faktycznie używane przez Twoje produkty (czy atrybut lub cecha są rzeczywiście przypisane do produktów) oraz czy produkty są aktywne i powiązane z bieżącym sklepem. **Przedział cenowy nie filtruje zgodnie z oczekiwaniami.** Pamiętaj, że filtr działa na cenie bazowej netto, bez cen specjalnych. Produkt w promocji jest nadal filtrowany po cenie katalogowej. **Dobra praktyka.** Zacznij od pytania ogólnego (zastosowanie, profil), a potem zawężaj (budżet, rozmiar). Ogranicz każde pytanie do kilku czytelnych odpowiedzi, aby ścieżka pozostała płynna.