Przyciski „Kup”, „Dodaj do listy życzeń” i „Dodaj do porównania” w oknie inteligentnej wyszukiwarki Elbuz wywołują kod JavaScript Twojej strony, a produkt trafia do koszyka strony bez wychodzenia z wyszukiwarki. Dla popularnych CMS program wstawia ten kod sam.
Kiedy to się przyda:
- Na kartach w wyszukiwarce nie ma przycisku „Kup” — pojawia się, gdy jest kod dodawania do koszyka.
- Strona działa na OpenCart, WooCommerce, Magento, Horoshop lub Elbuz CMS — wybór CMS wypełnia wszystkie sześć pól gotowym kodem.
- W katalogu Elbuz nie ma ID produktu z Twojego CMS — widżet sam pobiera je ze strony produktu.
Od czego zacząć: zakładka „Ustawienia” → wybierz „CMS ID” → sprawdź kod na zakładce „Zdarzenia”.
Co potrafią przyciski akcji w oknie wyszukiwania
- Biorą gotowy kod dla Twojego CMS — wybór CMS i motywu wypełnia kod przycisków.
- Wykonują Twój kod — sześć akcji: dodanie i usunięcie z koszyka, ulubionych i porównania.
- Przekazują do kodu dane produktu — ID w Elbuz i w CMS, nazwę, cenę, adres, zdjęcie.
- Znajdują ID produktu na stronie — gdy nie ma go w katalogu.
To, które przyciski w ogóle są widoczne na karcie produktu, włączasz na zakładce „Wygląd” — przyciski akcji.
Jak dostać gotowy kod dla swojego CMS
Na zakładce „Ustawienia” w sekcji „Strona i pole wyszukiwania” wybierz „CMS ID”, dla OpenCart — także „CMS theme”. Program wypełnia kod przycisków na zakładce „Zdarzenia”, selektory, style potrzebne CMS i adresy stron, dla Horoshop — także „Pobieranie ID produktu”. Puste pola wypełniają się od razu, a przed zastąpieniem tego, co już wpisano, program pokazuje listę pól i pyta: „Zastąp”, „Wypełnij tylko puste” lub „Anuluj”. Więcej: co wypełnia wybór CMS.
| CMS ID | Jaki kod jest wstawiany |
|---|---|
| OpenCart | wszystkie sześć akcji; z motywem OCT ShowCase, OCT Deals lub OCT Promo kod dodatkowo odświeża liczniki koszyka, ulubionych i porównania w nagłówku motywu |
| Elbuz CMS, WooCommerce (WordPress), Magento (Adobe Commerce), Horoshop | wszystkie sześć akcji |
| Shopify | tylko dodanie do koszyka i usunięcie z niego |
| PrestaShop, BigCommerce, Squarespace Commerce | brak kodu — pola zostają bez zmian, kod piszesz sam |
W WooCommerce ulubione i porównanie działają tylko z osobnymi wtyczkami tych list na stronie.
Co robi kod każdego przycisku
W sekcji „Kod JS dla przycisków i zdarzeń” jest sześć pól: „Dodanie do koszyka”, „Usunięcie z koszyka”, „Dodanie do listy życzeń”, „Usunięcie z listy życzeń”, „Dodaj do porównania”, „Usunięcie z porównania”. Kod wykonuje się w przeglądarce klienta, gdy kliknie on odpowiedni przycisk w oknie wyszukiwania.
- Przycisk „Kup” jest widoczny na karcie tylko wtedy, gdy jednocześnie: jest włączony na zakładce „Wygląd”, produkt jest dostępny, pole „Dodanie do koszyka” jest wypełnione, a produkt ma ID z CMS lub wypełniono pobieranie ID. Bez kodu przycisku nie ma.
- Ulubione i porównanie są widoczne także bez kodu: produkt trafia na listę w samym oknie wyszukiwania, ale do list Twojej strony nic nie trafia.
- Kod z błędem — akcja na stronie się nie wykonuje, klient widzi okno widżetu z błędem.
1
Dodanie do koszyka2
Usunięcie z koszyka3
Lista życzeń4
Porównanie- Kod wykonuje się w przeglądarce klienta; ID produktu w CMS to productData.id_ext.
- Bez kodu dodawania do koszyka na karcie nie ma przycisku „Kup”.
- Dodanie i usunięcie to osobne pola.
- Kod wstawiono, wybierając „CMS ID” i „CMS theme”.
Jakie dane produktu dostaje kod
W kodzie dostępna jest zmienna productData — produkt, na którym kliknięto przycisk. Kod usuwania z list dostaje to samo ID z CMS co kod dodawania, także pobrane ze strony produktu.
| Pole | Co zawiera |
|---|---|
productData.id | ID produktu w Elbuz |
productData.id_ext | ID produktu w Twoim CMS — właśnie na nie czeka koszyk strony |
productData.name, sku, mpn | nazwa, kod sklepu, kod producenta |
productData.price | cena tak, jak widać ją na karcie, razem ze znakiem waluty |
productData.url, image_url | adres strony produktu i zdjęcia |
productData.category_id, category, brand | kategoria i marka |
Poza produktem w kodzie są showCartSuccessModal i showErrorModal — okna widżetu „Produkt dodany” i „Błąd”, a także fetch do zapytania do strony.
Przykład dla koszyka OpenCart, który czeka na ID produktu w CMS:
fetch('index.php?route=checkout/cart/add', {
method: 'POST',
headers: {'Content-Type': 'application/x-www-form-urlencoded'},
body: new URLSearchParams({product_id: productData.id_ext, quantity: 1})
});
Jak pobrać ID produktu ze strony serwisu
Koszyk strony przyjmuje produkt po jego ID w CMS. Gdy takiego ID nie ma w katalogu Elbuz — katalog nie powstał przez eksport na stronę, tylko z innego źródła — wypełnij sekcję „Pobieranie ID produktu” na zakładce „Zdarzenia”.
- Selektor CSS lub Regex do pobrania ID produktu ze strony — czego szukać na stronie produktu.
- Sposób pobierania — CSS (domyślnie) lub Regex.
- Zawsze pobieraj ID ze strony produktu, nawet jeśli id_ext jest wypełnione — gdy ID w katalogu jest, ale nie to, którego potrzebuje koszyk.
Co się dzieje, gdy klient klika przycisk:
- Jeśli produkt ma ID z CMS, a pole „Zawsze…” jest odznaczone — używane jest to ID, strona się nie wczytuje.
- W przeciwnym razie przeglądarka klienta wczytuje stronę produktu z linku z wyszukiwarki.
- Dla CSS brany jest pierwszy znaleziony element: wartość pola, atrybut
data-idlubdata-product-id, atrybutcontentalbo tekst — co znajdzie się pierwsze. - Dla Regex brana jest pierwsza grupa w nawiasach:
"product_id":\s*(\d+)da liczbę. - Znalezione ID trafia do
productData.id_exti wykonuje się kod przycisku. Kolejne kliknięcia na tej samej stronie serwisu nie wczytują już strony produktu.
Jeśli strona się nie otworzyła lub nic nie znaleziono, kod przycisku wykonuje się z dotychczasowym ID. Dlatego linki do produktów muszą prowadzić do Twojego serwisu — patrz szablon linku do produktu.
1
Czego szukać2
CSS lub Regex3
Zawsze ze strony- Element strony produktu, w którym jest jego ID w CMS.
- Regex bierze pierwszą grupę w nawiasach.
- Nawet gdy katalog ma ID z CMS.
Scenariusze
Strona na OpenCart z motywem OCT Deals
Co zrobić. Podaj „Adres strony”, wybierz „CMS ID” — OpenCart i „CMS theme” — OCT Deals.
Efekt. Przyciski w oknie wyszukiwania dodają produkt do koszyka strony i odświeżają liczniki w nagłówku motywu, a pod listą koszyka w oknie wyszukiwania są przyciski przejścia do koszyka i do składania zamówienia.
Katalog zebrany od dostawców, bez ID produktów ze strony
Co zrobić. Znajdź na stronie produktu w swoim serwisie element z ID — na przykład ukryte pole input[name="product_id"] — i wpisz go w „Selektor CSS lub Regex do pobrania ID produktu ze strony”.
Efekt. Przy pierwszym kliknięciu widżet otworzy stronę produktu w tle, pobierze ID i przekaże je koszykowi strony.
Potrzebna własna akcja po dodaniu
Co zrobić. Na końcu kodu „Dodanie do koszyka” dopisz własne wywołanie, na przykład otwarcie bocznego koszyka Twojego motywu.
Efekt. Po dodaniu klient od razu widzi koszyk strony.
Co zrobić, gdy przycisk nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Na karcie nie ma przycisku „Kup” | pusty kod „Dodanie do koszyka”, produkt jest niedostępny lub nie ma ID produktu z CMS | wybrać CMS lub wpisać kod; wypełnić „Pobieranie ID produktu” |
| Produkt jest w ulubionych w oknie wyszukiwania, a na stronie — nie | puste pole kodu tej akcji | wybrać CMS lub wpisać kod |
| Dodaje się nie ten produkt | w kodzie użyto productData.id zamiast id_ext | przekazywać koszykowi productData.id_ext |
| Koszyk strony odpowiada błędem „nie znaleziono produktu” | ID produktu z CMS w katalogu jest inne niż na stronie | wypełnić „Pobieranie ID produktu” i włączyć „Zawsze pobieraj…” |
Najczęstsze pytania
Dlaczego na kartach w wyszukiwarce nie ma przycisku „Kup”?
Jest widoczny tylko z kodem „Dodanie do koszyka”, dla produktów dostępnych i z ID produktu z CMS. Wybierz CMS lub wpisz kod, w razie potrzeby wypełnij „Pobieranie ID produktu”.
Co wybrać dla sklepu na Elbuz CMS?
„CMS ID” — Elbuz CMS. W sklepie utworzonym w Elbuz wyszukiwarka konfiguruje się sama podczas tworzenia.
Jak otworzyć boczny koszyk motywu po dodaniu?
Dopisz wywołanie otwarcia koszyka Twojego motywu na końcu kodu „Dodanie do koszyka”. Dla OpenCart z motywami OCT kod już to robi.
Co lepsze — CSS czy Regex?
CSS, jeśli ID jest w atrybucie lub polu strony. Regex — jeśli ID jest tylko w tekście skryptu strony.
Czy pobieranie ID spowalnia działanie przycisku?
Tylko przy pierwszym kliknięciu na produkcie: przeglądarka wczytuje jego stronę. Kolejne kliknięcia na tej samej stronie biorą już znalezione ID.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Kategorie → kafelek „Ustawienia widżetu - Inteligentne wyszukiwanie” → zakładka „Zdarzenia”
- Inne wejścia
- gotowy kod — zakładka „Ustawienia”, pola „CMS ID” i „CMS theme”
- Uprawnienia
- okno „Widżet inteligentnej wyszukiwarki produktów” w uprawnieniach grup
- Przygotuj
- wiedzę, jak koszyk Twojej strony dodaje produkt
Powiązane tematy
- Jeśli potrzebny jest ogólny obraz — inteligentna wyszukiwarka na stronie: co potrafi i od czego zacząć.
- Jeśli przycisku nie widać na karcie produktu — które przyciski pokazywać.
- Jeśli przycisk prowadzi na niewłaściwą stronę produktu — jak ustawić linki.
- Jeśli widżetu jeszcze nie ma na stronie — jak podłączyć inteligentną wyszukiwarkę.
