↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć inteligentną wyszukiwarkę do strony

    5 min czytaniaZaktualizowano

    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ładkaCo na niej jestGdzie opisano
    Ustawieniaprzełączniki funkcji, strona i selektory, synonimy, indeks wyszukiwania, kod integracji, APItutaj; synonimy, indeks, API
    Informacjepodsumowanie danych sklepu z karty firmy, podpowiedź i słowa w polu wyszukiwania, nazwa widżetututaj
    Linkistrony sklepu, szablony linków do produktu, kategorii, zdjęcialinki i prefiksy językowe
    Cenypole ceny, RRP (sugerowana cena detaliczna), cena promocyjna i stara cena, walutaceny i waluta
    Ograniczeniadostępność, warunek wyboru produktówktóre produkty pokazywać
    Wyglądokno, kolory, wyniki, przyciski, bloki, pola, osadzanie, własny CSS i JSwygląd okna wyszukiwania
    Zdarzeniakod JS przycisków koszyka, ulubionych i porównania, ID produktu ze stronykoszyk, ulubione i porównanie
    Test wyszukiwaniate same wyniki co na stronie, bez zainstalowanego widżetusprawdzanie 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).

    1. Włącz „Aktywność” w sekcji „Funkcje wyszukiwania”. Bez niej wyszukiwarka na stronie nie działa, a kod integracji nie zawiera wyszukiwarki.
    2. 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.
    3. 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.
    4. 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.
    5. 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.
    6. 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”.

    Zakładka „Ustawienia” widżetu „Inteligentne wyszukiwanie”: przełączniki funkcji i pola podłączenia do strony
    1Wyszukiwarka na stronie
    2Szybkie otwieranie
    3Adres strony
    4CMS i motyw
    5Pole wyszukiwania strony
    6Przycisk wyszukiwania na telefonie
    1. Bez „Aktywność” wyszukiwarka na stronie nie działa, a kod integracji nie zawiera wyszukiwarki.
    2. Widżet wczytuje się razem ze stroną, bez czekania na oznaki żywego odwiedzającego.
    3. Strona, na której będzie działał widżet.
    4. Wybór CMS sam wypełnia selektory, kod przycisków koszyka i adresy stron.
    5. Miejsce na stronie, które zastąpi widżet.
    6. 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.
    Okno „Zastosować ustawienia CMS?” z listą wypełnionych pól i przyciskami „Zastąp”, „Wypełnij tylko puste” i „Anuluj”
    1Pytanie
    2Pola, które się zmienią
    3Zastąp
    4Tylko puste
    5Anuluj
    1. Program pyta tylko wtedy, gdy szablon zmieniłby pola, które już wypełniono.
    2. Szablon zastąpi Twoje wartości w tych polach.
    3. Wszystko z szablonu CMS.
    4. Twoje wartości zostają; szablon trafia tylko do pustych pól.
    5. 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łącznikDomyślnieCo robi
    Aktywność—włącza wyszukiwarkę na stronie. Wyłączenie usuwa indeks wyszukiwania — patrz co zniknie
    Wyszukiwanie głosowewłączoneprzycisk mikrofonu w polu wyszukiwania: zapytanie się dyktuje, przeglądarka rozpoznaje mowę
    Wyszukiwanie po atrybutachwłączoneszuka po parametrach i pokazuje filtry według nich; działa po aktualizacji indeksu
    Pokazuj czat AIwłączoneasystent AI w oknie wyszukiwania — jak to działa
    Szybkie otwieranie wyszukiwaniawyłączonewidż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.
    Zakładka „Informacje”: dane sklepu z karty firmy, podpowiedź pola wyszukiwania i słowa do symulacji pisania
    1Dane sklepu
    2Podpowiedź
    3Przykładowe słowa
    1. Widżet bierze logo, nazwę, kontakty i warunki sklepu z karty firmy.
    2. Puste — standardowa podpowiedź w języku odwiedzającego.
    3. 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 widziszDlaczego tak jestCo zrobić
    Widżet nie pojawił się na stroniekod 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 wyszukiwaniaw ustawieniach jest błędny selektor CSSpodać 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 wyszukiwaniawłączyć „Aktywność” i zbudować indeks
    Na telefonie wyszukiwarka się nie otwieranie ustawiono selektora przycisku wyszukiwania w wersji mobilnejwypeł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 CMSwypeł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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo