PS PrestaShop Początkujący

Inteligentne Live Search — Kompletny przewodnik

Instalacja, konfiguracja i używanie DF Live Search 2.1: panel natychmiastowego wyszukiwania, opcjonalne filtry, hybrydowe wyszukiwanie semantyczne, samouczenie, reguły merchandisingu, synonimy, przekierowania i panel statystyk dla PrestaShop 1.7.8, 8 i 9.

Zaktualizowano Wersja modułu 2.1.1

Przegląd i wymagania

DF Live Search zastępuje wyszukiwarkę sklepu panelem natychmiastowego wyszukiwania. Przed wpisaniem pokazuje ostatnie wyszukiwania odwiedzającego, popularne wyszukiwania i polecane produkty. Podczas wpisywania oferuje uzupełnianie w polu, podpowiedzi i siatkę wyników z bezpośrednim dodawaniem do koszyka. Filtry (cena, dostępność, kategorie, marki, atrybuty, cechy) i sortowanie są dostępne jako opcja.

  • Zgodny z PrestaShop od 1.7.8 do 9.x, motywami Hummingbird, Classic i pochodnymi oraz motywem Warehouse (iqit).
  • PHP od 7.4 do 8.5.
  • Wielojęzyczny (FR, EN, ES, DE, IT, PT, PL, NL) i multistore.
  • Bez nadpisań (override), bez zasobów zewnętrznych.
Panel DF Live Search: ostatnie wyszukiwania, popularne wyszukiwania i polecane produkty
Panel DF Live Search: ostatnie wyszukiwania, popularne wyszukiwania i polecane produkty

Instalacja i aktualizacja

  1. Pobierz dflivesearch-2.1.1.zip ze swojego konta klienta.
  2. W panelu administracyjnym otwórz Moduły > Menedżer modułów, kliknij Prześlij moduł i przeciągnij archiwum.
  3. Kliknij Konfiguruj.

Podczas instalacji moduł tworzy swoje tabele, buduje własny indeks wyszukiwania i słownik korekty oraz wstępnie wypełnia popularne synonimy w każdym języku. Wyszukiwanie działa od razu: domyślnie pole wyszukiwania motywu otwiera panel.

Aktualizacja z wersji 1.x: prześlij nowy plik zip w Menedżerze modułów i uruchom aktualizację. Ustawienia, synonimy i statystyki zostają zachowane. Nowe opcje zachowują działanie wersji 1.x (pasek modułu i pola motywu, widoczne indeksy) i filtry pozostają wyłączone, dopóki ich nie włączysz. Zapisane wcześniej adresy IP zostają zastąpione anonimowym skrótem.

Po aktualizacji wyczyść pamięć podręczną PrestaShop (Zaawansowane > Wydajność). Jeśli motyw łączy pliki CSS i JS (CCC), nowy skrypt zostanie od razu załadowany.

Ustawienia ogólne

Strona konfiguracji jest podzielona na zakładki, z podglądem na żywo po prawej, który odzwierciedla ustawienia (kolory, układ, zawartość kart). Zakładka Ogólne zawiera:

  • Układ panelu: Nakładka (duży panel nad stroną) lub Lista rozwijana (otwiera się pod paskiem wyszukiwania, na pełnym ekranie na telefonie).
  • Pasek wyszukiwania: Pasek motywu (pole wyszukiwania motywu otwiera panel, zalecane), Pasek modułu (zastępuje standardowy pasek wyszukiwania PrestaShop) lub Oba (działanie wersji 1.x).
  • Tekst zastępczy pola dla każdego języka, liczba znaków przed rozpoczęciem wyszukiwania, produkty na stronę (kolejne ładuje przycisk „Pokaż więcej produktów”).
  • Skrót klawiaturowy: Ctrl+K (⌘K na Macu) lub / otwiera wyszukiwanie z dowolnej strony.
  • Używaj tej wyszukiwarki na stronie wyników: pełna strona wyników PrestaShop pokazuje wtedy te same produkty w tej samej kolejności co panel.
Panel administracyjny: ustawienia ogólne z podglądem na żywo
Panel administracyjny: ustawienia ogólne z podglądem na żywo
Układ listy rozwijanej otwieranej z paska wyszukiwania
Układ listy rozwijanej otwieranej z paska wyszukiwania

Wygląd i karty produktów

  • Kolor główny i kolor po najechaniu (przyciski, aktywne filtry, fokus), z proponowanymi kolorami.
  • Maksymalna szerokość panelu: na przykład 1320px, 100% lub 90vw.
  • Pasek modułu: wysokość, maksymalna szerokość i zaokrąglenie (0 = prostokąt, 50 = pigułka).
  • Karty produktów: ceny, rabaty (przekreślona cena i procent), marka, indeks, przycisk „Dodaj do koszyka”, wybór ilości, rozmiar zdjęć.

Zasady PrestaShop obowiązują zawsze: tryb katalogu, grupy klientów bez cen i produkty z wyłączonym „Pokaż cenę” nigdy nie pokazują ceny ani przycisku koszyka. Ceny zależą od grupy odwiedzającego (brutto lub netto), jej rabatów i waluty.

Panel administracyjny: kolory, pasek wyszukiwania i zawartość kart produktów
Panel administracyjny: kolory, pasek wyszukiwania i zawartość kart produktów

Panel wyszukiwania w sklepie

Przed wpisaniem

Zakładka Pusty panel określa, co widzą odwiedzający po otwarciu:

  • Ostatnie wyszukiwania: przechowywane tylko w przeglądarce odwiedzającego, można je usuwać pojedynczo lub wszystkie naraz.
  • Popularne wyszukiwania: automatyczne (statystyki), Twoja lista dla każdego języka lub Twoja lista uzupełniona statystykami. Zapytanie pojawia się tylko wtedy, gdy znalazło produkty dla minimalnej liczby różnych odwiedzających (domyślnie 2): nikt nie może więc opublikować tekstu na tej liście. Możesz wykluczyć słowa; linki i adresy e-mail są zawsze wykluczone.
  • Polecane produkty: bestsellery, potem nowości, Twój wybór (wyszukiwanie, przeciąganie lub strzałki do ustalenia kolejności) albo personalizacja dla zalogowanych klientów.

Podczas wpisywania

Panel pokazuje uzupełnianie w polu (akceptacja klawiszem Tab lub →), etykiety podpowiedzi, pasujące kategorie i marki, liczbę wyników i siatkę produktów. Szukane słowa są pogrubione. Po podpowiedziach można poruszać się klawiaturą (strzałki, Enter, Esc), a liczba wyników jest odczytywana przez czytniki ekranu.

Wpisywanie zapytania: uzupełnianie w polu, podpowiedzi i natychmiastowe wyniki
Wpisywanie zapytania: uzupełnianie w polu, podpowiedzi i natychmiastowe wyniki

Dodawanie do koszyka

Przycisk koszyka korzysta z kontrolera koszyka PrestaShop: stany magazynowe, minimalne ilości i reguły koszyka są respektowane. W panelu pojawia się potwierdzenie z linkiem do koszyka, a koszyk w nagłówku się aktualizuje. Produkty z kombinacjami pokazują „Wybierz opcje”, co otwiera kartę produktu.

Dodawanie do koszyka bezpośrednio z wyników wyszukiwania
Dodawanie do koszyka bezpośrednio z wyników wyszukiwania

Filtry i sortowanie (opcjonalne)

Filtry są domyślnie wyłączone. Włącz je w zakładce Filtry i sortowanie, zaznacz filtry do wyświetlenia i przeciągnij je (lub użyj strzałek), aby ustalić kolejność:

  • Cena: podwójny suwak i pola min/max, w walucie i trybie wyświetlania podatku odwiedzającego.
  • Dostępność: produkty w magazynie.
  • Kategorie i marki.
  • Wybrane atrybuty i cechy katalogu (próbki kolorów dla kolorów).

Liczniki aktualizują się przy każdym wyborze, a wartości tego samego filtra można zaznaczać razem. Długie listy mają pole wyszukiwania i link „Pokaż więcej”. Aktywne filtry pojawiają się jako etykiety nad wynikami. Menu sortowania oferuje trafność, cenę rosnąco lub malejąco, nowości, bestsellery i nazwę; oferowane sortowania wybierasz w tej samej zakładce.

Wyniki wyszukiwania z filtrami ceny, dostępności, kategorii, marki i koloru
Wyniki wyszukiwania z filtrami ceny, dostępności, kategorii, marki i koloru
Aktywne filtry z etykietami i zaktualizowanymi licznikami
Aktywne filtry z etykietami i zaktualizowanymi licznikami
Panel administracyjny: filtry do włączenia i uporządkowania, opcje sortowania
Panel administracyjny: filtry do włączenia i uporządkowania, opcje sortowania

Na telefonie

Na telefonie panel otwiera się na pełnym ekranie, siatka przechodzi na dwie kolumny, a filtry otwierają się w szufladzie z przyciskiem „Pokaż N wyników”. Podpowiedzi przewijają się poziomo pod polem.

Panel wyszukiwania na telefonie przed wpisywaniem
Panel wyszukiwania na telefonie przed wpisywaniem
Wyniki wyszukiwania na telefonie
Wyniki wyszukiwania na telefonie
Filtry wyszukiwania w szufladzie na telefonie
Filtry wyszukiwania w szufladzie na telefonie

Trafność i tolerancja literówek

Zawsze aktywne: ignorowanie akcentów i wielkości liter, liczba mnoga w 8 językach („lampy” znajduje „lampa”), słowa w dowolnej kolejności, słowa z łącznikiem („t-shirt” = „tshirt”), dopasowanie już podczas wpisywania, indeksy produktów i kombinacji, EAN, UPC, MPN i indeksy dostawców. Jeśli zapytanie jest indeksem kombinacji, wynik otwiera dokładnie tę kombinację.

Zakładka Trafność ustawia:

  • Podpowiedzi i uzupełnianie oraz ich maksymalną liczbę.
  • Szukaj w markach: „marka + produkt” działa, nawet gdy marki nie ma w nazwie.
  • Tolerancję literówek i maksymalną liczbę błędów na słowo (zalecane 2; słowa do 4 liter dopuszczają jeden). Gdy zapytanie nic nie znajduje, próbowane są najbliższe słowa z katalogu.
  • Informowanie odwiedzających o korektach: „Wyniki dla… Zamiast tego szukaj…” z linkiem do pierwotnej pisowni.
  • Najpierw produkty dostępne i najpierw bestsellery, przy porównywalnej trafności.
Tolerancja literówek: „Wyniki dla… Zamiast tego szukaj…”
Tolerancja literówek: „Wyniki dla… Zamiast tego szukaj…”

Synonimy i przekierowania

W zakładce Synonimy i przekierowania wpisz jedną grupę synonimów w wierszu, dla każdego języka:

sofa, kanapa, wersalka
czekolada => trufla, pralinki

Wiersz z przecinkami łączy równoważne słowa: każde znajduje pozostałe. Wiersz z => działa w jedną stronę: „czekolada” znajduje też słowa po prawej, ale nie odwrotnie. Liczba mnoga jest obsługiwana, a synonim znajduje tylko całe słowa.

Przekierowania kierują zapytanie bezpośrednio na stronę: „dostawa” na stronę wysyłki, marka na jej stronę… Wybierz „Dokładne zapytanie” lub „Zawiera te słowa”, język i adres URL (pełny adres lub ścieżka sklepu zaczynająca się od /). Panel pokazuje wtedy skrót, Enter otwiera stronę, a strona wyników również przekierowuje. Wyświetlana jest liczba użyć każdego przekierowania.

Panel administracyjny: synonimy dla każdego języka i przekierowania zapytań
Panel administracyjny: synonimy dla każdego języka i przekierowania zapytań
Zapytanie przekierowane na stronę sklepu
Zapytanie przekierowane na stronę sklepu

Wyszukiwania bez wyników

Gdy nic nie pasuje, panel proponuje popularne wyszukiwania i polecane produkty zamiast pustej strony. Jeśli aktywne są filtry, komunikat zachęca do ich zresetowania. Takie zapytania pojawiają się w panelu statystyk z przyciskiem do utworzenia synonimu lub przekierowania jednym kliknięciem.

Wyszukiwanie bez wyników z popularnymi wyszukiwaniami i polecanymi produktami
Wyszukiwanie bez wyników z popularnymi wyszukiwaniami i polecanymi produktami

Inteligentne wyszukiwanie (opcjonalne)

Dwie opcjonalne warstwy poprawiają wyniki ponad samo dopasowanie słów. Domyślnie są wyłączone, w zakładce Inteligentne wyszukiwanie.

Samouczenie (bez usługi zewnętrznej)

Moduł uczy się na podstawie statystyk wyszukiwania Twojego sklepu:

  • Kliknięcia i zamówienia: dla danego zapytania produkty, które otworzyło i kupiło kilku różnych odwiedzających, przesuwają się wyżej w wynikach.
  • Przeformułowania: gdy odwiedzający, którzy nic nie znaleźli, zaraz potem odnoszą sukces z innym zapytaniem, to przeformułowanie jest zapamiętywane, a kolejni odwiedzający otrzymują jego wyniki („Wyniki dla… Zamiast tego szukaj…”).

Sygnał liczy się dopiero wtedy, gdy da go minimalna liczba różnych odwiedzających (domyślnie 3): nikt nie wypromuje produktu sam. Uczenie jest aktualizowane co 6 godzin, poleceniem nocnym lub przyciskiem Aktualizuj teraz. Wyuczone przeformułowania są wyświetlane z przyciskami Zrób z tego synonim i Ignoruj.

Wyszukiwanie semantyczne (ranking hybrydowy)

Wyszukiwanie semantyczne rozumie znaczenie zapytania: „prezent dla miłośnika kawy” znajduje kubki, „coś do pisania” znajduje notesy, nawet gdy tych słów nie ma w nazwach produktów. Korzysta z usługi embeddingów zgodnej z API OpenAI: OpenAI, Mistral AI lub własny serwer (Ollama…), ustawiane jednym kliknięciem.

  1. Włącz opcję, wybierz dostawcę, wpisz klucz API (przechowywany w bazie danych, nigdy nie pokazywany w sklepie) i zapisz.
  2. Kliknij Testuj połączenie, a następnie Generuj wektory. Zakładka pokazuje postęp i szacowaną ilość danych do wysłania. Później ponownie wysyłane są tylko nowe lub zmienione produkty: przyciskiem, poleceniem nocnym lub automatycznie przy zapisie produktu.

Ranking jest hybrydowy: wynik słów i podobieństwo są łączone z regulowaną wagą (domyślnie 40 %), a produkty mniej podobne niż minimalne podobieństwo nie są dodawane. Domyślnie wyszukiwanie semantyczne działa tylko wtedy, gdy dopasowanie słów znajduje mało produktów; indeksy i kody EAN zawsze korzystają ze słów. Jeśli usługa jest wolna lub niedostępna, wyszukiwarka po maksymalnym czasie oczekiwania odpowiada samymi słowami. Przy 10 000 produktów samo wyszukiwanie wektorowe trwa około 15 ms.

Po włączeniu tekst produktów (nazwa, marka, kategorie, cechy, krótki opis) oraz zapytania odwiedzających są wysyłane do wybranej usługi. Żadne dane osobowe nie są wysyłane. Wybierz dostawcę zgodnego z Twoją polityką prywatności lub własny serwer.

Merchandising

Zakładka Merchandising decyduje, co widzą odwiedzający dla wybranych zapytań. Reguła dotyczy dokładnych zapytań, zapytań zawierających określone słowa lub wszystkich wyszukiwań, w jednym języku lub wszystkich, i może być zaplanowana między dwiema datami. Liczba mnoga i akcenty nie mają znaczenia.

  • Przypięte na górze: produkty wyświetlane jako pierwsze, w Twojej kolejności, nawet jeśli wyszukiwarka by ich nie znalazła.
  • Ukryte: produkty nigdy nie wyświetlane dla tych zapytań.
  • Promuj lub obniżaj: od -100 % do +100 % dla produktu, kategorii, marki, produktów dostępnych lub niedostępnych, nowości lub promocji.
  • Baner: tekst, z opcjonalnym obrazem i linkiem, nad wynikami.

Reguły stosują się w kolejności listy. Podgląd rankingu pokazuje dla zapytania i języka produkty w kolejności, w jakiej widzą je odwiedzający, i dlaczego: słowa, znaczenie, uczenie, przypięte produkty, wzmocnienia i ukryte produkty.

Indeks i wydajność

Moduł wyszukuje we własnym indeksie (jeden wiersz na produkt, sklep i język), aktualizowanym automatycznie przy zapisie produktu, kombinacji, stanu magazynowego, ceny specjalnej, kategorii lub marki. Indeksowane są tylko aktywne produkty widoczne „wszędzie” lub „tylko w wyszukiwaniu”, a kategorie zarezerwowane dla wybranych grup klientów są respektowane.

  • Przebuduj indeks: przydatne po imporcie bezpośrednio do bazy danych.
  • Zaplanowana przebudowa: polecenie cron jest pokazane gotowe do skopiowania, na przykład 0 3 * * * php /sciezka/do/sklepu/modules/dflivesearch/cli/reindex.php. Zalecane co noc, jeśli używasz reguł cenowych z datami.
  • Pamięć podręczna wyników: identyczne zapytania są obsługiwane z pamięci podręcznej (domyślnie 5 minut, dla każdego języka, waluty i grupy klientów). Jest czyszczona automatycznie przy zmianach w katalogu.

Brak wywołań przy ładowaniu stron: dane panelu ładują się przy jego otwarciu. W naszym katalogu testowym z 5000 produktów zapytanie odpowiada w 57–80 ms (8 produktów) i w 41–45 ms z pamięci podręcznej, łącznie z uruchomieniem PrestaShop.

Panel administracyjny: indeks wyszukiwania, pamięć podręczna i zaplanowana przebudowa
Panel administracyjny: indeks wyszukiwania, pamięć podręczna i zaplanowana przebudowa

Panel statystyk wyszukiwań i alerty

Menu Katalog > Statystyki wyszukiwania (lub Klienci w sklepie zaktualizowanym z wersji 1.x) pokazuje dla wybranego okresu i języka:

  • wyszukiwania, unikalne zapytania, odsetek wyszukiwań z wynikami, współczynnik kliknięć, wyszukiwania zakończone zamówieniem w ciągu 24 godzin, wyszukiwania bez wyników, każde z trendem względem poprzedniego okresu;
  • wykres wyszukiwań dziennie;
  • najczęstsze wyszukiwania ze współczynnikiem kliknięć i zamówieniami;
  • wyszukiwania bez wyników z przyciskami + Synonim i → Przekierowanie;
  • produkty najczęściej otwierane z wyszukiwania;
  • eksporty CSV (najczęstsze, bez wyników, wszystkie wyszukiwania).

Alert powstaje, gdy to samo zapytanie bez wyników wpisze w ciągu 7 dni wybrana przez Ciebie liczba różnych odwiedzających (domyślnie 5). Może być wysyłany e-mailem (8 języków) na wybrany adres.

Panel wyszukiwań: współczynnik kliknięć, wyszukiwania bez wyników, najczęstsze wyszukiwania
Panel wyszukiwań: współczynnik kliknięć, wyszukiwania bez wyników, najczęstsze wyszukiwania

Prywatność i bezpieczeństwo

  • Adresy IP odwiedzających nigdy nie są zapisywane: do liczenia unikalnych odwiedzających służy tylko solony skrót. Ostatnie wyszukiwania pozostają w przeglądarce odwiedzającego.
  • Zapisywana liczba wyników jest podpisana przez serwer: statystyk nie da się sfałszować z poziomu przeglądarki.
  • Punkt końcowy wyszukiwania jest ograniczony do 120 zapytań na minutę na odwiedzającego.
  • Każdy tekst wpisany przez odwiedzającego jest zabezpieczany przy wyświetlaniu: w panelu, w panelu administracyjnym i w e-mailach z alertami.
  • Historia jest domyślnie przechowywana 90 dni (regulowane), a następnie automatycznie usuwana.

Odinstalowanie

Domyślnie odinstalowanie usuwa tabele, ustawienia, zakładki, hooki i pamięć podręczną modułu. Włącz Zachowaj dane przy odinstalowaniu (zakładka Statystyki i alerty), aby zachować statystyki, synonimy, przekierowania i ustawienia na potrzeby ponownej instalacji.

FAQ i rozwiązywanie problemów

W nagłówku widać dwa paski wyszukiwania

W zakładce Ogólne wybierz Pasek motywu (pole motywu otwiera panel) lub Pasek modułu (standardowy pasek wyszukiwania PrestaShop zostaje ukryty).

Produkt nie jest znajdowany

Sprawdź, czy jest aktywny, widoczny „wszędzie” lub „tylko w wyszukiwaniu” i czy jedna z jego kategorii jest dostępna dla grupy odwiedzającego. Po imporcie bezpośrednio do bazy danych przebuduj indeks (zakładka Indeks i wydajność).

Cena w filtrze różni się od wyświetlanej ceny

Filtr i sortowanie według ceny używają zindeksowanej ceny publicznej. Ceny specjalne dla grupy lub klienta są poprawnie wyświetlane na kartach. Jeśli używasz reguł cenowych z datami, zaplanuj nocną przebudowę indeksu.

Popularne wyszukiwania pozostają puste

Zapytanie pojawia się dopiero wtedy, gdy w ciągu 30 dni znalazło produkty dla minimalnej liczby różnych odwiedzających. Obniż to minimum lub wpisz własną listę (zakładka Pusty panel).

Nowy wygląd nie pojawia się po aktualizacji

Wyczyść pamięć podręczną PrestaShop. Jeśli motyw łączy pliki CSS i JS (CCC), połączone pliki zostaną wygenerowane ponownie.

Wyszukiwarka odpowiada „Zbyt wiele wyszukiwań w krótkim czasie”

Limit 120 zapytań na minutę chroni serwer przed botami. Zwykły odwiedzający nigdy go nie osiąga; sprawdź, czy żadne narzędzie testowe ani bot nie odpytuje punktu końcowego w pętli.

Jak otworzyć wyszukiwanie przyciskiem z motywu?

Dodaj do przycisku atrybut data-dflivesearch-trigger (lub klasę dflivesearch-trigger) albo wywołaj w JavaScript window.dflivesearchOpen('zapytanie'). Ikony wyszukiwania motywu Warehouse są obsługiwane automatycznie.

Czy wyszukiwanie semantyczne wysyła moje dane do usługi zewnętrznej?

Tylko jeśli je włączysz: teksty produktów i zapytania odwiedzających trafiają do wybranego dostawcy, nigdy dane osobowe. Z własnym serwerem (Ollama) nic nie opuszcza Twojej infrastruktury. Samouczenie i merchandising nie korzystają z żadnej usługi zewnętrznej.

Jak ustawić produkt na pierwszym miejscu dla zapytania?

W zakładce Merchandising dodaj regułę z zapytaniem, przypnij produkt i zapisz. Sprawdź wynik w podglądzie rankingu.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia