↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak podłączyć koszyk, ulubione i porównanie do okna inteligentnej wyszukiwarki

    4 min czytaniaZaktualizowano

    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

    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 IDJaki kod jest wstawiany
    OpenCartwszystkie 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), Horoshopwszystkie sześć akcji
    Shopifytylko dodanie do koszyka i usunięcie z niego
    PrestaShop, BigCommerce, Squarespace Commercebrak 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.
    Sekcja „Kod JS dla przycisków i zdarzeń” z kodem wstawionym po wybraniu CMS OpenCart i motywu OCT Deals
    1Dodanie do koszyka
    2Usunięcie z koszyka
    3Lista życzeń
    4Porównanie
    1. Kod wykonuje się w przeglądarce klienta; ID produktu w CMS to productData.id_ext.
    2. Bez kodu dodawania do koszyka na karcie nie ma przycisku „Kup”.
    3. Dodanie i usunięcie to osobne pola.
    4. 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.

    PoleCo zawiera
    productData.idID produktu w Elbuz
    productData.id_extID produktu w Twoim CMS — właśnie na nie czeka koszyk strony
    productData.name, sku, mpnnazwa, kod sklepu, kod producenta
    productData.pricecena tak, jak widać ją na karcie, razem ze znakiem waluty
    productData.url, image_urladres strony produktu i zdjęcia
    productData.category_id, category, brandkategoria 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:

    1. Jeśli produkt ma ID z CMS, a pole „Zawsze…” jest odznaczone — używane jest to ID, strona się nie wczytuje.
    2. W przeciwnym razie przeglądarka klienta wczytuje stronę produktu z linku z wyszukiwarki.
    3. Dla CSS brany jest pierwszy znaleziony element: wartość pola, atrybut data-id lub data-product-id, atrybut content albo tekst — co znajdzie się pierwsze.
    4. Dla Regex brana jest pierwsza grupa w nawiasach: "product_id":\s*(\d+) da liczbę.
    5. Znalezione ID trafia do productData.id_ext i 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.

    Sekcja „Pobieranie ID produktu”: selektor CSS elementu z ID na stronie produktu
    1Czego szukać
    2CSS lub Regex
    3Zawsze ze strony
    1. Element strony produktu, w którym jest jego ID w CMS.
    2. Regex bierze pierwszą grupę w nawiasach.
    3. 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 widziszDlaczego tak jestCo zrobić
    Na karcie nie ma przycisku „Kup”pusty kod „Dodanie do koszyka”, produkt jest niedostępny lub nie ma ID produktu z CMSwybrać CMS lub wpisać kod; wypełnić „Pobieranie ID produktu”
    Produkt jest w ulubionych w oknie wyszukiwania, a na stronie — niepuste pole kodu tej akcjiwybrać CMS lub wpisać kod
    Dodaje się nie ten produktw kodzie użyto productData.id zamiast id_extprzekazywać koszykowi productData.id_ext
    Koszyk strony odpowiada błędem „nie znaleziono produktu”ID produktu z CMS w katalogu jest inne niż na stroniewypeł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

    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