Smart Search Pro – inteligentna wyszukiwarka produktów dla PrestaShop

Własny silnik wyszukiwania i indeks produktów

• Wbudowany backend MySQL: podstawowy wariant modułu działa na bazie danych sklepu i nie wymaga abonamentu za zewnętrzny silnik wyszukiwania. Produkty są przetwarzane do własnego indeksu, przygotowanego pod wyszukiwanie tekstowe, kody produktów, filtrowanie, sortowanie i prezentację wyników.
• Opcjonalne backendy Meilisearch i Typesense: administrator może przełączyć silnik na jedną z obsługiwanych usług zewnętrznych, podać adres, klucz API, prefiks indeksu i limit czasu połączenia. Jest to możliwość dodatkowa; sklep może pozostać przy silniku MySQL.
• Awaryjny fallback: ustawienie powrotu do natywnego wyszukiwania PrestaShop pozwala zachować podstawową obsługę zapytań, gdy wybrany backend wyszukiwania nie odpowiada.
• Indeks rozdzielony według sklepu i języka: dokumenty, facety, analityka oraz dane zarządzane przez moduł uwzględniają bieżący kontekst sklepu i języka. Dzięki temu wyniki mogą odpowiadać właściwemu katalogowi, tłumaczeniom i konfiguracji multistore.
• Indeksowanie bez feedu produktowego: moduł pobiera dane bezpośrednio z PrestaShop. Nie trzeba przygotowywać osobnego pliku XML lub CSV tylko po to, aby zasilić wyszukiwarkę.
• Indeks blue/green: pełna przebudowa jest wykonywana w nowej generacji indeksu, a przełączenie na przygotowany zestaw danych odbywa się po zakończeniu procesu. Dotychczasowa aktywna generacja może nadal obsługiwać wyszukiwanie podczas budowy nowej.

Zakres danych uwzględnianych podczas wyszukiwania

Administrator nie jest ograniczony wyłącznie do nazwy produktu. Moduł ma panel pól wyszukiwania, w którym można kontrolować zakres informacji wykorzystywanych do odnajdywania produktów.

• Kody i identyfikatory handlowe: wyszukiwanie obejmuje referencję produktu i dostawcy, EAN-13, UPC, ISBN oraz MPN. Pole kodów pozostaje podstawowym elementem indeksu, co ułatwia odnajdywanie konkretnego produktu po oznaczeniu technicznym.
• Nazwa, marka i kategorie: moduł może dopasowywać zapytanie do nazwy produktu, producenta lub marki oraz nazw kategorii przypisanych do produktu.
• Tagi, cechy i atrybuty: do indeksu mogą trafić tagi produktowe, wartości cech oraz atrybuty kombinacji, dzięki czemu klient może szukać również po parametrach i wariantach opisujących ofertę.
• Opis krótki i opis pełny: administrator może wykorzystywać treść opisową produktów jako dodatkowe źródło dopasowania, z inną wagą niż nazwa lub kod.
• Konfigurowalne wagi pól: panel kryteriów trafności pozwala ustalić, które informacje mają większy wpływ na kolejność wyników. Wyszukiwanie po dokładnym kodzie może więc mieć inne znaczenie niż słowo występujące wyłącznie w długim opisie.

Autouzupełnianie i wyszukiwanie podczas wpisywania

• Natychmiastowe sugestie produktów: po włączeniu autouzupełniania moduł pobiera wyniki w trakcie wpisywania frazy. Klient może szybciej rozpoznać właściwy produkt i przejść do jego strony bez oczekiwania na pełne przeładowanie wyników.
• Podpowiedzi słów kluczowych: moduł może prezentować powiązane frazy wyprowadzone z indeksu produktów. Limit widocznych podpowiedzi jest konfigurowalny.
• Tolerancja literówek: dostępne są tryby zrównoważony, zachowawczy i wyłączony. Pozwala to dopasować wyszukiwanie przybliżone do rodzaju asortymentu, długości kodów i oczekiwanego poziomu swobody przy błędnie wpisanych słowach.
• Kontrola zapytań asynchronicznych: skrypt frontowy używa opóźnienia wpisywania, przerywania nieaktualnych zapytań i ochrony kolejności odpowiedzi, aby starszy wynik nie zastąpił nowszej frazy klienta.
• Interfejs dostępny z klawiatury: autouzupełnianie wykorzystuje semantykę combobox oraz atrybuty ARIA, wspierając poruszanie się po podpowiedziach bez użycia myszy.

Pełnoekranowy modal wyszukiwania

• Wyniki bez opuszczania bieżącej strony: po kliknięciu pola wyszukiwania moduł może otworzyć rozbudowany modal z wynikami produktów, podpowiedziami i narzędziami zawężania listy.
• Konfigurowalny rozmiar: szerokość i wysokość modala na desktopie są ustawiane procentowo względem okna przeglądarki. Przy dużym wariancie filtry mogą tworzyć osobną kolumnę obok produktów.
• Responsywna siatka produktów: liczba produktów w jednym wierszu jest ustawiana niezależnie dla desktopu, tabletu i telefonu. Pozwala to dopasować gęstość wyników do projektu sklepu i rozmiaru ekranu.
• Dwa sposoby przeglądania kolejnych wyników: administrator wybiera automatyczne doładowywanie podczas przewijania albo klasyczną paginację. Konfigurowalny jest również limit produktów pobieranych w jednej partii lub na stronie.
• Kategorie i facety w modalu: klient może zawęzić wyniki za pomocą pasujących kategorii i tego samego zestawu facetów, który obowiązuje na standardowej stronie wyszukiwania.
• Zwijanie filtrów podczas wpisywania: opcjonalnie blok filtrów pozostaje domyślnie zwinięty, aby na mniejszych ekranach i w trakcie pisania nie zasłaniał listy produktów. Stan sekcji jest synchronizowany także podczas ładowania, braku wyników i obsługi błędu.
• Widok odkrywania oferty: przed wpisaniem frazy modal może pokazywać ostatnie wyszukiwania, popularne skuteczne zapytania oraz ręcznie wybrane produkty rekomendowane.

Rozbudowana strona wyników wyszukiwania

• Natywna integracja z mechanizmem list produktów PrestaShop: moduł dostarcza własnego providera wyników, a jednocześnie korzysta ze struktury listy produktów i mechanizmu sortowania platformy.
• Niezależne włączanie: strona wyników, autouzupełnianie i modal mają osobne przełączniki. Umożliwia to stopniowe wdrożenie funkcji oraz pozostawienie tylko tych elementów, które są potrzebne w konkretnym sklepie.
• Osobna siatka responsywna: liczba kart produktu w wierszu na stronie wyników jest konfigurowana niezależnie dla desktopu, tabletu i telefonu.
• Dwa układy facetów: filtry można umieścić jako zwarty panel nad produktami albo jako rozwiniętą lewą kolumnę. Wariant lewej kolumny potrafi utworzyć układ dwukolumnowy także na pełnoszerokiej stronie wyników, a na urządzeniach mobilnych filtry pozostają dostępne w szufladzie.
• Sortowanie wyników: klient może wybrać trafność, produkty dostępne najpierw, nazwę A–Z lub Z–A oraz cenę rosnącą albo malejącą.
• Polityka produktów niedostępnych: administrator może całkowicie wykluczyć produkty, których obecnie nie można zamówić, albo pozostawić je widoczne i przesunąć na koniec listy. Moduł uwzględnia stan, ustawienie sprzedaży przy braku stanu oraz flagę dostępności produktu do zamówienia.
• Pomoc przy pustym zapytaniu: na stronie wyników można włączyć ostatnie wyszukiwania, popularne frazy i produkty rekomendowane, zamiast pozostawiać klienta z pustym widokiem.

Filtry i facety dopasowane do katalogu

• Wspólna konfiguracja dla modala i strony wyników: kolejność, aktywność i sposób prezentacji facetów są zarządzane w jednym miejscu, dzięki czemu klient otrzymuje spójne filtry w obu widokach.
• Standardowe facety katalogowe: moduł obsługuje kategorię, markę, dostępność i zakres ceny.
• Dynamiczne facety produktów: grupy atrybutów oraz cechy są pobierane z katalogu i otrzymują stabilne identyfikatory. Pozwala to osobno skonfigurować na przykład rozmiar, kolor, materiał, pojemność lub dowolną inną grupę istniejącą w sklepie.
• Facety handlowe: dostępne są filtry nowości, bestsellerów z ostatnich 30 dni i produktów objętych aktywną promocją cenową.
• Różne formy prezentacji: dla każdej encji można wybrać checkboxy, pigułki albo wybór wielokrotny z usuwalnymi aktywnymi wartościami. Konfiguracja nie narzuca jednego globalnego sposobu wyświetlania wszystkim filtrom.
• Indywidualna kolejność i limity: administrator ustala kolejność facetów oraz maksymalną liczbę widocznych wartości osobno dla każdej encji. Kolejność można zmieniać metodą przeciągnij i upuść lub przyciskami dostępnymi z klawiatury.
• Szybkie wyszukiwanie wartości: gdy facet zawiera dużo opcji, moduł może pokazać wewnętrzne pole wyszukiwania. Próg jego uruchomienia jest konfigurowany oddzielnie dla modala i strony wyników.
• Aktywne filtry i bezpieczne adresy: wybrane wartości są prezentowane klientowi jako aktywne filtry, a kod modułu waliduje dopuszczalne typy filtrów i zakresy cen przed przekazaniem ich do backendu.

Synonimy, trafność i kontrola jakości wyników

• Synonimy zarządzane w Back Office: można połączyć określenia potoczne, skróty, alternatywne nazwy oraz różne warianty słownictwa stosowane przez klientów. Rozszerzenie zapytania odbywa się w warstwie wyszukiwania, bez przepisywania nazw produktów.
• Konfigurowalne kryteria trafności: administrator może ustawić kolejność dodatkowych kryteriów wykorzystywanych przy wynikach o zbliżonym dopasowaniu tekstowym.
• Podgląd wyszukiwania w panelu: osobna zakładka pozwala sprawdzić działanie frazy przed oceną wyników na froncie sklepu. Moduł przygotowuje również informacje wyjaśniające dopasowanie i punktację wyników.
• Odzyskiwanie po braku wyników: warstwa wyszukiwania zawiera mechanizm przygotowania alternatyw dla zapytań, które nie zwróciły produktów, zamiast ograniczać cały proces do pustej listy.
• Kontrola produktów dostępnych do zakupu: zasady trafności można połączyć z polityką wykluczania lub obniżania pozycji niedostępnego asortymentu.

Merchandising wyników wyszukiwania

• Reguły zależne od zapytania: warunek może odpowiadać dokładnej frazie, prefiksowi albo fragmentowi zapytania. Regułę można ograniczyć do bieżącego języka lub zastosować we wszystkich językach.
• Przypinanie produktu: wybrany produkt może zostać umieszczony na konkretnej pozycji wyników dla zapytania objętego regułą.
• Promowanie i obniżanie pozycji: akcje boost oraz bury zmieniają wynik punktowy wskazanych produktów za pomocą konfigurowalnego mnożnika.
• Wykluczanie z wyników: reguła może usunąć wskazane produkty z listy dla określonej frazy bez dezaktywowania ich w katalogu.
• Priorytet, status i harmonogram: reguły mają nazwę wewnętrzną, priorytet, status roboczy lub publikacyjny oraz opcjonalny czas rozpoczęcia i zakończenia działania.
• Deterministyczne rozstrzyganie konfliktów: gdy kilka reguł pasuje do tego samego zapytania, moduł rozstrzyga ich działanie według typu akcji, priorytetu i identyfikatora reguły.

Przekierowania zapytań i kampanie banerowe

• Przekierowania wyszukiwania: wybraną frazę lub zestaw terminów można skierować na kontrolowany adres docelowy, na przykład stronę kategorii, producenta, produktu albo przygotowany landing page.
• Walidacja adresów docelowych: resolver przekierowań zawiera ochronę przed otwartymi przekierowaniami, dzięki czemu funkcja nie sprowadza się do bezwarunkowego użycia dowolnego adresu przesłanego w zapytaniu.
• Dopasowanie kampanii do frazy: banery mają listę wyzwalaczy i tryb dopasowania zapytania. Kampanię można przeznaczyć dla strony wyników, modala, autouzupełniania albo wszystkich obsługiwanych miejsc.
• Osobne obrazy desktopowe i mobilne: moduł przechowuje ścieżkę grafiki podstawowej oraz opcjonalnej grafiki mobilnej, tekst alternatywny i adres docelowy. Baner bez adresu może być wyświetlany jako nieklikalny element informacyjny.
• Język, priorytet i harmonogram: kampanie są zarządzane dla wybranego języka, mają stan aktywności, priorytet oraz opcjonalną datę początku i końca emisji.
• Pomiar kampanii: po włączeniu analityki i uzyskaniu zgody moduł może rejestrować wyświetlenia oraz kliknięcia banerów, łącząc funkcję promocyjną z raportowaniem.

Rekomendowane produkty i odkrywanie oferty

• Ręcznie wybrane rekomendacje: administrator tworzy uporządkowaną listę produktów, które mają być prezentowane przed wpisaniem zapytania lub na pustej stronie wyników.
• Osobne przełączniki widoków: rekomendacje, popularne frazy i ostatnie wyszukiwania można włączać niezależnie dla modala oraz strony wyników.
• Ostatnie wyszukiwania po stronie przeglądarki: historia ostatnich fraz jest przechowywana lokalnie w przeglądarce klienta, a jej maksymalna długość jest konfigurowalna.
• Popularne skuteczne frazy: moduł wylicza listę na podstawie zagregowanej analityki z wybranego okresu. Administrator ustala liczbę pozycji i długość analizowanego okresu.

Analityka wyszukiwania i atrybucja sprzedaży

• Najważniejsze KPI wyszukiwarki: dashboard pokazuje liczbę wyszukiwań, kliknięcia, współczynnik CTR, wyszukiwania bez kliknięcia oraz frazy, które nie zwróciły produktów.
• Analiza fraz i produktów: raporty pomagają sprawdzić, czego szukają klienci, które produkty są widoczne i klikane oraz na jakich pozycjach dochodzi do interakcji.
• Analiza użycia filtrów: moduł agreguje zdarzenia związane z facetami, dzięki czemu można ocenić, które filtry i wartości rzeczywiście pomagają klientom zawężać katalog.
• Koszyki, zamówienia i przychód: mechanizm atrybucji łączy kliknięcia z późniejszym dodaniem produktu do koszyka i zamówieniem. Osobno konfigurowane są okna atrybucji bezpośredniej i wspomaganej.
• Podział według języka i urządzenia: agregaty dzienne mogą być analizowane w kontekście języka oraz typu urządzenia, co ułatwia oddzielenie zachowania użytkowników desktopowych i mobilnych.
• Eksport CSV: dane o frazach, produktach i filtrach można eksportować do dalszej analizy poza panelem PrestaShop.
• Konfigurowalna retencja: czas przechowywania surowych zdarzeń analitycznych jest ustawiany w dniach, natomiast zagregowane statystyki dzienne mogą pozostać dostępne dłużej.
• Uwzględnienie zgody analitycznej: moduł ma bramkę zgody i oddziela zdarzenia objęte zgodą od ograniczonych agregatów. Nie należy tego traktować jako zastępstwa konfiguracji platformy zgód w sklepie, lecz jako mechanizm respektowania jej stanu przez funkcje modułu.

Alerty jakości i panel optymalizacji

• Alerty wyszukiwań bez wyników: administrator ustala poziom ostrzegawczy i krytyczny dla udziału zapytań, które nie znalazły produktów.
• Alerty braku kliknięć i spadku CTR: moduł może sygnalizować pogorszenie zachowania klientów po przekroczeniu skonfigurowanych progów i minimalnej wielkości próbki.
• Kontrola świeżości indeksu: dashboard ostrzega, gdy ostatnie pełne indeksowanie jest starsze niż dozwolona liczba godzin.
• Kontrola kolejki: osobne progi ostrzegawcze i krytyczne informują o narastającej liczbie zadań oczekujących, opóźnionych lub przetwarzanych.
• Szanse optymalizacyjne: panel zestawia dane o problematycznych frazach i produktach, aby administrator mógł zdecydować, czy potrzebny jest synonim, przekierowanie, zmiana danych produktu albo reguła merchandisingowa.

Indeksowanie, kolejka i automatyczne utrzymanie

• Pełna przebudowa indeksu: panel indeksowania pozwala uruchomić kompletną generację danych dla aktywnych kontekstów sklepu i języka.
• Kolejka zmian katalogowych: dodanie, aktualizacja lub usunięcie produktu, zmiana stanu magazynowego, kategorii, ceny specjalnej i wybranych danych powiązanych powodują dodanie odpowiedniego zadania do kolejki zamiast wykonywania ciężkiej przebudowy w samym hooku.
• Deduplikacja i ponawianie zadań: repozytorium kolejki łączy powtarzające się operacje, obsługuje przejmowanie zadań przez worker oraz ponawianie z narastającym opóźnieniem.
• Reconciler indeksu: operacja uzgadniania wykrywa brakujące, nadmiarowe lub nieaktualne dokumenty i kolejkuje ograniczoną naprawę.
• Zadania CRON: moduł udostępnia akcje do pracy workera, uzgadniania i pełnej przebudowy. Panel Back Office pokazuje gotowe informacje potrzebne do skonfigurowania lokalnego albo zewnętrznego harmonogramu.
• Zabezpieczenie zdalnego CRON-u: endpoint obsługuje podpis HMAC i nonce, a cięższe operacje są oddzielone od publicznego procesu wyszukiwania.
• Health check i diagnostyka: moduł ma endpoint stanu oraz panele diagnostyczne, które pomagają sprawdzić backend, indeks i konfigurację przed włączeniem funkcji na froncie.

Import i eksport kompletnej konfiguracji

• Przenośny plik konfiguracji: eksport obejmuje ustawienia backendu, frontu, modala, strony wyników, analityki, pól wyszukiwania, kryteriów trafności i facetów.
• Dane zarządzane w module: razem z ustawieniami można przenieść rekomendowane produkty, synonimy, reguły merchandisingowe, banery i przekierowania.
• Mapowanie języków: sekcje wielojęzyczne są przenoszone według locale lub kodu ISO, a nie wyłącznie według lokalnego identyfikatora języka.
• Przenoszenie produktów po stabilnych oznaczeniach: rekomendacje i produkty używane w regułach mogą być mapowane na podstawie referencji, EAN lub UPC, co ogranicza ryzyko przypisania danych do innego produktu po migracji.
• Walidacja przed zapisem: import wykonuje kontrolę schematu i danych wejściowych przed rozpoczęciem zmian. Zapis jest transakcyjny, a w przypadku błędu moduł podejmuje rollback zamiast pozostawiać częściowo zaimportowaną konfigurację.
• Tryb łączenia lub zastępowania: administrator wybiera sposób zastosowania pliku, a destrukcyjny wariant zastępujący wymaga świadomego potwierdzenia.
• Ochrona sekretów: klucze API mogą pozostać zredagowane, natomiast globalny sekret podpisu CRON nie jest traktowany jako przenośny element konfiguracji środowiska.

Bezpieczeństwo, wydajność i kontrolowane wdrożenie

• Front domyślnie wyłączony po instalacji: autouzupełnianie, strona wyników, modal i analityka mają osobne przełączniki, więc administrator może najpierw zbudować indeks i sprawdzić wyniki w podglądzie.
• Rate limiting zdarzeń: endpoint analityczny ma konfigurowalny limit krótkiego burstu oraz tempo odnawiania, aby pojedynczy użytkownik nie generował nieograniczonej liczby zapisów.
• Circuit breaker wyszukiwania: orkiestrator ogranicza ponawianie żądań do niedostępnego backendu i współpracuje z ustawieniem natywnego fallbacku.
• Bez modyfikowania Core: moduł nie wymaga override klas PrestaShop ani ręcznego przepisywania plików motywu. Integruje się przez hooki, providera wyszukiwania i własne zasoby frontowe.
• Warunkowe ładowanie funkcji frontowych: zasoby i konfiguracja są dodawane wtedy, gdy aktywne jest autouzupełnianie, modal albo strona wyników.
• Obsługa danych po odinstalowaniu: dane modułu są domyślnie zachowywane, a ich usunięcie wymaga wcześniejszego włączenia odpowiedniej opcji w ustawieniach.

Korzyści dla sklepu internetowego

• Krótsza droga do produktu: klient otrzymuje wyniki już podczas wpisywania, może poprawić nieprecyzyjne zapytanie i od razu zawęzić listę według cech katalogu.
• Lepsze wykorzystanie danych produktowych: nazwy, kody, marki, kategorie, tagi, cechy, atrybuty i opisy pracują wspólnie zamiast pozostawać osobnymi, niewykorzystywanymi źródłami informacji.
• Kontrola biznesowa nad kolejnością wyników: administrator może promować, obniżać, przypinać lub wykluczać produkty dla konkretnych fraz bez przebudowy całej struktury kategorii.
• Decyzje oparte na danych: raporty pokazują nie tylko liczbę zapytań, lecz również kliknięcia, brak wyników, użycie filtrów, koszyki, zamówienia i przychód powiązany z wyszukiwaniem.
• Rozwiązanie skalowalne funkcjonalnie: sklep może zacząć od wbudowanego MySQL, a później przełączyć backend na Meilisearch lub Typesense, zachowując panel zarządzania i funkcje frontowe modułu.

Kompatybilność

PD Smart Search Pro jest przygotowany dla PrestaShop 1.7.x, 8.x i 9.x, PHP 7.0–8.5 oraz MySQL 5.6+ lub MariaDB 10.x+. Moduł obsługuje klasyczne i nowsze środowiska PrestaShop bez obowiązkowej zewnętrznej usługi wyszukiwania, a integracje Meilisearch i Typesense pozostają opcjonalnym wyborem administratora.

Link do demo modułu:

Demo panel administracyjny:
https://moduly-prestashop.eu/pdsmartsearchpro/admin-dev

Demo panel przedni:
https://moduly-prestashop.eu/pdsmartsearchpro