Документація

Аксесуари та супутні товари

Що пропонувати до товару і де це показувати: групи, прив’язки за типом і характеристикою, знижка за покупку разом та вікно після покупки з каталогу.

На цій сторінці

Аксесуари — це супутні товари, які магазин пропонує до основного: лампочки до світильника, чохол до телефона, кришки до банок. Покупець бачить їх просто в картці товару, відмічає потрібні й кладе до кошика разом з основною покупкою, не розшукуючи їх по каталогу.

Ви описуєте один раз, що пропонувати і на яких товарах це показувати, а далі магазин підставляє групу сам — зокрема на товари, які ви заведете завтра.

Як це бачить покупець

У картці товару під кнопкою покупки з’являється блок з вашою назвою групи. У ньому перелічені супутні товари з фотографією та ціною, у кожного — позначка вибору. Поки покупець відмічає, магазин перераховує рядок «Ваш комплект», а кнопка «Додати комплект» кладе до кошика одразу й основний товар, і все відмічене. У кожного аксесуара є і власна кнопка «плюс» — узяти одну лампочку, не збираючи комплект цілком.

Друге місце — вікно після покупки з каталогу. Покупець натиснув «У кошик» на картці у списку товарів, і магазин показує вікно з аксесуарами до нього: їх можна взяти одразу, не відкриваючи сторінку товару. Вікно вимкнене за замовчуванням, його вмикають у налаштуваннях розділу. На сторінці товару для її ж товару вікна не буде — там аксесуари й так на видноті.

Група аксесуарів

Усе налаштовується групами: розділ «Каталог → Аксесуари». Група відповідає на два питання: що пропонувати і де це показувати.

Поле групи Що задає
Назва заголовок блоку, який побачить покупець: «Корисні доповнення», «Не забудьте лампочки»
Можна обрати кілька кілька позначок одразу чи лише одна на групу
Увімкнена вимкнена група не показується ніде, але залишається налаштованою

Усередині групи — список супутніх товарів. У кожного рядка свої умови:

Поле позиції Що задає
Товар що саме пропонувати; можна вказати конкретний варіант покупки, а не товар цілком
Кількість скільки штук покласти до кошика за замовчуванням
Знижка, % наскільки дешевший аксесуар при покупці разом з товаром
Запропонований за замовчуванням позначка стоїть одразу, покупцеві лишається її зняти
Порядок у якому порядку йдуть рядки в блоці

Знижка необов’язкова. Залиште нуль — аксесуар продаватиметься за звичайною ціною, і блок залишиться просто зручним способом докупити потрібне.

Де показувати групу

Це найважливіше налаштування. Магазин не вимагає перелічувати товари руками: ви описуєте правило, і група сама з’являється на відповідних товарах.

Вид прив’язки Коли зручний
Тип товару «усі світильники» — правило переживає поповнення каталогу
Категорія «усе з розділу Банки», за бажанням разом з підкатегоріями
Значення характеристики «усе, у чого об’єм 30»
Окремі товари точково, коли правило не описати

Задані види складаються за «І». Якщо ви вказали і категорію, і значення характеристики, група покажеться лише там, де зійшлося і те й інше: «банки Твіст об’ємом 30» — це категорія І характеристика. Незаповнений вид нічого не обмежує. Усередині одного виду — «або»: будь-яка з обраних категорій, будь-яке з перелічених значень.

Окремі товари — виняток. Товар, обраний руками, отримує групу незалежно від решти умов: це пряма вказівка показати її тут.

Перевірити, що вийшло, найпростіше в картці товару: там є вкладка «Аксесуари» зі списком застосовних груп і причиною прив’язки — «за типом», «за категорією», «за характеристикою» або «цей товар». Якщо групи у списку немає, умови не зійшлися.

Три способи завести групу

Руками. «Додати групу» — назва, список супутніх товарів, прив’язки. Підходить, коли набір невеликий і зрозумілий.

За умовою. Кнопка «Сформувати за умовою» збирає групу з двох вибірок: які товари вважати основними і які пропонувати до них. Магазин показує попередній перегляд — скільки товарів потрапить з кожного боку, — і заводить групу цілком. Товар, що опинився в обох вибірках, з аксесуарів виключається: пропонувати товар сам до себе немає сенсу.

Пачкою зі списку товарів. У розділі «Товари» відмітьте товари й натисніть «Призначити аксесуари». Так само працює і «Обрати всі знайдені»: відберіть фільтрами потрібне й призначте групу всьому відбору одразу. Цією ж кнопкою прив’язки знімаються: залиште поле груп порожнім і натисніть «Зняти аксесуари».

Ціна, знижка і кошик

Аксесуар потрапляє до кошика окремою позицією, а не перетворює покупку на один складений товар. Тому з ним працює все звичайне: залишки списуються, резерв тримається, позицію можна прибрати із замовлення, повернути або змінити кількість.

Знижка групи — це знижка за покупку разом з основним товаром, і магазин стежить за цим сам:

  • аксесуар, узятий окремою кнопкою, іде за звичайною ціною, а щойно основний товар опиниться в кошику, ціна перерахується;
  • прибрали основний товар з кошика — знижка з аксесуара знімається;
  • повернули — повертається.

Ціну магазин рахує в основній валюті й за тими самими правилами, що й усюди: якщо в покупця своя ціна — оптова, персональна, за акцією, — знижка аксесуара рахується від неї, а не від роздрібу. У валюту вітрини сума переводиться вже на видачі.

Округлення задається в налаштуваннях розділу. «До 10» перетворює 187 на 190 — зручно, коли ціни в магазині круглі.

Налаштування розділу

Кнопка «Налаштування» в розділі «Аксесуари».

Налаштування Що робить
Показувати блок аксесуарів на вітрині загальний вимикач: вимкнено — аксесуарів немає ніде
Приховувати аксесуари, яких немає в наявності аксесуар, що закінчився, покупець не побачить зовсім
Застосовувати знижки аксесуарів вимкнено — усе продається за звичайною ціною, знижки груп не чіпаючи
Округлення ціни зі знижкою до копійок або до кратного кроку
Пропонувати аксесуари після покупки зі списку те саме вікно в каталозі
Як часто пропонувати на кожну покупку, один раз на товар за візит або один раз за візит

«Як часто пропонувати» варто пояснити окремо. За замовчуванням вікно показується один раз на товар за візит: покупцеві, який уже відмовився, та сама пропозиція вдруге не приходить. Під час перевірки це виглядає як поломка — додали товар, вікно з’явилося, додали його ж іще раз, і нічого. Поставте «на кожну покупку», доки перевіряєте, і поверніть назад.

Якщо вікна не видно

Пройдіться списком згори вниз:

  1. Блок аксесуарів увімкнений у налаштуваннях розділу, а сама група — не вимкнена.
  2. У товару є відповідна група — дивіться вкладку «Аксесуари» в його картці.
  3. Умови зійшлися всі: кілька заданих видів прив’язки складаються за «І».
  4. Аксесуари опубліковані та є в наявності — інакше їх приховує налаштування.
  5. Для вікна в каталозі: воно ввімкнене окремим налаштуванням, покупка зроблена зі списку товарів, і товар не пропонувався в цей візит (див. «Як часто пропонувати»).

Для тих, хто робить свою тему

Поведінка — справа магазину: перерахунок комплекту, додавання в кошик, перевірка знижок і вікно в каталозі працюють самі. Тема відповідає за розмітку блоку на сторінці товару й розмічає її атрибутами data-accessories, data-acc-item, data-acc-total, data-acc-add.

Вікно після покупки з каталогу тема теж може намалювати по-своєму: покладіть у неї templates/partials/accessories-popup.html, і магазин намалює вікно за вашим шаблоном, залишивши собі поведінку. Файлу немає — вікно малює магазин, як і раніше, тому чужа тема нічого не втрачає. Написи вікна беруться зі словника теми, тож власник переписує їх там само, де решту текстів вітрини.

Подробиці, повний перелік опор розмітки та спосіб забрати вікно разом із поведінкою — у розділі «Тема оформлення».

Оновлено 28 серпня 2026