Order Archive для OpenCart — архів старих замовлень без втрати історії

Order Archive для OpenCart — модуль для магазинів, у яких за роки назбиралися десятки тисяч замовлень. Штатний OpenCart тримає всі замовлення в одних таблицях: кожен відкритий список, пошук, фільтр і лічильник у шапці адмінки щоразу проходить і по свіжих замовленнях, і по тих, що виконані три роки тому. Видаляти старі замовлення не можна: покупці відкривають їх у кабінеті, бухгалтерії потрібні звіти, а поверненням і CRM — історія.

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

Магазин на WooCommerce? Для нього є окремий плагін Order Archive для WooCommerce з тим самим підходом: старі замовлення в стиснений архів, звіти й підсумки покупців без змін, пошук і відновлення одним кліком.

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

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

Оформлення нових замовлень архів не зачіпає: штатний чекаут і One Page Checkout працюють як завжди, номери нових замовлень ідуть далі після архівних.

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

Пункт «Архів замовлень» у меню «Продажі» з трьома вкладками.

Огляд

Скільки замовлень у магазині й в архіві, розміри таблиць, найстаріше замовлення в магазині. Правила записані звичайною мовою («Замовлення, оформлені понад 24 міс. тому, у статусах Complete, Canceled, без змін 90 днів»). Кнопка «Скільки піде зараз?» рахує кандидатів, «Архівувати зараз» переносить їх кроками з прогресом — запуск можна зупинити будь-коли. Нижче — «Оптимізувати таблиці» (повертає звільнене місце на диск після першої великої архівації) і журнал: що, коли і хто архівував чи повертав.

Архів

Пошук за номером, покупцем, e-mail, телефоном, датою і статусом. Архівне замовлення можна переглянути й надрукувати, не повертаючи його. «Повернути» переносить одне замовлення в магазин, «Повернути вибрані» і «Повернути всі знайдені» — групу. У Pro тут же — експорт знайденого в CSV.

Штатний список замовлень

Список Продажі → Замовлення лишається таким, як був, і показує лише замовлення магазину — тому він і швидкий. Коли ви фільтруєте список (за покупцем, номером, e-mail, статусом), під ним з’являється рядок «В архіві ще N замовлень за цим фільтром.» з посиланням на них.

Налаштування

• Правила: вік замовлення в місяцях (за замовчуванням 24), статуси, які можна архівувати (за замовчуванням — «завершені» статуси магазину), скільки днів замовлення не змінювалося (90), розмір кроку.
• Захист: лишати в магазині замовлення із завантаженнями; не архівувати замовлення з поверненням, зміненим за останні N днів (180); скільки днів повернене замовлення лишається в магазині (90).
• Сумісність: кабінет покупця, сторінка замовлення в адмінці, звіти, рядок під списком замовлень, «повертати в магазин при відкритті», лічильники дашборду — кожен шар вмикається окремо.
• Pro: розклад, незавершені оформлення, остаточне видалення.

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

1. Встановлення. Модуль створює таблиці-архів з тією самою структурою, що й у таблиць замовлень вашого магазину (order, order_product, order_option, order_total, order_history, order_voucher; у 2.3 ще order_custom_field). Колонки, які додали інші модулі, архів підхоплює перед кожним запуском.
2. Вибір кандидатів. Замовлення, старші за N місяців, у вибраних статусах і без змін N днів. Не потрапляють в архів ніколи: найновіше замовлення, замовлення з підпискою чи регулярним платежем, з проданим подарунковим сертифікатом, із завантаженнями (налаштування), з недавнім поверненням, повернені з архіву нещодавно, а також ті, з якими ще працює модуль CatCode: ТТН Нової Пошти в черзі, ненадіслана синхронізація KeyCRM / SalesDrive / KeepinCRM, незавершений чек ПРРО, відкрита заявка Returns & Exchanges, неперевірена оплата в Payment Status Sync.
3. Перенесення. Кроками по 200 замовлень (налаштовується). Кожен крок — одна транзакція: рядки копіюються в архів, кількість звіряється по кожній таблиці, і лише тоді видаляються з магазину. Не зійшлося — крок відкочується повністю.
4. Читання. Коли OpenCart через свої моделі шукає одне замовлення (кабінет, сторінка замовлення, рахунок, модулі, що читають замовлення штатно) і не знаходить його в магазині, модуль повторює той самий запит в архіві. Список у кабінеті об’єднує обидва джерела з правильним посторінковим поділом, звіти читають магазин і архів разом.
5. Зміна. Будь-яка спроба змінити архівне замовлення через OpenCart (новий статус, редагування, номер рахунку, видалення), а також чек повернення Multi PRRO і дії із заявкою Returns & Exchanges спершу повертають його в магазин. Повернене замовлення лишається в магазині 90 днів.
6. Повернення вручну. З вкладки «Архів» — одне, вибрані або всі знайдені; рядки повертаються такими, якими були.

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

• Без правок ядра й OCMOD. Лише події OpenCart: моделі замовлень у кабінеті, чекауті й адмінці, звіти, список замовлень, сторінка замовлення.
• Архів — копія структури, не новий формат. Таблиці cc_oarch_* створюються як CREATE TABLE … LIKE, тож рядок в архіві — той самий рядок замовлення, а повернення — точна копія назад.
• Транзакції й блокування. Кожен крок архівації чи повернення — одна транзакція InnoDB і один іменований лок бази, тож архівація за розкладом і ручне повернення не перетинаються.
• Звіти. На час роботи моделі звіту таблиці замовлень підміняються на «магазин + архів»; на дашборді — лише за окремим перемикачем, щоб головна адмінки лишалася швидкою.
• Що лишається на місці: транзакції й бонуси покупців, історія купонів (ліміти купонів рахують і старі замовлення), повернення, подарункові сертифікати, підписки, таблиці інших модулів.
• Чесно про обмеження. Модулі інших розробників, які читають таблицю замовлень власним SQL, архівних замовлень не бачать — тому в архів ідуть лише давно завершені замовлення, а сторінка замовлення в адмінці за замовчуванням повертає архівне замовлення в магазин. Статус, змінений у KeyCRM для замовлення, яке вже в архіві, не застосовується, доки замовлення не повернуте. Блок «Бестселери» вітрини рахує лише замовлення магазину. Звіти, що читають і архів, працюють повільніше, ніж до архівації (вимірювання — у FAQ).

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

1. Завантажте архів для своєї версії: cc_orderarchive.ocmod.zip (OpenCart 4.x), cc_orderarchive-oc3.ocmod.zip (3.x) або cc_orderarchive-oc2.ocmod.zip (2.3).
2. OpenCart 4 і 3: Розширення → Встановлення розширень → «Завантажити». OpenCart 2.3: скопіюйте вміст папки upload/ з архіву в корінь магазину.
3. Розширення → Розширення → Модулі → CatCode Order Archive → «Встановити».
4. Відкрийте Продажі → «Архів замовлень» → «Налаштування», перевірте правила й статуси, збережіть.
5. На вкладці «Огляд» натисніть «Скільки піде зараз?», потім «Архівувати зараз». Першу велику архівацію краще запускати в тиху годину, а після неї — «Оптимізувати таблиці».