Shared Stock для OpenCart — один залишок для кількох товарів і значень опцій без перепродажу

Shared Stock для OpenCart — модуль від студії CatCode для магазину, який продає одну фізичну річ у кількох місцях каталогу. Батончик «Ваніль» окремо — і той самий смак у подарунковому наборі, де покупець обирає смак у п’яти списках «Смак 1…5». Той самий товар в іншому наборі. OpenCart рахує залишок кожного товару і кожного значення опції окремо, тож власник магазину переписує цифри вручну — і все одно продає останню одиницю двічі.

Shared Stock об’єднує такі місця в пул — одну цифру залишку, з якої продають усі вони. Учасником пулу може бути товар цілком або окреме значення опції. Кошик перевіряється по пулу загалом: набір із п’ятьма «Ваніль» у кількості 2 бере з пулу 10. Продаж будь-якого учасника знімає з пулу, а кожен учасник показує, скільки пул ще може покрити. Два покупці, які в ту саму секунду підтверджують останні одиниці, не отримають їх обидва.

Це не дубль Option Combinations. Option Combinations веде залишок комбінацій опцій усередині одного товару (розмір × колір). Shared Stock розв’язує інший сценарій: один залишок для різних товарів і значень опцій — той самий смак окремим товаром, у п’яти списках набору й в іншому наборі. Перший модуль не ділить залишок між товарами, другий не веде комбінацій усередині товару.

Як це виглядає для покупця

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

Якщо пул зменшився, поки товар лежав у кошику (інший покупець встиг купити), кошик позначає рядок *** і не пускає до оформлення — це штатна поведінка OpenCart для залишку, тільки рахується вона по пулу.

Що отримує адмін

• Каталог → Спільний залишок: пули із залишком, утриманим непідтвердженими замовленнями, і доступним; створення пулу. Порожній новий пул бере залишок першого доданого учасника.
• Сторінка пулу: «Додати / списати (±N)» відносно поточного — поставка, оформлена під час замовлень, не загубиться; «Встановити» для інвентаризації; поріг листа (Pro); учасники з їхньою кількістю в OpenCart; пошук товару й додавання цілого товару або одного значення опції; список утримань непідтверджених замовлень.
• Форма товару: рядок під полем «Кількість» з назвою пулу. Нова цифра в цьому полі чи в кількості значення опції встановлює пул, а стара цифра з давно відкритої форми — ні.
• «Синхронізувати кількості» — після CSV-імпорту чи іншого модуля, що пише кількості напряму: дзеркала знову показують пул, учасники видалених товарів прибираються.

Як це працює — крок за кроком

1. Ви створюєте пул (наприклад, «Ваніль»), задаєте залишок і додаєте учасників: батончик цілком і значення «Ваніль» з кожного списку набору. Кількість кожного учасника в OpenCart стає дзеркалом пулу.
2. Покупець додає товар у кошик. Модуль рахує, скільки одиниць кожного пулу просить весь кошик, з урахуванням того, що утримують непідтверджені замовлення інших покупців, і відмовляє з поясненням, якщо не вистачає.
3. На кроці підтвердження — окремим запитом чи всередині сторінки оформлення OpenCart 4 і One Page — модуль бере замок бази, ще раз перевіряє кошик по пулу і утримує одиниці замовлення. Інший покупець, який підтверджує в ту саму секунду, чекає своєї черги й бачить уже меншу цифру. Черга довша за 10 секунд (налаштовується) — покупець отримує відмову, а не ризик продати двічі.
4. Коли замовлення переходить у статус обробки чи виконання, модуль знімає одиниці з пулу — рівно один раз на рядок замовлення — і оновлює кількість усіх учасників. Скасування повертає одиниці.
5. Утримання непідтвердженого замовлення живе 60 хвилин (налаштовується), потім одиниці знову доступні іншим покупцям.

Що перевірено, а що ні

Перевірено локально на чотирьох версіях OpenCart: 79 перевірок на OpenCart 4.1.0.3 і 4.0.2.3 і по 77 на 3.0.5.0 і 2.3.0.2 за основним сценарієм, плюс окремі прогони в браузері, з One Page Checkout, правки замовлень, імпорту й листів Pro. Версію 1.0.1 — тим самим набором, плюс п’ять прогонів поспіль одночасних завантажень сторінки оформлення (штатної й One Page) на OpenCart 4.1 і 4.0.2.3 — щоразу рівно 2 замовлення з 8, пул не нижче нуля — і 24 комбінації мови магазину й мови покупця для повідомлення «в кошик». Ліцензійний сервер і пошту підміняли тестові сервери.

Межі, про які варто знати. Захист від одночасних покупців стоїть на кроці підтвердження замовлення — і тоді, коли він іде окремим запитом, і коли OpenCart 4 чи наш One Page відкриває його всередині сторінки оформлення. Сторонній one-page чекаут, що записує замовлення в обхід цього кроку, перевіряє кошик без замка; утримання модуль і тоді пише лише тоді, коли пул його покриває. Замовлення, оплачене вже після того, як його утримання минуло (60 хвилин за замовчуванням), списує пул навіть у мінус — так само, як OpenCart без модуля; це видно в історії пулу. Не перевіряли: платіжні шлюзи зі зворотним викликом банку, сторонні one-page чекаути (крім нашого), спільну роботу з Option Combinations, варіанти товарів OpenCart 4 (master / variant), MySQL 8 і кластери Galera.

Що під капотом

• Пул — у власній таблиці. Кількості учасників в OpenCart лише показують, скільки пул ще може покрити; чекаут рахує по пулу.
• Одне списання на рядок. Рядок замовлення знімає з пулу один раз (умовне оновлення в базі), тож повторна зміна статусу чи повторне скасування нічого не подвоює.
• Утримання на підтвердженні. Замовлення, що дійшло до кроку підтвердження, утримує свої одиниці; повторне відкриття кроку того самого покупця замінює утримання, а не додає друге.
• Без правок ядра і без OCMOD-патчів — лише події OpenCart; одна бібліотека на три збірки, код сумісний з PHP 7.0, працює і з драйвером бази pdo в OpenCart 4.1.
• Ліцензія — окремою групою налаштувань, тож збереження налаштувань її не зачіпає.
• Видалення знімає події й таблиці модуля (можна залишити дані для повторного встановлення).

Як встановити

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_sharedstock.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_sharedstock-oc3.ocmod.zip → «Встановити». OpenCart 2.3: Розширення → Інсталятор → cc_sharedstock-oc2.ocmod.zip, якщо в налаштуваннях магазину увімкнено FTP; інакше залийте вміст папки upload/ з архіву в корінь магазину.
2. Розширення → Розширення → Модулі → Shared Stock → «Встановити».
3. Каталог → Спільний залишок: створіть пул і додайте учасників — товар цілком або значення опції.
4. Задайте залишок пулу або залиште поле порожнім — тоді пул візьме залишок першого доданого учасника.
5. Для Pro: вставте ліцензійний ключ з листа після оплати або увімкніть тріал на вкладці «Ліцензія» налаштувань модуля.