Кнопка підписки
Кнопка підписки показує ціну зі знижкою за підпискою і дає покупцю обрати, як часто доставляти товар. Ставиться під кнопкою «Купити» на сторінці товару, у картці каталогу або в рядку кошика.

Можливості
Section titled “Можливості”- Ціна за підпискою та розмір знижки прямо на кнопці.
- Вибір частоти доставки з пресетів магазину або власний інтервал.
- Зміна та видалення підписки на товар.
- Однаковий стан на всіх сторінках і вкладках: сторінка товару, каталог, кошик.
Як працює
Section titled “Як працює”- Покупець натискає «Оформити підписку» — відкривається вікно вибору частоти.
- Обирає частоту й натискає «Додати підписку». Кнопка переходить у стан «Підписку додано».
- Вибір зберігається в браузері покупця. Ваш кошик бере його через
getOrderItems(), коли створює замовлення.
Кнопка не додає товар у кошик і не створює замовлення — це робить ваша сторінка.
Розмітка
Section titled “Розмітка”<neocarts-button product-id="food" amount="249000" title="Brit Care Adult Large Breed Lamb & Rice" image="https://shop.example.com/img/brit-care-12kg.png" variant="12 кг" checkout-url="/cart"></neocarts-button>Скрипт має бути підключений на сторінці.
Атрибути
Section titled “Атрибути”| Атрибут | Тип | Обовʼязковий | Опис |
|---|---|---|---|
product-id |
рядок | так | Ваш ID товару — той самий external_id, що в рядку замовлення. Приклад: food |
amount |
ціле | так | Ціна однієї одиниці в копійках, до знижки, більше 0. Приклад: 249000 = 2 490,00 ₴ |
title |
рядок | так | Назва товару у вікні підписки |
image |
URL | так | Зображення товару у вікні підписки |
variant |
рядок | ні | Варіант під назвою. Приклад: 12 кг |
checkout-url |
URL | ні | Додає кнопку «Перейти до оформлення» після збереження підписки. Лише http(s) або відносний шлях |
Якщо обовʼязкового атрибута бракує або amount не є цілим додатним числом, кнопка не показується, а в консолі зʼявляється попередження з переліком проблем:
[Neocarts] <neocarts-button product-id="food"> hidden: missing or invalid amount, imageАтрибути можна змінювати скриптом — кнопка оновиться сама. Додавати кнопки можна будь-коли (SPA, нескінченна прокрутка).
| Стан | Коли | Що бачить покупець |
|---|---|---|
| Доступна | підписки на товар немає | «Оформити підписку», «−7% на кожну доставку», стара й нова ціна |
| Оформлена | покупець додав підписку | «Підписку додано», ціна з підпискою та знижка, частота доставки, «Змінити» |
| Прихована | магазин не завершив налаштування оплати чи доставки, або на сторінці немає shop id | нічого |
| Доступна | Оформлена |
|---|---|
![]() |
![]() |
Знижку задає магазин у Налаштуваннях → Підписки. Без знижки кнопка показує «Регулярна доставка з Neocarts» і ціну без закреслення.
Ціна зі знижкою на кнопці — попередній перегляд. Остаточні суми рахує сервер під час створення замовлення (Гроші та округлення).
Вікно підписки
Section titled “Вікно підписки”
- Товар — зображення, назва, варіант, ціна зі знижкою.
- Як часто доставляти — пресети магазину й «Інша частота…» (кожні N днів чи тижнів, у межах, дозволених магазином).
- Ціна з підпискою — економія з кожного списання та дата наступного списання.
- «Додати підписку» — зберігає вибір. У режимі редагування: «Зберегти зміни» і «Прибрати підписку».
Кількості у вікні немає: вона лишається у вашому кошику. Вартість доставки оплачується перевізнику окремо.
Після збереження покупець бачить підтвердження з кнопками «Продовжити покупки» і, якщо задано checkout-url, «Перейти до оформлення».

Кнопка і кошик
Section titled “Кнопка і кошик”Кнопка лише запамʼятовує частоту для product-id. Кошик лишається вашим, тому звʼяжіть їх у двох місцях.
Підписка на товар, якого немає в кошику. Покупець може оформити підписку з картки каталогу, не додаючи товар у кошик, і натиснути «Перейти до оформлення». Щоб кошик не був порожнім, додавайте товар, коли зʼявляється підписка:
NeocartsSubscription.subscribe((all) => { for (const [id, s] of Object.entries(all)) { if (s.mode === 'subscription' && !cart.has(id)) { cart.add(id, 1); // ваш кошик } } renderCart();});subscribe() викликає функцію з усіма виборами покупця при кожній зміні. Товар, який уже є в кошику, не чіпайте: його кількість лишається, а підпискою він стане в getOrderItems().
Видалення з кошика. Коли покупець прибирає товар із кошика, забудьте і його вибір, інакше товар повернеться як підписка, щойно його додадуть знову:
NeocartsSubscription.remove(id);«Прибрати підписку» у вікні підписки забуває лише вибір: товар лишається у кошику і йде в замовлення як one_time. Якщо він має зникати разом із підпискою, прибирайте його з кошика у тому ж subscribe().
Вікно «Як працює підписка»
Section titled “Вікно «Як працює підписка»”Пояснює покупцю, як працює підписка: частота, нагадування за 3 дні до списання, оплата карткою через платіжний сервіс магазину, керування підпискою. Відкривається посиланням «Як це працює» у вікні підписки або з вашої кнопки:
<button type="button" onclick="NeocartsSubscription.openHowItWorks()">Як працює підписка?</button>
Розміщення
Section titled “Розміщення”- Кнопка займає всю ширину батьківського блоку. Поставте її в ту саму колонку, що й кнопку «Купити».
- У вузькому контейнері (до 256 px) кнопка складається у два рядки — для карток каталогу на телефоні.
- Не задавайте контейнеру
display: contents— кнопка завжди буде вузькою. - Кнопку можна вкладати в картку-посилання
<a>: клік по кнопці не переходить за посиланням.
Кольори задає палітра магазину (Палітри та мови); стилі сторінки на кнопку не впливають.

