Smart Search Pro – inteligentní vyhledávač produktů pro PrestaShop

Vlastní vyhledávací engine a index produktů

• Vestavěný backend MySQL: základní varianta modulu funguje na databázi obchodu a nevyžaduje předplatné externího vyhledávacího enginu. Produkty jsou zpracovávány do vlastního indexu, připraveného pro textové vyhledávání, kódy produktů, filtrování, řazení a prezentaci výsledků.
• Volitelné backendy Meilisearch a Typesense: administrátor může přepnout engine na jednu z podporovaných externích služeb, zadat adresu, API klíč, prefix indexu a časový limit připojení. Jde o doplňkovou možnost; obchod může zůstat u enginu MySQL.
• Nouzový fallback: nastavení návratu k nativnímu vyhledávání PrestaShop umožňuje zachovat základní obsluhu dotazů, když zvolený backend vyhledávání neodpovídá.
• Index rozdělený podle obchodu a jazyka: dokumenty, facety, analytika i data spravovaná modulem zohledňují aktuální kontext obchodu a jazyka. Díky tomu mohou výsledky odpovídat správnému katalogu, překladům a konfiguraci multistore.
• Indexování bez produktového feedu: modul načítá data přímo z PrestaShop. Není třeba připravovat samostatný XML nebo CSV soubor jen proto, aby napájel vyhledávač.
• Blue/green index: úplná přestavba se provádí v nové generaci indexu a přepnutí na připravenou sadu dat probíhá po dokončení procesu. Dosavadní aktivní generace může během vytváření nové nadále obsluhovat vyhledávání.

Rozsah dat zohledňovaných při vyhledávání

Administrátor není omezen pouze na název produktu. Modul má panel vyhledávacích polí, ve kterém lze řídit rozsah informací používaných k vyhledávání produktů.

• Kódy a obchodní identifikátory: vyhledávání zahrnuje referenci produktu a dodavatele, EAN-13, UPC, ISBN i MPN. Pole kódů zůstává základním prvkem indexu, což usnadňuje nalezení konkrétního produktu podle technického označení.
• Název, značka a kategorie: modul může přiřazovat dotaz k názvu produktu, výrobci nebo značce i k názvům kategorií přiřazených k produktu.
• Tagy, vlastnosti a atributy: do indexu mohou být zahrnuty produktové tagy, hodnoty vlastností i atributy kombinací, takže zákazník může vyhledávat také podle parametrů a variant popisujících nabídku.
• Krátký popis a plný popis: administrátor může používat popisný obsah produktů jako další zdroj shody, s jinou váhou než název nebo kód.
• Konfigurovatelné váhy polí: panel kritérií relevance umožňuje určit, které informace mají větší vliv na pořadí výsledků. Vyhledávání podle přesného kódu tak může mít jiný význam než slovo vyskytující se pouze v dlouhém popisu.

Automatické doplňování a vyhledávání při psaní

• Okamžité návrhy produktů: po zapnutí automatického doplňování modul načítá výsledky během psaní fráze. Zákazník může rychleji rozpoznat správný produkt a přejít na jeho stránku bez čekání na úplné načtení výsledků.
• Návrhy klíčových slov: modul může zobrazovat související fráze odvozené z indexu produktů. Limit viditelných návrhů je konfigurovatelný.
• Tolerance překlepů: k dispozici jsou režimy vyvážený, konzervativní a vypnutý. To umožňuje přizpůsobit přibližné vyhledávání typu sortimentu, délce kódů a očekávané míře volnosti při chybně zadaných slovech.
• Kontrola asynchronních dotazů: front-endový skript používá zpoždění při psaní, přerušování neaktuálních dotazů a ochranu pořadí odpovědí, aby starší výsledek nenahradil novější frázi zákazníka.
• Rozhraní dostupné z klávesnice: automatické doplňování využívá sémantiku comboboxu a atributy ARIA, čímž podporuje pohyb v návrzích bez použití myši.

Celoobrazovkový vyhledávací modal

• Výsledky bez opuštění aktuální stránky: po kliknutí do vyhledávacího pole může modul otevřít rozšířený modal s výsledky produktů, návrhy a nástroji pro zúžení seznamu.
• Konfigurovatelná velikost: šířka a výška modalu na desktopu se nastavují procentuálně vzhledem k oknu prohlížeče. U velké varianty mohou filtry tvořit samostatný sloupec vedle produktů.
• Responzivní mřížka produktů: počet produktů v jednom řádku se nastavuje nezávisle pro desktop, tablet a telefon. To umožňuje přizpůsobit hustotu výsledků návrhu obchodu a velikosti obrazovky.
• Dva způsoby procházení dalších výsledků: administrátor volí automatické dočítání při posouvání nebo klasickou stránkovanou navigaci. Konfigurovatelný je také limit produktů načítaných v jedné dávce nebo na stránce.
• Kategorie a facety v modalu: zákazník může zúžit výsledky pomocí odpovídajících kategorií a stejné sady facetů, která platí na standardní stránce vyhledávání.
• Sbalování filtrů při psaní: volitelně zůstává blok filtrů ve výchozím stavu sbalený, aby na menších obrazovkách a během psaní nezakrýval seznam produktů. Stav sekce je synchronizován také během načítání, při absenci výsledků i při zpracování chyby.
• Zobrazení pro objevování nabídky: před zadáním fráze může modal zobrazovat poslední vyhledávání, oblíbené úspěšné dotazy a ručně vybrané doporučené produkty.

Rozšířená stránka výsledků vyhledávání

• Nativní integrace s mechanismem seznamu produktů PrestaShop: modul poskytuje vlastního providera výsledků a zároveň využívá strukturu seznamu produktů a mechanismus řazení platformy.
• Nezávislé zapínání: stránka výsledků, automatické doplňování a modal mají samostatné přepínače. To umožňuje postupné nasazení funkcí a ponechání pouze těch prvků, které jsou v konkrétním obchodě potřeba.
• Samostatná responzivní mřížka: počet produktových karet v řádku na stránce výsledků se konfiguruje nezávisle pro desktop, tablet a telefon.
• Dvě rozložení facetů: filtry lze umístit jako kompaktní panel nad produkty nebo jako rozbalený levý sloupec. Varianta levého sloupce dokáže vytvořit dvousloupcové rozložení také na stránce výsledků přes celou šířku a na mobilních zařízeních zůstávají filtry dostupné ve vysouvacím panelu.
• Řazení výsledků: zákazník může zvolit relevanci, nejprve dostupné produkty, název A–Z nebo Z–A a cenu vzestupně nebo sestupně.
• Politika nedostupných produktů: administrátor může zcela vyloučit produkty, které aktuálně nelze objednat, nebo je ponechat viditelné a přesunout je na konec seznamu. Modul zohledňuje stav, nastavení prodeje při nedostatku zásob i příznak dostupnosti produktu k objednání.
• Pomoc při prázdném dotazu: na stránce výsledků lze zapnout poslední vyhledávání, oblíbené fráze a doporučené produkty namísto toho, aby zákazník zůstal s prázdným zobrazením.

Filtry a facety přizpůsobené katalogu

• Společná konfigurace pro modal a stránku výsledků: pořadí, aktivita a způsob prezentace facetů se spravují na jednom místě, takže zákazník dostává konzistentní filtry v obou zobrazeních.
• Standardní katalogové facety: modul podporuje kategorii, značku, dostupnost a cenové rozpětí.
• Dynamické facety produktů: skupiny atributů a vlastnosti se načítají z katalogu a dostávají stabilní identifikátory. To umožňuje samostatně nakonfigurovat například velikost, barvu, materiál, objem nebo jakoukoli jinou skupinu existující v obchodě.
• Obchodní facety: k dispozici jsou filtry novinek, bestsellerů za posledních 30 dní a produktů s aktivní cenovou akcí.
• Různé formy prezentace: pro každou entitu lze zvolit checkboxy, pilulky nebo vícenásobný výběr s odnímatelnými aktivními hodnotami. Konfigurace nevnucuje všem filtrům jeden globální způsob zobrazení.
• Individuální pořadí a limity: administrátor určuje pořadí facetů a maximální počet viditelných hodnot zvlášť pro každou entitu. Pořadí lze měnit metodou drag and drop nebo tlačítky dostupnými z klávesnice.
• Rychlé vyhledávání hodnot: když facet obsahuje mnoho možností, modul může zobrazit interní vyhledávací pole. Práh jeho aktivace je konfigurován samostatně pro modal a stránku výsledků.
• Aktivní filtry a bezpečné adresy: vybrané hodnoty jsou zákazníkovi prezentovány jako aktivní filtry a kód modulu validuje povolené typy filtrů a cenová rozpětí před jejich předáním backendu.

Synonyma, relevance a kontrola kvality výsledků

• Synonyma spravovaná v Back Office: lze propojit hovorové výrazy, zkratky, alternativní názvy i různé varianty slovní zásoby používané zákazníky. Rozšíření dotazu probíhá ve vrstvě vyhledávání bez přepisování názvů produktů.
• Konfigurovatelná kritéria relevance: administrátor může nastavit pořadí doplňkových kritérií používaných u výsledků s podobnou textovou shodou.
• Náhled vyhledávání v panelu: samostatná záložka umožňuje ověřit fungování fráze před hodnocením výsledků na front-endu obchodu. Modul také připravuje informace vysvětlující shodu a bodové hodnocení výsledků.
• Obnova při absenci výsledků: vrstva vyhledávání obsahuje mechanismus pro přípravu alternativ k dotazům, které nevrátily produkty, místo aby se celý proces omezil na prázdný seznam.
• Kontrola produktů dostupných k nákupu: pravidla relevance lze propojit s politikou vyloučení nebo snížení pozice nedostupného sortimentu.

Merchandising výsledků vyhledávání

• Pravidla závislá na dotazu: podmínka může odpovídat přesné frázi, prefixu nebo fragmentu dotazu. Pravidlo lze omezit na aktuální jazyk nebo použít ve všech jazycích.
• Připnutí produktu: vybraný produkt může být umístěn na konkrétní pozici výsledků pro dotaz zahrnutý pravidlem.
• Propagace a snížení pozice: akce boost a bury mění bodové hodnocení určených produktů pomocí konfigurovatelného násobitele.
• Vyloučení z výsledků: pravidlo může odstranit určené produkty ze seznamu pro konkrétní frázi bez jejich deaktivace v katalogu.
• Priorita, stav a harmonogram: pravidla mají interní název, prioritu, pracovní nebo publikační stav a volitelný čas zahájení a ukončení platnosti.
• Deterministické řešení konfliktů: když se na stejný dotaz hodí několik pravidel, modul rozhoduje o jejich působení podle typu akce, priority a identifikátoru pravidla.

Přesměrování dotazů a bannerové kampaně

• Přesměrování vyhledávání: vybranou frázi nebo sadu termínů lze nasměrovat na řízenou cílovou adresu, například stránku kategorie, výrobce, produktu nebo připravenou landing page.
• Validace cílových adres: resolver přesměrování obsahuje ochranu proti otevřeným přesměrováním, takže se funkce neomezuje na bezpodmínečné použití libovolné adresy zaslané v dotazu.
• Přiřazení kampaně k frázi: bannery mají seznam spouštěčů a režim shody dotazu. Kampaň lze určit pro stránku výsledků, modal, automatické doplňování nebo všechna podporovaná místa.
• Samostatné desktopové a mobilní obrázky: modul ukládá cestu k hlavní grafice i volitelné mobilní grafice, alternativní text a cílovou adresu. Banner bez adresy může být zobrazen jako neklikací informační prvek.
• Jazyk, priorita a harmonogram: kampaně se spravují pro vybraný jazyk, mají stav aktivity, prioritu a volitelné datum začátku a konce zobrazování.
• Měření kampaní: po zapnutí analytiky a získání souhlasu může modul zaznamenávat zobrazení a kliknutí bannerů a propojit tak propagační funkci s reportingem.

Doporučené produkty a objevování nabídky

• Ručně vybraná doporučení: administrátor vytváří uspořádaný seznam produktů, které mají být zobrazovány před zadáním dotazu nebo na prázdné stránce výsledků.
• Samostatné přepínače zobrazení: doporučení, oblíbené fráze a poslední vyhledávání lze zapínat nezávisle pro modal i stránku výsledků.
• Poslední vyhledávání na straně prohlížeče: historie posledních frází se ukládá lokálně v prohlížeči zákazníka a její maximální délka je konfigurovatelná.
• Oblíbené úspěšné fráze: modul vypočítává seznam na základě agregované analytiky z vybraného období. Administrátor určuje počet položek a délku analyzovaného období.

Analytika vyhledávání a atribuce prodeje

• Nejdůležitější KPI vyhledávače: dashboard zobrazuje počet vyhledávání, kliknutí, míru CTR, vyhledávání bez kliknutí a fráze, které nevrátily produkty.
• Analýza frází a produktů: reporty pomáhají ověřit, co zákazníci hledají, které produkty jsou viditelné a klikatelné a na jakých pozicích dochází k interakci.
• Analýza používání filtrů: modul agreguje události související s facety, takže lze vyhodnotit, které filtry a hodnoty skutečně pomáhají zákazníkům zužovat katalog.
• Košíky, objednávky a příjem: atribuční mechanismus propojuje kliknutí s pozdějším přidáním produktu do košíku a objednávkou. Samostatně se konfigurují okna přímé a asistované atribuce.
• Rozdělení podle jazyka a zařízení: denní agregace lze analyzovat v kontextu jazyka a typu zařízení, což usnadňuje oddělení chování desktopových a mobilních uživatelů.
• Export CSV: data o frázích, produktech a filtrech lze exportovat k další analýze mimo panel PrestaShop.
• Konfigurovatelná retence: doba uchovávání surových analytických událostí se nastavuje ve dnech, zatímco agregované denní statistiky mohou zůstat dostupné déle.
• Zohlednění analytického souhlasu: modul má bránu souhlasu a odděluje události podléhající souhlasu od omezených agregací. To by nemělo být považováno za náhradu konfigurace platformy souhlasů v obchodě, ale za mechanismus respektující její stav funkcemi modulu.

Upozornění na kvalitu a panel optimalizace

• Upozornění na vyhledávání bez výsledků: administrátor nastavuje varovnou a kritickou úroveň pro podíl dotazů, které nenašly produkty.
• Upozornění na absenci kliknutí a pokles CTR: modul může signalizovat zhoršení chování zákazníků po překročení nakonfigurovaných prahů a minimální velikosti vzorku.
• Kontrola čerstvosti indexu: dashboard upozorňuje, když je poslední úplné indexování starší než povolený počet hodin.
• Kontrola fronty: samostatné varovné a kritické prahy informují o narůstajícím počtu čekajících, zpožděných nebo zpracovávaných úloh.
• Příležitosti k optimalizaci: panel porovnává data o problematických frázích a produktech, aby administrátor mohl rozhodnout, zda je potřeba synonymum, přesměrování, změna dat produktu nebo merchandisingové pravidlo.

Indexování, fronta a automatická údržba

• Úplná přestavba indexu: panel indexování umožňuje spustit kompletní generování dat pro aktivní kontexty obchodu a jazyka.
• Fronta změn katalogu: přidání, aktualizace nebo odstranění produktu, změna stavu skladu, kategorie, speciální ceny a vybraných souvisejících dat způsobí přidání odpovídající úlohy do fronty namísto provádění náročné přestavby přímo v hooku.
• Deduplikace a opakování úloh: repozitář fronty spojuje opakující se operace, podporuje převzetí úloh workerem a jejich opakování s narůstajícím zpožděním.
• Reconciler indexu: operace sladění odhaluje chybějící, nadbytečné nebo neaktuální dokumenty a zařazuje omezenou opravu do fronty.
• Úlohy CRON: modul zpřístupňuje akce pro práci workeru, sladění a úplnou přestavbu. Panel Back Office zobrazuje hotové informace potřebné ke konfiguraci lokálního nebo externího plánovače.
• Zabezpečení vzdáleného CRONu: endpoint podporuje podpis HMAC a nonce a náročnější operace jsou odděleny od veřejného procesu vyhledávání.
• Health check a diagnostika: modul má stavový endpoint a diagnostické panely, které pomáhají ověřit backend, index a konfiguraci před zapnutím funkcí na front-endu.

Import a export kompletní konfigurace

• Přenosný konfigurační soubor: export zahrnuje nastavení backendu, front-endu, modalu, stránky výsledků, analytiky, vyhledávacích polí, kritérií relevance a facetů.
• Data spravovaná v modulu: spolu s nastaveními lze přenést doporučené produkty, synonyma, merchandisingová pravidla, bannery a přesměrování.
• Mapování jazyků: vícejazyčné sekce se přenášejí podle locale nebo ISO kódu, nikoli výhradně podle lokálního identifikátoru jazyka.
• Přenášení produktů podle stabilních označení: doporučení a produkty používané v pravidlech mohou být mapovány na základě reference, EAN nebo UPC, což omezuje riziko přiřazení dat k jinému produktu po migraci.
• Validace před uložením: import provádí kontrolu schématu a vstupních dat před zahájením změn. Uložení je transakční a v případě chyby modul provede rollback namísto ponechání částečně importované konfigurace.
• Režim sloučení nebo nahrazení: administrátor volí způsob použití souboru a destruktivní varianta nahrazení vyžaduje vědomé potvrzení.
• Ochrana tajných údajů: API klíče mohou zůstat redigované, zatímco globální tajný klíč podpisu CRON není považován za přenosný prvek konfigurace prostředí.

Bezpečnost, výkon a řízené nasazení

• Front-end je po instalaci ve výchozím stavu vypnutý: automatické doplňování, stránka výsledků, modal i analytika mají samostatné přepínače, takže administrátor může nejprve vytvořit index a zkontrolovat výsledky v náhledu.
• Rate limiting událostí: analytický endpoint má konfigurovatelný limit krátkého burstu i tempo obnovování, aby jeden uživatel negeneroval neomezený počet záznamů.
• Circuit breaker vyhledávání: orchestrátor omezuje opakování požadavků na nedostupný backend a spolupracuje s nastavením nativního fallbacku.
• Bez úprav Core: modul nevyžaduje override tříd PrestaShop ani ruční přepisování souborů šablony. Integruje se přes hooky, providera vyhledávání a vlastní front-endové zdroje.
• Podmíněné načítání front-endových funkcí: zdroje a konfigurace se přidávají tehdy, když je aktivní automatické doplňování, modal nebo stránka výsledků.
• Práce s daty po odinstalaci: data modulu jsou ve výchozím stavu zachována a jejich odstranění vyžaduje předchozí zapnutí příslušné volby v nastavení.

Přínosy pro internetový obchod

• Kratší cesta k produktu: zákazník dostává výsledky už během psaní, může upřesnit nepřesný dotaz a ihned zúžit seznam podle vlastností katalogu.
• Lepší využití produktových dat: názvy, kódy, značky, kategorie, tagy, vlastnosti, atributy a popisy pracují společně namísto toho, aby zůstávaly oddělenými, nevyužitými zdroji informací.
• Obchodní kontrola nad pořadím výsledků: administrátor může propagovat, snižovat, připínat nebo vylučovat produkty pro konkrétní fráze bez přestavby celé struktury kategorií.
• Rozhodování založené na datech: reporty ukazují nejen počet dotazů, ale také kliknutí, absenci výsledků, používání filtrů, košíky, objednávky a příjem související s vyhledáváním.
• Funkčně škálovatelné řešení: obchod může začít s vestavěným MySQL a později přepnout backend na Meilisearch nebo Typesense při zachování panelu správy a front-endových funkcí modulu.

Kompatibilita

PD Smart Search Pro je připraven pro PrestaShop 1.7.x, 8.x a 9.x, PHP 7.0–8.5 a MySQL 5.6+ nebo MariaDB 10.x+. Modul podporuje klasická i novější prostředí PrestaShop bez povinné externí vyhledávací služby a integrace Meilisearch a Typesense zůstávají volitelnou volbou administrátora.

Odkaz na demo modulu:

Demo administrátorský panel:
https://moduly-prestashop.eu/pdsmartsearchpro/admin-dev

Demo front-end:
https://moduly-prestashop.eu/pdsmartsearchpro