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->getZoneToGeoZones( $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.novaposhta.ua/v2.0/json/' ); 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' ); } 

Що входить у роботу

• Повноцінний аналіз вимог та прототип плагіна.
• Розробка коду з використанням стандартів OpenCart.
• Інтеграція з API обраного перевізника (до 3 перевізників в одному плагіні).
• Адміністративна панель для налаштування ключів, міст, зон доставки.
• Вибір відділення на карті та збереження трекінг-номера.
• Документація з встановлення та налаштування.
• Тестування на різних сценаріях.
• Передача вихідного коду та доступів.
• Гарантія 12 місяців з підтримкою оновлень OpenCart.
• Післягарантійна підтримка за договором.

Строки реалізації

Мінімальний плагін з розрахунком тарифів через API та відображенням на чекауті: 2–3 дні. Повний варіант з вибором відділення, збереженням трекінг-номера, сповіщеннями та сторінкою трекінгу в особистому кабінеті: 5–7 днів. Підтримка кількох перевізників з єдиною сторінкою керування в адмінці: 1,5–2 тижні.

Оцінимо ваш проект безкоштовно. Замовте розробку плагіна доставки OpenCart — зв'яжіться з нами, і ми розповімо, як реалізувати кастомну доставку саме для вашого магазину.