Inteligentna wyszukiwarka na stronę od Elbuz zastępuje pole wyszukiwania strony na OpenCart, WooCommerce, WordPress, Shopify lub innym CMS: wystarczy podać adres, selektor CSS pola i wkleić kod do szablonu.
Kiedy to się przyda:
- Strona na dowolnym CMS — widżet podłącza się jednym skryptem i nie zależy od silnika strony.
- Strona na popularnym CMS — wybór CMS sam wypełnia selektory, kod przycisków koszyka i adresy stron.
- Na telefonie pole wyszukiwania jest ukryte pod lupą — osobny selektor przycisku mobilnego otwiera wyszukiwarkę.
- Pierwsze kliknięcie w pole pokazuje „Loading...” — „Szybkie otwieranie wyszukiwania” wczytuje widżet razem ze stroną.
Od czego zacząć: wypełnij adres strony i selektor na zakładce „Ustawienia” i wklej kod integracji.
Co ustawisz w formularzu widżetu
Formularz inteligentnej wyszukiwarki ma osiem zakładek, każda to białe sekcje z podpowiedzią pod tytułem. Formularz zapisuje się sam przy każdej zmianie pola, przycisku „Zapisz” nie ma.
| Zakładka | Co na niej jest | Gdzie opisano |
|---|---|---|
| Ustawienia | przełączniki funkcji, strona i selektory, synonimy, indeks wyszukiwania, kod integracji, API | tutaj; synonimy, indeks, API |
| Informacje | podsumowanie danych sklepu z karty firmy, podpowiedź i słowa w polu wyszukiwania, nazwa widżetu | tutaj |
| Linki | strony sklepu, szablony linków do produktu, kategorii, zdjęcia | linki i prefiksy językowe |
| Ceny | pole ceny, RRP (sugerowana cena detaliczna), cena promocyjna i stara cena, waluta | ceny i waluta |
| Ograniczenia | dostępność, warunek wyboru produktów | które produkty pokazywać |
| Wygląd | okno, kolory, wyniki, przyciski, bloki, pola, osadzanie, własny CSS i JS | wygląd okna wyszukiwania |
| Zdarzenia | kod JS przycisków koszyka, ulubionych i porównania, ID produktu ze strony | koszyk, ulubione i porównanie |
| Test wyszukiwania | te same wyniki co na stronie, bez zainstalowanego widżetu | sprawdzanie wyników |
Jak umieścić widżet na stronie
Podłączenie to sekcja „Strona i pole wyszukiwania” i jeden wklejony kod. W sklepie Elbuz CMS nic wklejać nie trzeba: wyszukiwarka włączy się sama podczas tworzenia sklepu (co włącza się samo).
- Włącz „Aktywność” w sekcji „Funkcje wyszukiwania”. Bez niej wyszukiwarka na stronie nie działa, a kod integracji nie zawiera wyszukiwarki.
- Adres strony — na której będzie działał widżet, na przykład
https://mojsklep.pl. Ukośnik na końcu usuwa się sam. - CMS ID i dla OpenCart CMS theme — jeśli Twój CMS jest na liście: program wypełni pozostałe pola, patrz niżej.
- Selektor CSS do zastąpienia pola wyszukiwania — miejsce na stronie, w którym stanie widżet. Domyślnie
#search; w Twoim motywie może to być klasa pola wyszukiwania. Osobno ustawia się Selektor CSS przycisku wyszukiwania w wersji mobilnej: tam pole często chowa się pod ikoną lupy. - Kod integracji — skopiuj go przyciskiem kopiowania w sekcji „Kod integracji” i wklej do
<head>strony. Kod powstaje przy otwarciu formularza: jeśli właśnie włączono „Aktywność”, zamknij i otwórz formularz ponownie przed kopiowaniem. To mały skrypt, który sam doczytuje aktualną wersję widżetu, więc kolejne zmiany ustawień nie wymagają wymiany kodu. - Zbuduj indeks wyszukiwania — bez niego wyszukiwarka nie ma w czym szukać.
Widżet przed wklejeniem na stronę produkcyjną zobaczysz przyciskiem „Otwórz stronę demo”, a same wyniki sprawdzisz na zakładce „Test wyszukiwania”.
1
Wyszukiwarka na stronie2
Szybkie otwieranie3
Adres strony4
CMS i motyw5
Pole wyszukiwania strony6
Przycisk wyszukiwania na telefonie- Bez „Aktywność” wyszukiwarka na stronie nie działa, a kod integracji nie zawiera wyszukiwarki.
- Widżet wczytuje się razem ze stroną, bez czekania na oznaki żywego odwiedzającego.
- Strona, na której będzie działał widżet.
- Wybór CMS sam wypełnia selektory, kod przycisków koszyka i adresy stron.
- Miejsce na stronie, które zastąpi widżet.
- Lupa, pod którą na telefonie chowa się pole wyszukiwania.
Jeśli na stronie działa też czat AI Elbuz, ten sam kod integracji podłącza oba widżety. Po włączeniu lub wyłączeniu jednego z nich otwórz formularz ponownie i skopiuj kod od nowa.
Co wypełnia wybór CMS
Na liście „CMS ID” są WooCommerce (WordPress), Shopify, Magento (Adobe Commerce), OpenCart, Elbuz CMS, PrestaShop, BigCommerce, Squarespace Commerce, Horoshop. Dla OpenCart w „CMS theme” są OCT ShowCase, OCT Deals i OCT Promo; lista motywów pokazuje tylko motywy wybranego CMS. Gdy tylko wybierzesz CMS lub motyw, program bierze jego gotowe ustawienia:
- oba selektory CSS — pola wyszukiwania i przycisku mobilnego (mobilny — dla motywów OpenCart);
- kod przycisków na zakładce „Zdarzenia” — dla których CMS istnieje, patrz koszyk, ulubione, porównanie;
- „Style CSS” i kod JS na zakładce „Wygląd”, jeśli potrzebuje ich motyw lub CMS;
- dla Horoshop — „Pobieranie ID produktu”;
- linki do koszyka, składania zamówienia, promocji, porównania i ulubionych — jeśli „Adres strony” jest już podany.
Puste pola wypełniają się od razu. Jeśli szablon ustawień zmieniłby pole, które już wypełniono, program pokazuje listę takich pól i pyta:
- Zastąp — wszystkie pola są brane z szablonu, Twoje wartości w wymienionych polach są zastępowane;
- Wypełnij tylko puste — Twoje wartości zostają, szablon trafia tylko do pustych pól;
- Anuluj — nic się nie zmienia, na listach wracają poprzedni CMS i motyw.
1
Pytanie2
Pola, które się zmienią3
Zastąp4
Tylko puste5
Anuluj- Program pyta tylko wtedy, gdy szablon zmieniłby pola, które już wypełniono.
- Szablon zastąpi Twoje wartości w tych polach.
- Wszystko z szablonu CMS.
- Twoje wartości zostają; szablon trafia tylko do pustych pól.
- Nic się nie zmienia; wracają poprzedni CMS i motyw.
Pole, dla którego szablon nie ma wartości, zostaje bez zmian. Twojego CMS nie ma na liście — zostaw „---” i wypełnij selektory oraz kod przycisków sam: wybór „---” niczego nie zmienia.
Co włączają przełączniki „Funkcje wyszukiwania”
| Przełącznik | Domyślnie | Co robi |
|---|---|---|
| Aktywność | — | włącza wyszukiwarkę na stronie. Wyłączenie usuwa indeks wyszukiwania — patrz co zniknie |
| Wyszukiwanie głosowe | włączone | przycisk mikrofonu w polu wyszukiwania: zapytanie się dyktuje, przeglądarka rozpoznaje mowę |
| Wyszukiwanie po atrybutach | włączone | szuka po parametrach i pokazuje filtry według nich; działa po aktualizacji indeksu |
| Pokazuj czat AI | włączone | asystent AI w oknie wyszukiwania — jak to działa |
| Szybkie otwieranie wyszukiwania | wyłączone | widżet wczytuje się razem ze stroną — patrz niżej |
Szybkie otwieranie wyszukiwania
Domyślnie widżet nie uruchamia się od razu, lecz po oznakach żywego odwiedzającego: ruchu myszy, dotyku, przewijania. Boty, które tylko wczytują strony, takich oznak nie dają, więc usługa wyszukiwania nie jest na nie zużywana. Ceną jest to, że pierwsze kliknięcie w pole wyszukiwania czasem pokazuje „Loading...”, dopóki widżet się doczytuje.
Przełącznik „Szybkie otwieranie wyszukiwania” usuwa to opóźnienie: widżet wczytuje się razem ze stroną, a działania klienta wykonane przed końcem wczytywania — kliknięcie w pole, pierwsze litery — nie giną i wykonują się, gdy tylko widżet jest gotowy.
W zamian ochrona przed botami słabnie: znane boty widżet nadal rozpoznaje po nazwie przeglądarki i się nie uruchamia, ale bot podszywający się pod zwykłą przeglądarkę będzie odpytywał usługę, więc zapytań przybędzie.
- Po zapisaniu serwer od razu zaczyna odsiewać boty po nazwie przeglądarki. Sam szybki start włącza się u każdego odwiedzającego od następnego wyświetlenia strony: za pierwszym razem widżet poznaje ustawienia i uruchamia się zwykle. Po wyłączeniu przełącznika jeszcze jedno wyświetlenie też przejdzie w trybie szybkim.
- Po włączeniu sprawdź na iPhonie, czy klawiatura otwiera się od pierwszego dotknięcia pola wyszukiwania.
Co klient widzi w pustym polu wyszukiwania
Zakładka „Informacje”, sekcja „Pole wyszukiwania na stronie”.
- Tekst podpowiedzi w polu wyszukiwania — szary tekst w pustym polu. Puste — standardowa podpowiedź w języku odwiedzającego; własny tekst jest pokazywany jednakowo we wszystkich językach.
- Lista słów do symulacji pisania w polu wyszukiwania (oddzielone przecinkami) — przykładowe słowa, które wpisują się w polu same, jakby pisał je człowiek. Pole jest osobne dla każdego włączonego języka strony: klient widzi słowa w swoim języku, a jeśli pole jego języka jest puste — słowa języka głównego.
Na tej samej zakładce:
- Informacje o widżecie — „Nazwa” i „Opis” są potrzebne tylko Tobie na liście widżetów, klienci ich nie widzą.
- Komunikat „Dane sklepu pochodzą z karty firmy” pokazuje, które dane sklepu są wypełnione, a które nie: logo (widać je w nagłówku okna wyszukiwania), nazwę, kontakty, adres, godziny otwarcia i warunki sklepu widżet bierze z karty firmy. Przycisk „Zmień w karcie firmy” ją otwiera.
1
Dane sklepu2
Podpowiedź3
Przykładowe słowa- Widżet bierze logo, nazwę, kontakty i warunki sklepu z karty firmy.
- Puste — standardowa podpowiedź w języku odwiedzającego.
- Słowa wpisują się w polu same; każdy język ma własne pole.
Scenariusze
Strona na OpenCart z motywem OCT ShowCase
Co zrobić. Podaj „Adres strony”, wybierz „CMS ID” — OpenCart i „CMS theme” — OCT ShowCase, wklej kod integracji do <head>.
Efekt. Selektory pola i przycisku mobilnego, kod koszyka i linki do stron są wypełnione; wyszukiwarka zastępuje pole motywu, także na telefonie.
Na telefonie pole wyszukiwania jest ukryte pod ikoną lupy
Co zrobić. Oprócz selektora pola wyszukiwania wypełnij Selektor CSS przycisku wyszukiwania w wersji mobilnej.
Efekt. Na telefonie wyszukiwarka otwiera się tym przyciskiem, filtry — w wysuwanym panelu. Bez tego selektora na telefonie wyszukiwarka się nie otwiera.
Pierwsze kliknięcie w pole wyszukiwania pokazuje „Loading...”
Co zrobić. Włącz „Szybkie otwieranie wyszukiwania” i sprawdź na iPhonie, czy klawiatura otwiera się od pierwszego dotknięcia.
Efekt. Widżet wczytuje się razem ze stroną, a kliknięcie i pierwsze litery wpisane przed końcem wczytywania nie giną. Pierwsze wyświetlenie po zapisaniu idzie jeszcze w trybie zwykłym.
Co zrobić, gdy widżet nie działa jak należy
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Widżet nie pojawił się na stronie | kod integracji nie jest wklejony, wklejono go poza <head> lub skopiowano przy wyłączonej „Aktywność” | włączyć „Aktywność”, otworzyć formularz ponownie, skopiować kod od nowa i wkleić do szablonu |
| Widżet jest, ale nie stanął w miejscu pola wyszukiwania | w ustawieniach jest błędny selektor CSS | podać selektor dokładnie tego elementu, który zastępujemy |
| Pole wyszukiwania na stronie jest zwykłe, bez widżetu | „Aktywność” jest wyłączona albo nie ma tabel indeksu wyszukiwania | włączyć „Aktywność” i zbudować indeks |
| Na telefonie wyszukiwarka się nie otwiera | nie ustawiono selektora przycisku wyszukiwania w wersji mobilnej | wypełnić osobne pole dla wersji mobilnej |
| Na kartach produktów nie ma przycisku „Kup” | nie podano kodu JS dodawania do koszyka albo produkty nie mają ID z CMS | wypełnić kod przycisków |
Najczęstsze pytania
Jak zobaczyć widżet przed wklejeniem na stronę produkcyjną?
Przyciskiem „Otwórz stronę demo” w sekcji „Strona i pole wyszukiwania”. Same wyniki sprawdza się na zakładce „Test wyszukiwania” — więcej w artykule jak ustawić wyniki wyszukiwania.
Czy kod zniknie ze strony, jeśli wyłączę inteligentną wyszukiwarkę?
Nie. Kod w <head> to wiersz szablonu Twojej strony, usuwasz go Ty. Więcej: co zniknie po wyłączeniu inteligentnej wyszukiwarki.
Gdzie zmienić logo i dane sklepu dla wyszukiwarki?
W karcie firmy: wyszukiwarka bierze je stamtąd i aktualizuje sama. Przycisk „Zmień w karcie firmy” na zakładce „Informacje” ją otwiera.
Gdzie jest przycisk „Zapisz”?
Nie ma go: formularz zapisuje się sam przy każdej zmianie pola i przy zamykaniu okna, a strona widzi zmiany po odświeżeniu. Osobny przycisk ma tylko warunek na zakładce „Ograniczenia”.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Kategorie → kafelek „Ustawienia widżetu - Inteligentne wyszukiwanie”
- Uprawnienia
- okno „Widżet inteligentnej wyszukiwarki produktów” w uprawnieniach grup
- Przygotuj
- dostęp do szablonu Twojej strony, aby wkleić kod do
<head>
Powiązane tematy
- Jeśli potrzebny jest ogólny obraz — inteligentna wyszukiwarka na stronie: co potrafi i od czego zacząć.
- Jeśli widżet stoi, a wyszukiwarka nic nie znajduje, — jak zbudować indeks wyszukiwania.
- Jeśli drugi język strony ma prefiks
/ru/— linki do produktów i prefiksy językowe. - Jeśli okno wyszukiwania trzeba dopasować do wyglądu strony — wygląd okna wyszukiwania.
- Jeśli sklep działa na Elbuz CMS — moduł inteligentnej wyszukiwarki zamiast widżetu.
