פיתוח תוסף משלוחים מותאם אישית ל-OpenCart

OpenCart 3.x עוקב אחר תבנית MVC+L. תוסף משלוח מותאם אישית ל-OpenCart מורכב מקבצים לפי מוסכמה:

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, הנתיב השתנה ל-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 , אך הלוגיקה נשארת זהה.

בקר קטלוג: החזרת תעריפים

המתודה הראשית היא extension/{extension_name}/shipping/, שמקבלת את כתובת המשלוח ומחזירה מערך של שיטות עם מחירים:

<?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,
        ];
    }
}

מודל: בקשת 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, תוסף המשלוח המותאם אישית ל-OpenCart מותקן דרך getQuote(). קוד ההתקנה יוצר טבלה ורושם את האירוע:

// 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 שירותים: דואר רוסי, CDEK, Boxberry, DPD וכו').
• קוד מקור עם הערות, תיעוד התקנה.
• פאנל ניהול לניהול מפתחות, ערים, אזורים גיאוגרפיים.
• אחריות פונקציונליות ל-12 חודשים ותמיכה במהלך עדכוני OpenCart.
• אפשרות להרחבה לחברות שילוח חדשות.

לוחות זמנים ליישום

תוסף מינימלי עם חישוב תעריף API והצגה בקופה: 2–3 ימים (החל מ-$199). גרסה מלאה עם בחירת נקודת איסוף, שמירת מספר מעקב, התראות ודף מעקב בחשבון הלקוח: 5–7 ימים (חוסך עד 40% במשלוח). תמיכה במספר חברות שילוח עם דף ניהול מאוחד: 1.5–2 שבועות.

אנו נעריך את הפרויקט שלך ללא עלות. הזמן פיתוח תוסף משלוח מותאם אישית ל-OpenCart — צור קשר, ונסביר כיצד ליישם משלוח מותאם אישית לחנות שלך.