Работа с заказом через админку OpenCart, взгляд изнутри

Разрабатывая модуль для OpenCart, мне понадобилось добавить дополнительное поле к товарам заказа. Но прежде необходимо изучить как устроена работа с заказом через админку. Как оказалась схема не простая и немного запутанная, но это с первого взгляда.

Данные о товарах заказа хранятся в таблице order_product, где товары с заказами связаны по id (order_id, product_id). К слову информация о заказе хранится в нескольких таблицах order_.

Интерфейс

Перейдем в админке "Продажи-Заказы" и выберем любой заказ на редактирование.

Страница редактирования заказа состоит из 5 вкладок, в каждую из которых можно попасть только из предыдущей (нажимая кнопку "Продолжить"), при этом при переходе на некоторые вкладки происходят ajax запросы, на основании ответов которых происходит заполнение вкладки.

Если js в браузере отключен - редактирование заказа будет недоступно. Попасть на произвольную вкладку нельзя.

Перейдем в admin/view/teplate/sale/order_form.tpl (OpenCart 2.3). Здесь можно увидеть что изначально весь интерфейс статический, однако при переходе на вкладку "Товары" (клик по #button-customer внутри генерирует клик #button-refresh где и происходит изменение интерфейса) следует серия ajax запросов, в результате которых на вкладке меняется интерфейс.

Ajax запросы при переходе на вкладку "Товары"

Изменения заказа

Перейдем на вкладку "Товары".

Вкладка "Товары" на странице редактирования заказа в адинке

При попытке изменить количество позиции посылается ajax запрос с route=api/cart/add. В файле catalog/controller/api/cart.php в методе add используется объект $this->cart класса Cart (корзина), а именно его метод add. Если взглянуть на код метода, то не трудно понять что новые данные о товарах записываются в таблицу cart, но нигде нет записи в таблицы order_.

В таблице cart есть столбец session_id, значение которого привязывается к текущему юзеру, и является ключом данных в массиве $_SESSION. То есть данные в таблице cart временные и существуют только на период существования сессии юзера.

Подробнее о том что здесь вообще происходит, можно прочитав предыдущие статьи про ajax запросы в OpenCart и про один из способов решения проблемы с доступом к API OpenCart.

Сохранение изменений заказа

На странице редактирования заказа перейдем в последнюю вкладку "Итого", пролистаем вниз и нажмем кнопку "Сохранить".

Просматривая консоль браузера можно увидеть запрос route=api/order/edit. Переходим в catalog/controller/api/order.php и смотрим немаленький метод edit, где заполняется массив order_data данными заказа ($this->cart->getProducts()).

Небольшйо кусок кода, показывающий что данные о товарах заказа берутся из корзины:

•••
php

// Products
$order_data['products'] = array();

foreach ($this->cart->getProducts() as $product) {
	$option_data = array();

	//...

	$order_data['products'][] = array(
		'product_id' => $product['product_id'],
		'name'       => $product['name'],
		'model'      => $product['model'],
		'option'     => $option_data,
		'download'   => $product['download'],
		'quantity'   => $product['quantity'],
		'subtract'   => $product['subtract'],
		'price'      => $product['price'],
		'total'      => $product['total'],
		'tax'        => $this->tax->getTax($product['price'], $product['tax_class_id']),
		'reward'     => $product['reward']
	);
}

Почти в конце метода есть сохранение изменений через модель checkout/order в таблицу order_product:

•••
php

$this->model_checkout_order->editOrder($order_id, $order_data);

А еще ниже в этом методе есть добавление истории заказа:

•••
php

$this->model_checkout_order->addOrderHistory($order_id, $order_status_id);

На этом можно было бы остановится ... но дальше будет интереснее :)

Посмотрим таблицу товаров заказа order_product:

Таблица товаров заказа order_product

А теперь взглянем на таблицу корзины cart где хранятся данные редактируемого заказа:

Таблица корзины cart редактируемого заказа через админку

Становится безумно интересно, как данные из корзины (cart), сопоставляются с данными в заказе (order)? Ведь просматривая таблицу корзины и товаров заказа между ними не видно никакой связи. Более того нет никакой связи между товарами этих двух таблиц!

На самом деле все просто, запрос сохранения заказа api/order/edit передает:

• token по которому определяется корзина
• order_id по которому определяется заказ

•••
php

$this->db->query("DELETE FROM " . DB_PREFIX . "order_product WHERE order_id = '" . (int)$order_id . "'");
$this->db->query("DELETE FROM " . DB_PREFIX . "order_option WHERE order_id = '" . (int)$order_id . "'");

То есть:

Дерзко, резко, быстро понятно, но неудобно для добавления дополнительных полей в заказ.

Кстати, OpenCart занимает лидирующее место среди eCommerce на рынке России по мнению BuiltWith. Значит решение вполне годное и нам разработчикам остается лишь придумывать как с этим жить :)

Итог

Схема не совсем очевидная, с первого взгляда может показаться запутанной. Однако, при детальном изучении становится понятна концепция, суть которой простота управления данными. Не могу сказать что мне такое решение нравится, но ясно то, что оно вполне рабочее.