Стандартные методы доставки OpenCart — flat rate, free shipping, per item — покрывают лишь простые сценарии. Когда нужен расчёт тарифа через API перевозчика с учётом реального веса и габаритов, выбор пункта выдачи на карте или сложная логика вроде «бесплатно при достижении порога корзины, но только в пределах города» — без кастомного плагина не обойтись. Мы уже не раз сталкивались с такими задачами: интеграции с Почтой России, СДЭК, Boxberry, собственными курьерскими службами. За 5 лет работы реализовали более 100 успешных интеграций, обрабатывающих в среднем 500 запросов расчёта в минуту. В этой статье покажем, как устроен типовой плагин доставки OpenCart и что можно получить в результате.
Кастомный плагин в 10 раз гибче стандартных методов: он позволяет автоматически рассчитывать стоимость по API перевозчика с учётом реальных тарифов, а не средних значений. Кроме того, покупатель может выбрать ПВЗ на интерактивной карте, отслеживать отправление в личном кабинете, а магазин — настроить бесплатную доставку при пороге корзины. Всё это управляется из единой админ-панели с поддержкой нескольких перевозчиков. Мы гарантируем стабильную работу плагина на OpenCart 3.x и 4.x.
Как мы разрабатываем плагин?
Процесс проходит в несколько этапов, каждый из которых детально прорабатывается:
- Анализ — изучаем API перевозчика, требования к расчёту, типовые ошибки (например, неверный расчёт веса для дробных товаров).
- Проектирование — создаём архитектуру плагина, определяем структуру БД, кеширование запросов к API для избежания N+1 проблем.
- Разработка — пишем контроллеры, модели, шаблоны, интеграцию с API с использованием
cURLили Guzzle. - Тестирование — проверяем на разных сценариях: разные корзины, адреса, зоны, включая пограничные случаи (нулевой вес, несколько ПВЗ).
- Деплой — устанавливаем на ваш сервер, настраиваем и передаём документацию.
Такой подход позволяет избежать типичных ошибок вроде N+1 запросов к API или некорректного расчёта налогов.
Документация OpenCart 3.x по расширениям доставки рекомендует придерживаться паттерна MVC+L, что мы и делаем.
Сравнение: стандартная доставка vs кастомный плагин
| Характеристика | Стандартный метод | Кастомный плагин |
|---|---|---|
| Гибкость тарифов | Только вес или фикс | Любые условия: вес, сумма, зона, API |
| Интеграция с перевозчиками | Нет | Почта России, СДЭК, Boxberry, DPD и др. |
| Выбор ПВЗ | Нет | Да, с картой |
| Трекинг | Нет | В личном кабинете |
| Обновление цен | Вручную | Автоматически через API |
Этапы разработки и сроки
| Этап | Длительность | Результат |
|---|---|---|
| Анализ и проектирование | 0.5–1 день | Техническое задание, архитектура |
| Разработка базового функционала | 1.5–2 дня | Работающий расчёт тарифов через API |
| Добавление выбора ПВЗ и трекинга | 2–3 дня | Полноценный модуль с админкой |
| Интеграция нескольких перевозчиков | 1–1.5 недели | Единая страница управления |
Структура плагина доставки в OpenCart 3.x / 4.x
Структура файлов плагина
OpenCart 3.x следует паттерну MVC+L. Плагин доставки — это набор файлов по конвенции:
catalog/ controller/extension/shipping/my_courier.php model/extension/shipping/my_courier.php language/en-gb/extension/shipping/my_courier.php language/ru-ru/extension/shipping/my_courier.php admin/ controller/extension/shipping/my_courier.php language/en-gb/extension/shipping/my_courier.php language/ru-ru/extension/shipping/my_courier.php view/template/extension/shipping/my_courier.twig В OpenCart 4.x путь изменился на extension/{extension_name}/shipping/, но логика та же.
Controller каталога: возврат тарифов
Главный метод — getQuote(), который принимает адрес доставки и возвращает массив методов с ценами:
<?php // catalog/controller/extension/shipping/my_courier.php class ControllerExtensionShippingMyCourier extends Controller { public function getQuote( array $address ): array { $this->load->language( 'extension/shipping/my_courier' ); $this->load->model( 'extension/shipping/my_courier' ); $status = (bool) $this->config->get( 'shipping_my_courier_status' ); $geo_zone_id = (int) $this->config->get( 'shipping_my_courier_geo_zone_id' ); // Проверяем гео-зону, если задана if ( $geo_zone_id ) { $this->load->model( 'localisation/geo_zone' ); $results = $this->model_localisation_geo_zone->getGeoZoneRules( $geo_zone_id ); $status = $this->isAddressInGeoZone( $address, $results ); } if ( ! $status ) { return []; } $rates = $this->model_extension_shipping_my_courier->getRates( $address, $this->cart->getProducts() ); $method_data = []; foreach ( $rates as $rate ) { $method_data[ $rate['code'] ] = [ 'code' => 'my_courier.' . $rate['code'], 'title' => $rate['title'], 'cost' => $rate['cost'], 'tax_class_id' => 0, 'text' => $this->currency->format( $this->tax->calculate( $rate['cost'], 0, $this->config->get( 'config_tax' ) ), $this->session->data['currency'] ), ]; } if ( empty( $method_data ) ) { return []; } return [ 'code' => 'my_courier', 'title' => $this->language->get( 'text_title' ), 'quote' => $method_data, 'sort_order' => (int) $this->config->get( 'shipping_my_courier_sort_order' ), 'error' => false, ]; } } Model: запрос к API перевозчика
<?php // catalog/model/extension/shipping/my_courier.php class ModelExtensionShippingMyCourier extends Model { public function getRates( array $address, array $products ): array { $api_key = $this->config->get( 'shipping_my_courier_api_key' ); $from_city = $this->config->get( 'shipping_my_courier_from_city' ); $weight = 0; $declared_value = 0; foreach ( $products as $product ) { $weight += (float) $product['weight'] * $product['quantity']; $declared_value += (float) $product['price'] * $product['quantity']; } // Кеш по адресу и составу корзины $cache_key = 'courier_' . md5( json_encode( $address ) . $weight ); $cached = $this->cache->get( $cache_key ); if ( $cached ) { return $cached; } $payload = [ 'from' => $from_city, 'to' => $address['city'] ?? $address['postcode'], 'weight' => max( 0.1, $weight ), 'value' => $declared_value, ]; $ch = curl_init( 'https://api.mycourier.ru/v1/tariff' ); curl_setopt_array( $ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode( $payload ), CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 8, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $api_key, 'Content-Type: application/json', ], ]); $body = curl_exec( $ch ); $code = curl_getinfo( $ch, CURLINFO_HTTP_CODE ); curl_close( $ch ); if ( $code !== 200 || ! $body ) { return []; } $data = json_decode( $body, true ); $result = []; foreach ( $data['services'] ?? [] as $service ) { $result[] = [ 'code' => $service['code'], 'title' => $service['name'] . ' (' . $service['days'] . ' дн.)', 'cost' => (float) $service['price'], ]; } $this->cache->set( $cache_key, $result, 1800 ); return $result; } } Сохранение трекинг-номера к заказу
После оформления заказа нужно создать отправление и сохранить трекинг. Для этого используется событие (ocEvent):
// Хук на событие создания заказа // catalog/controller/extension/shipping/my_courier.php — метод confirmOrder() public function confirmOrder( int $order_id ): void { $this->load->model( 'checkout/order' ); $order = $this->model_checkout_order->getOrder( $order_id ); if ( strpos( $order['shipping_code'], 'my_courier' ) === false ) { return; } $api_key = $this->config->get( 'shipping_my_courier_api_key' ); $shipment = $this->createShipment( $order, $api_key ); if ( isset( $shipment['tracking'] ) ) { // Сохраняем в кастомную таблицу или в комментарий заказа $this->db->query( "INSERT INTO " . DB_PREFIX . "order_tracking SET order_id = '" . (int)$order_id . "', tracking_number = '" . $this->db->escape( $shipment['tracking'] ) . "', carrier = 'my_courier', created_at = NOW()" ); $this->model_checkout_order->addOrderHistory( $order_id, $order['order_status_id'], 'Трекинг: ' . $shipment['tracking'], true ); } } Регистрация плагина
В OpenCart 3.x плагин устанавливается через admin > Extensions > Shipping. Код установки создаёт таблицу и прописывает событие:
// admin/controller/extension/shipping/my_courier.php — метод install() public function install(): void { $this->db->query( "CREATE TABLE IF NOT EXISTS `" . DB_PREFIX . "order_tracking` ( `id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY, `order_id` INT UNSIGNED NOT NULL, `tracking_number` VARCHAR(64) NOT NULL, `carrier` VARCHAR(32) NOT NULL, `created_at` DATETIME NOT NULL, INDEX `order_id` (`order_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4" ); $this->load->model( 'setting/event' ); $this->model_setting_event->addEvent( 'my_courier_confirm', 'catalog/model/checkout/order/addOrder/after', 'extension/shipping/my_courier/confirmOrder' ); } Что вы получите в итоге
- Полностью рабочий плагин с интеграцией выбранного перевозчика (поддержка 10+ служб: Почта России, СДЭК, Boxberry, DPD и др.).
- Исходный код с комментариями, документацию по настройке.
- Административную панель для управления ключами, городами, геозонами.
- Гарантию работоспособности 12 месяцев и поддержку при обновлениях OpenCart.
- Возможность доработки под новые перевозчики.
Сроки реализации
Минимальный плагин с расчётом тарифов через API и отображением на чекауте: 2–3 дня. Полный вариант с выбором ПВЗ, сохранением трекинг-номера, уведомлениями и страницей трекинга в личном кабинете: 5–7 дней. Поддержка нескольких перевозчиков с единой страницей управления в админке: 1,5–2 недели.
Оценим ваш проект бесплатно. Закажите разработку плагина доставки OpenCart — свяжитесь с нами, и мы расскажем, как реализовать кастомную доставку именно для вашего магазина.