↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Сайт і віджети
    4. Розумний пошук

    Як підключити кошик, обране й порівняння до вікна розумного пошуку

    5 хв читанняОновлено

    Кнопки «Купити», «Додати до списку бажань» і «Додати до порівняння» у вікні розумного пошуку Elbuz викликають код JavaScript вашого сайту, і товар потрапляє в кошик сайту, не виходячи з пошуку. Для поширених CMS цей код програма підставляє сама.

    Коли це знадобиться:

    • На картках у пошуку немає кнопки «Купити» — вона з'являється, коли є код додавання в кошик.
    • Сайт на OpenCart, WooCommerce, Magento, Horoshop чи Elbuz CMS — вибір CMS заповнює всі шість полів готовим кодом.
    • У каталозі Elbuz немає ID товару з вашої CMS — віджет сам бере його зі сторінки товару.

    З чого почати: вкладка «Налаштування» → виберіть «CMS ID» → перевірте код на вкладці «Події».

    Що вміють кнопки дій у вікні пошуку

    Які кнопки взагалі показуються на картці товару, вмикається на вкладці «Вигляд» — кнопки дій.

    Як отримати готовий код для своєї CMS

    На вкладці «Налаштування» в картці «Сайт і рядок пошуку» виберіть «CMS ID», для OpenCart — ще й «CMS theme». Програма заповнює код кнопок на вкладці «Події», селектори, потрібні CMS стилі й адреси сторінок, для Horoshop — ще й «Витягування ID товару». Порожні поля заповнюються одразу, а перед заміною того, що ви вже вписали, програма показує список полів і питає: «Замінити», «Заповнити лише порожні» чи «Скасувати». Детальніше: що заповнює вибір CMS.

    CMS IDЯкий код підставляється
    OpenCartусі шість дій; з темою OCT ShowCase, OCT Deals чи OCT Promo код ще й оновлює лічильники кошика, обраного й порівняння в шапці теми
    Elbuz CMS, WooCommerce (WordPress), Magento (Adobe Commerce), Horoshopусі шість дій
    Shopifyлише додавання в кошик і видалення з нього
    PrestaShop, BigCommerce, Squarespace Commerceкоду немає — поля лишаються як є, код пишете самі

    Для WooCommerce обране й порівняння працюють лише з окремими плагінами цих списків на сайті.

    Що робить код кожної кнопки

    У картці «Код JS для кнопок та подій» шість полів: «Додавання в кошик», «Видалення з кошика», «Додавання до списку бажань», «Видалення зі списку бажань», «Додати до порівняння», «Видалення з порівняння». Код виконується в браузері покупця, коли він натискає відповідну кнопку у вікні пошуку.

    • Кнопка «Купити» показується на картці, лише коли одночасно: вона ввімкнена на вкладці «Вигляд», товар є в наявності, поле «Додавання в кошик» заповнене, і в товару є ID з CMS або заповнено витягування ID. Без коду кнопки немає.
    • Обране й порівняння показуються й без коду: товар потрапляє в список у самому вікні пошуку, але у списки вашого сайту нічого не йде.
    • Код з помилкою — дія на сайті не виконується, покупець бачить вікно віджета з помилкою.
    Картка «Код JS для кнопок та подій» з кодом, який підставив вибір CMS OpenCart і теми OCT Deals
    1Додати в кошик
    2Прибрати з кошика
    3Обране
    4Порівняння
    1. Код виконується в браузері покупця; ID товару в CMS — productData.id_ext.
    2. Без коду додавання кнопки «Купити» на картці немає.
    3. Додавання й видалення — окремі поля.
    4. Код підставлено вибором «CMS ID» і «CMS theme».

    Які дані товару отримує код

    У коді доступна змінна productData — товар, на якому натиснули кнопку. Код видалення зі списків отримує той самий ID з CMS, що й код додавання, зокрема взятий зі сторінки товару.

    ПолеЩо в ньому
    productData.idID товару в Elbuz
    productData.id_extID товару у вашій CMS — саме його чекає кошик сайту
    productData.name, sku, mpnназва, артикул магазину, артикул виробника
    productData.priceціна так, як її видно на картці, разом зі знаком валюти
    productData.url, image_urlадреса сторінки товару й фото
    productData.category_id, category, brandкатегорія й бренд

    Крім товару, у коді є showCartSuccessModal і showErrorModal — вікна віджета «Товар додано» й «Помилка», а також fetch для запиту до сайту.

    Приклад для кошика OpenCart, який чекає ID товару в 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})
    });

    Як узяти ID товару зі сторінки сайту

    Кошик сайту приймає товар за його ID у CMS. Коли такого ID в каталозі Elbuz немає — каталог зібрано не вивантаженням на сайт, а з іншого джерела, — заповніть картку «Витягування ID товару» на вкладці «Події».

    • CSS-селектор або Regex для витягування ID товару зі сторінки — що шукати на сторінці товару.
    • Тип витягування — CSS (за замовчуванням) чи Regex.
    • Завжди витягувати ID зі сторінки товару, навіть якщо id_ext заповнений — коли ID у каталозі є, але не той, що потрібен кошику.

    Що відбувається, коли покупець натискає кнопку:

    1. Якщо в товару є ID з CMS і прапорець «Завжди…» знято — береться він, сторінка не завантажується.
    2. Інакше браузер покупця завантажує сторінку товару за його посиланням з пошуку.
    3. Для CSS береться перший знайдений елемент: його значення поля, атрибут data-id чи data-product-id, атрибут content або текст — що знайдеться першим.
    4. Для Regex береться перша група в дужках: "product_id":\s*(\d+) дасть число.
    5. Знайдений ID підставляється в productData.id_ext, і виконується код кнопки. Повторні натискання на тій самій сторінці сайту сторінку товару вже не завантажують.

    Якщо сторінка не відкрилась чи нічого не знайдено, код кнопки виконується з тим ID, що був. Тому посилання на товар мають вести на ваш сайт — див. шаблон посилання на товар.

    Картка «Витягування ID товару»: CSS-селектор елемента з ID на сторінці товару
    1Що шукати
    2CSS чи Regex
    3Завжди зі сторінки
    1. Елемент сторінки товару з його ID у CMS.
    2. Regex бере першу групу в дужках.
    3. Навіть коли ID з CMS у каталозі є.

    Сценарії

    Сайт на OpenCart з темою OCT Deals

    Що зробити. Вкажіть «Адресу сайту», виберіть «CMS ID» — OpenCart і «CMS theme» — OCT Deals.

    Що вийде. Кнопки у вікні пошуку кладуть товар у кошик сайту й оновлюють лічильники в шапці теми, під списком кошика у вікні пошуку є кнопки переходу в кошик і до оформлення замовлення.

    Каталог зібрано з постачальників, ID товарів сайту в ньому немає

    Що зробити. Знайдіть на сторінці товару вашого сайту елемент з ID — наприклад, приховане поле input[name="product_id"] — і впишіть його в «CSS-селектор або Regex для витягування ID товару зі сторінки».

    Що вийде. Під час першого натискання віджет відкриє сторінку товару у фоні, візьме ID і передасть його кошику сайту.

    Потрібна своя дія після додавання

    Що зробити. У кінець коду «Додавання в кошик» допишіть свій виклик, наприклад відкриття бічного кошика вашої теми.

    Що вийде. Після додавання покупець одразу бачить кошик сайту.

    Що робити, коли кнопка не спрацьовує

    Що ви бачитеЧому такЩо зробити
    На картці немає кнопки «Купити»порожній код «Додавання в кошик», товару немає в наявності або немає ID товару з CMSвибрати CMS чи вписати код; заповнити «Витягування ID товару»
    Товар є в обраному у вікні пошуку, а на сайті — ніпорожнє поле коду цієї діївибрати CMS або вписати код
    Додається не той товару коді використано productData.id замість id_extпередавати кошику productData.id_ext
    Кошик сайту відповідає помилкою «товар не знайдено»ID товару з CMS у каталозі не той, що на сайтізаповнити «Витягування ID товару» й увімкнути «Завжди витягувати…»

    Часті запитання

    Чому на картках у пошуку немає кнопки «Купити»?

    Вона показується лише з кодом «Додавання в кошик», для товарів у наявності й з ID товару з CMS. Виберіть CMS або впишіть код, за потреби заповніть «Витягування ID товару».

    Що вибрати для магазину на Elbuz CMS?

    «CMS ID» — Elbuz CMS. Магазину, створеному в Elbuz, пошук налаштовується сам під час створення.

    Як відкрити бічний кошик теми після додавання?

    Допишіть виклик відкриття кошика вашої теми в кінець коду «Додавання в кошик». Для OpenCart з темами OCT код уже це робить.

    Що краще — CSS чи Regex?

    CSS, якщо ID лежить в атрибуті чи полі сторінки. Regex — якщо ID є лише в тексті скрипта сторінки.

    Чи сповільнює витягування ID роботу кнопки?

    Лише перше натискання на товарі: браузер завантажує його сторінку. Повторні натискання на тій самій сторінці беруть уже знайдений ID.

    Де це і хто має доступ

    Меню
    Довідники → Категорії → плитка «Налаштування віджету - Розумний пошук» → вкладка «Події»
    Інші входи
    готовий код — вкладка «Налаштування», поля «CMS ID» і «CMS theme»
    Право доступу
    вікно «Віджет розумного пошуку товарів» у «Правах груп»
    Підготувати
    знати, як кошик вашого сайту додає товар

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно