Smart Search
Smart Search nahrazuje výchozí našeptávač nopCommerce rychlým, plně responzivním panelem návrhů „search-as-you-type“. Nahrazuje pouze našeptávač – vyhledávací pole šablony i stránka s výsledky vyhledávání zůstávají beze změny.
Smart Search nahrazuje výchozí našeptávač nopCommerce rychlým, plně responzivním panelem s návrhy během psaní (search-as-you-type). Zákazník už po prvních písmenech vidí produkty s obrázkem, cenou a dostupností, nejlépe odpovídající kategorie i výrobce – a k hledanému zboží se dostane na pár stisků kláves. Plugin mění pouze našeptávač; vyhledávací pole i stránka s výsledky zůstávají beze změny.
Co plugin umí
- Produkty s obrázkem, cenou a dostupností – až 25 položek (výchozí 10), název, SKU a barevný štítek skladu.
- Kategorie s celou cestou – např. „Dětské boty › Dětské tenisky", takže je hned jasné, kam odkaz vede.
- Výrobci jako štítky – nejlépe odpovídající značky na jedno kliknutí.
- Odpověď typicky za 50–90 ms díky dávkovému načítání dat a serverové i prohlížečové cache.
- Přístupnost – ARIA vzor combobox/listbox, plné ovládání klávesnicí, hlášení stavu pro čtečky obrazovky.
- Mobil i desktop – celoobrazovkový overlay na mobilu, rozbalovací panel na desktopu.
- 12 nastavení v administraci s možností přepsat hodnoty pro každý obchod (multi-store).
- 5 jazyků – čeština, slovenština, angličtina, polština, maďarština.
- Upgrade-safe – samostatný plugin bez zásahu do jádra, šablon i databáze.
Jak to funguje
Zákazník začne psát
Po dosažení minimální délky dotazu (nastavitelné) plugin počká 200 ms na ukončení psaní a odešle jeden požadavek – ne po každém stisku klávesy.
Server vrátí návrhy
Odlehčený JSON endpoint načte produkty, kategorie a výrobce v jedné dávce. Výsledek se uloží do serverové cache (výchozí 180 s) a do cache prohlížeče pro opakované dotazy.
Zobrazí se panel
Tři sekce – Produkty, Kategorie, Výrobci – s obrázky, cenami a štítky dostupnosti (zelená skladem, oranžová na objednávku, šedá nedostupné).
Výběr myší nebo klávesnicí
Šipky procházejí položky, Enter otevře vybraný produkt či kategorii, Escape panel zavře. Zákazník je u zboží dřív, než by stránka s výsledky vůbec načetla.
Co zákazník uvidí
Produkty
Obrázek, název (max. 2 řádky), SKU a cena, štítek dostupnosti. Až 25 položek.
Kategorie
Nejlépe odpovídající kategorie včetně celé cesty ve stromu – bez záměny stejnojmenných podkategorií.
Výrobci
Odpovídající značky jako přehledné štítky (chips) s přímým odkazem na výpis výrobce.
Rychlost, která se počítá
Našeptávač je první věc, kterou zákazník při hledání používá – a každá desetina sekundy rozhoduje, zda pokračuje nebo odchází. Smart Search je proto postavený na minimum požadavků a maximum cache.
50–90 mstypická odezva serveru
200 msdebounce – jeden dotaz místo pěti
180 sserverová cache (nastavitelná)
~22 kBvanilla JavaScript, bez jQuery
Přístupnost a mobil
- ARIA combobox/listbox – čtečky obrazovky vědí, že jde o seznam návrhů, a čtou aktivní položku.
- Klávesnice – šipky nahoru/dolů, Enter pro výběr, Escape pro zavření.
- Live region – hlášení počtu nalezených návrhů pro asistivní technologie.
- Mobil (do 768 px) – celoobrazovkový overlay s velkými dotykovými cíli; desktop – rozbalovací panel pod polem.
Nastavení v administraci
Vše se nastavuje v administraci bez zásahu do kódu. Každou hodnotu lze přepsat na úrovni konkrétního obchodu (store-scope override).
- Zapnutí / vypnutí pluginu.
- Počet produktů v panelu (1–25).
- Zobrazení SKU, obrázků, cen a dostupnosti u produktů.
- Zobrazení kategorií a výrobců + limit jejich počtu.
- Doba platnosti serverové cache.
- Minimální délka dotazu, od které se návrhy zobrazují.
Technické parametry
| Parametr | Hodnota |
|---|
| Zásah do jádra / šablon | Žádný – samostatný plugin |
| Databáze | Žádné vlastní tabulky, katalog pouze pro čtení |
| Endpoint | Anonymní JSON, dotaz max. 100 znaků, 1–25 výsledků |
| Front-end | Vanilla JavaScript (~22 kB), nezávislý na jQuery |
| Cache | Server (výchozí 180 s, nastavitelné) + prohlížeč |
| Obrázky | Standardní obrázky nopCommerce, volitelně Cloudflare Images |
| Vyhledávací provider | Funguje s výchozím vyhledáváním; volitelně libovolný provider (např. Elasticsearch) pro lepší relevanci |
| Jazyky | CS, SK, EN, PL, HU |
Komu se hodí
Každému e-shopu na nopCommerce, kde zákazníci hledají – tedy prakticky všem. Největší přínos pocítí obchody s širším katalogem, více kategoriemi a značkami, kde výchozí textový našeptávač nestačí. Smart Search je zároveň cenově dostupná alternativa k externím vyhledávacím službám: běží přímo v e-shopu, bez měsíčních poplatků a bez odesílání dat třetí straně.
Rychlejší cesta ke zboží
Produkt s cenou a dostupností vidí zákazník bez načtení stránky s výsledky.
Vyšší konverze
Méně slepých hledání, méně odchodů – kdo najde, nakoupí.
Přístupné pro všechny
ARIA, klávesnice a čtečky obrazovky – v souladu s požadavky na přístupnost.
Bezpečné a upgrade-safe
Pouze čtení katalogu, přísné limity dotazu, žádný zásah do jádra.
Doporučené nastavení: po instalaci vypněte výchozí našeptávač v nastavení katalogu (Product search autocomplete), aby se oba panely nepřekrývaly.
Kompatibilita & licence: dostupné pro aktuální verzi nopCommerce (převod na jinou verzi na vyžádání). Volitelně zajistíme instalaci a základní nastavení pluginu.
Úprava na míru
Potřebujete v našeptávači zobrazit další údaje (parametry, štítky akcí), jiné řazení nebo vlastní vzhled panelu? Plugin přizpůsobíme vašemu e-shopu. Napište nám a navrhneme řešení.
Časté dotazy
Čím se Smart Search liší od výchozího našeptávače nopCommerce?
Výchozí našeptávač nabízí jen názvy produktů. Smart Search zobrazí produkty s obrázkem, cenou a dostupností, k tomu kategorie s celou cestou a výrobce – v panelu, který je rychlý, přístupný a přizpůsobený mobilu.
Změní plugin i stránku s výsledky vyhledávání?
Ne. Plugin nahrazuje pouze našeptávač (autocomplete). Vyhledávací pole i stránka s výsledky zůstávají beze změny.
Jak rychlý je našeptávač?
Typická odezva serveru je 50–90 ms. Debounce 200 ms omezí počet požadavků, serverová cache (výchozí 180 s) a cache prohlížeče obslouží opakované dotazy okamžitě.
Je našeptávač přístupný (a11y)?
Ano. Používá ARIA vzor combobox/listbox, plné ovládání klávesnicí (šipky, Enter, Escape) a live region pro hlášení stavu čtečkám obrazovky.
Zasahuje plugin do jádra nebo databáze?
Ne. Je to samostatný plugin bez úprav jádra a šablon, nevytváří vlastní tabulky a katalog pouze čte. Aktualizace nopCommerce ho tedy neohrozí.
Funguje ve více obchodech (multi-store) a jazycích?
Ano. Všech 12 nastavení lze přepsat pro každý obchod zvlášť. Překlady jsou v češtině, slovenštině, angličtině, polštině a maďarštině.
Musím mít Elasticsearch nebo jiný vyhledávací provider?
Ne. Plugin funguje s výchozím vyhledáváním nopCommerce. Libovolný provider (např. Elasticsearch) lze volitelně doplnit pro ještě lepší relevanci výsledků.