Кнопки «Купити», «Додати до списку бажань» і «Додати до порівняння» у вікні розумного пошуку Elbuz викликають код JavaScript вашого сайту, і товар потрапляє в кошик сайту, не виходячи з пошуку. Для поширених CMS цей код програма підставляє сама.
Коли це знадобиться:
- На картках у пошуку немає кнопки «Купити» — вона з'являється, коли є код додавання в кошик.
- Сайт на OpenCart, WooCommerce, Magento, Horoshop чи Elbuz CMS — вибір CMS заповнює всі шість полів готовим кодом.
- У каталозі Elbuz немає ID товару з вашої CMS — віджет сам бере його зі сторінки товару.
З чого почати: вкладка «Налаштування» → виберіть «CMS ID» → перевірте код на вкладці «Події».
Що вміють кнопки дій у вікні пошуку
- Беруть готовий код для вашої CMS — вибір CMS і теми заповнює код кнопок.
- Виконують ваш код — шість дій: додати й прибрати з кошика, обраного й порівняння.
- Передають у код дані товару — ID у Elbuz і в 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. Без коду кнопки немає.
- Обране й порівняння показуються й без коду: товар потрапляє в список у самому вікні пошуку, але у списки вашого сайту нічого не йде.
- Код з помилкою — дія на сайті не виконується, покупець бачить вікно віджета з помилкою.
1
Додати в кошик2
Прибрати з кошика3
Обране4
Порівняння- Код виконується в браузері покупця; ID товару в CMS — productData.id_ext.
- Без коду додавання кнопки «Купити» на картці немає.
- Додавання й видалення — окремі поля.
- Код підставлено вибором «CMS ID» і «CMS theme».
Які дані товару отримує код
У коді доступна змінна productData — товар, на якому натиснули кнопку. Код видалення зі списків отримує той самий ID з CMS, що й код додавання, зокрема взятий зі сторінки товару.
| Поле | Що в ньому |
|---|---|
productData.id | ID товару в Elbuz |
productData.id_ext | ID товару у вашій 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 у каталозі є, але не той, що потрібен кошику.
Що відбувається, коли покупець натискає кнопку:
- Якщо в товару є ID з CMS і прапорець «Завжди…» знято — береться він, сторінка не завантажується.
- Інакше браузер покупця завантажує сторінку товару за його посиланням з пошуку.
- Для CSS береться перший знайдений елемент: його значення поля, атрибут
data-idчиdata-product-id, атрибутcontentабо текст — що знайдеться першим. - Для Regex береться перша група в дужках:
"product_id":\s*(\d+)дасть число. - Знайдений ID підставляється в
productData.id_ext, і виконується код кнопки. Повторні натискання на тій самій сторінці сайту сторінку товару вже не завантажують.
Якщо сторінка не відкрилась чи нічого не знайдено, код кнопки виконується з тим ID, що був. Тому посилання на товар мають вести на ваш сайт — див. шаблон посилання на товар.
1
Що шукати2
CSS чи Regex3
Завжди зі сторінки- Елемент сторінки товару з його ID у CMS.
- Regex бере першу групу в дужках.
- Навіть коли 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»
- Право доступу
- вікно «Віджет розумного пошуку товарів» у «Правах груп»
- Підготувати
- знати, як кошик вашого сайту додає товар
Суміжні теми
- Якщо потрібна загальна картина — розумний пошук на сайті: що він уміє і з чого почати.
- Якщо кнопки на картці товару не видно — які кнопки показувати.
- Якщо кнопка веде не на ту сторінку товару — як налаштувати посилання.
- Якщо віджет ще не стоїть на сайті — як підключити розумний пошук.
