gplcart\modules\shippo\models\Shippo

Complexity

Total Complexity

57

Size/Duplication

Total Lines	478
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Importance

Changes

0

15 Methods

Rating	Name	Duplication	Size	Complexity
A	getCarrierNames()	0	4	1
A	getServiceNames()	0	4	1
A	__construct()	0	19	1
A	calculate()	0	6	1
C	validate()	0	38	8
C	getRates()	0	48	8
A	getCacheKey()	0	7	1
B	setShippingMethodsCheckout()	0	16	5
A	setShippingMethod()	0	23	3
A	getDefaultRates()	0	15	2
A	getShippoServiceId()	0	4	1
F	getShippoAddress()	0	55	17
A	getParcel()	0	14	1
B	getDimensions()	0	25	3
A	getSourceAddress()	0	13	4

<?php

/**
 * @package Shippo
 * @author Iurii Makukh <gplcart.software@gmail.com>
 * @copyright Copyright (c) 2015, Iurii Makukh
 * @license https://www.gnu.org/licenses/gpl.html GNU/GPLv3
 */

namespace gplcart\modules\shippo\models;

use Exception;
use gplcart\core\helpers\Session;
use gplcart\core\models\Address;
use gplcart\core\models\Convertor;
use gplcart\core\models\Currency;
use gplcart\core\models\Price;
use gplcart\core\models\Shipping;
use gplcart\core\models\CountryState;
use gplcart\core\models\Store;
use gplcart\core\models\Translation;
use gplcart\core\models\User;
use gplcart\core\Module;

/**
 * Manages basic behaviors and data related to Shippo module
 */
class Shippo
{

    /**
     * Module class instance
     * @var \gplcart\core\Module $module
     */
    protected $module;

    /**
     * Api model instance
     * @var \gplcart\modules\shippo\models\Api $api
     */
    protected $api;

    /**
     * Translation UI model instance
     * @var \gplcart\core\models\Translation $translation
     */
    protected $translation;

    /**
     * User model class instance
     * @var \gplcart\core\models\User $user
     */
    protected $user;

    /**
     * Price model class instance
     * @var \gplcart\core\models\Price $price
     */
    protected $price;

    /**
     * Shipping model class instance
     * @var \gplcart\core\models\Shipping $shipping
     */
    protected $shipping;

    /**
     * State model class instance
     * @var \gplcart\core\models\CountryState $state
     */
    protected $state;

    /**
     * Currency model class instance
     * @var \gplcart\core\models\Currency $currency
     */
    protected $currency;

    /**
     * Address model class instance
     * @var \gplcart\core\models\Address $address
     */
    protected $address;

    /**
     * Store model instance
     * @var \gplcart\core\models\Store $store
     */
    protected $store;

    /**
     * Convertor model class instance
     * @var \gplcart\core\models\Convertor $convertor
     */
    protected $convertor;

    /**
     * Session class instance
     * @var \gplcart\core\helpers\Session $session
     */
    protected $session;

    /**
     * An array of Shippo module settings
     * @var array
     */
    protected $settings = array();

    /**
     * Shippo constructor.
     * @param Module $module
     * @param Api $api
     * @param Translation $translation
     * @param User $user
     * @param Price $price
     * @param Currency $currency
     * @param Address $address
     * @param Store $store
     * @param CountryState $state
     * @param Shipping $shipping
     * @param Session $session
     * @param Convertor $convertor
     */
    public function __construct(Module $module, Api $api, Translation $translation, User $user, Price $price,
                                Currency $currency, Address $address, Store $store, CountryState $state, Shipping $shipping,
                                Session $session, Convertor $convertor)
    {
        $this->api = $api;
        $this->user = $user;
        $this->price = $price;
        $this->state = $state;
        $this->store = $store;
        $this->session = $session;
        $this->address = $address;
        $this->currency = $currency;
        $this->shipping = $shipping;
        $this->convertor = $convertor;
        $this->translation = $translation;

        $this->module = $module;
        $this->settings = $this->module->getSettings('shippo');
    }

    /**
     * Returns an array of carrier names keyed by id
     * @return array
     */
    public function getCarrierNames()
    {
        return gplcart_config_get(__DIR__ . '/../config/carriers.php');
    }

    /**
     * Returns an array of service names keyed by id
     * @return array
     */
    public function getServiceNames()
    {
        return gplcart_config_get(__DIR__ . '/../config/services.php');
    }

    /**
     * Calculates shipping rates and sets available shipping methods on checkout page
     * @param array $data
     */
    public function calculate(array &$data)
    {
        $address = $this->getSourceAddress($data);
        $rates = $this->getRates($address, $data['cart'], $data['order']);
        $this->setShippingMethodsCheckout($data, $rates);
    }

    /**
     * Validates order shipping rates before an order is created
     * @param array $order
     * @param array $options
     * @param array $result
     * @return null|bool
     */
    public function validate(array &$order, $options, array &$result)
    {
        $method = $this->shipping->get($order['shipping']);

        if (empty($method['module']) || $method['module'] !== 'shippo') {
            return null;
        }

        $error_result = array(
            'severity' => 'danger',
            'redirect' => '', // Stay on the same page
            'message' => $this->translation->text('Please recalculate shipping rates')
        );

        // Forbid further processing if shipping component has not been set
        if (!isset($order['data']['components']['shipping']['price']) && empty($options['admin'])) {
            $result = $error_result;
            return false;
        }

        $rates = $this->getRates($order['shipping_address'], $order['cart'], $order);

        $this->setShippingMethod($method, $rates, $order['currency']);

        // Forbid further processing and redirect back if shipping rates don't match
        // Validate only "normal" submits.
        // In admin mode shipping prices can be adjusted by administrator
        if (empty($options['admin'])
            && isset($method['price'])
            && $method['price'] != $order['data']['components']['shipping']['price']) {
            $result = $error_result;
            return false;
        }

        // Save Shippo request in the order data to get later labels etc.
        $order['data']['shippo'] = $method['data'];
        return true;
    }

    /**
     * Returns an array of cached rates
     * @param array|integer $address
     * @param array $cart
     * @param array $order
     * @return array
     */
    public function getRates($address, array $cart, array $order)
    {
        if (!is_array($address)) {
            $address = $this->address->get($address);
        }

        $to_address = $this->getShippoAddress($address);

        if (empty($to_address)) {
            return array();
        }

        $session_limit = 10;
        $session_rates = $this->session->get('shippo', array());

        if (count($session_rates) > $session_limit) {
            $this->session->delete('shippo');
        }

        $cache_id = $this->getCacheKey($this->settings['sender'], $to_address);

        if (!empty($session_rates[$cache_id])) {
            return $session_rates[$cache_id];
        }

        try {

            if ($this->api->isValidAddress($to_address) !== true) {
                return $this->getDefaultRates();
            }

            $parcel = $this->getParcel($cart, $order);
            $response = $this->api->getRates($this->settings['sender'], $to_address, $parcel);

        } catch (Exception $ex) {
            trigger_error($ex->getMessage());
            return array();
        }

        if (empty($response)) {
            return $this->getDefaultRates();
        }

        $session_rates[$cache_id] = $response;
        $this->session->set('shippo', $session_rates);

        return $response;
    }

    /**
     * Returns a unique cache key for a combination of recipient and sender addresses
     * @param array $from
     * @param array $to
     * @return string
     */
    protected function getCacheKey(array $from, $to)
    {
        ksort($to);
        ksort($from);

        return md5(json_encode(array($from, $to)));
    }

    /**
     * Sets shipping methods available for the order shipping address
     * @param array $data
     * @param array $rates
     */
    protected function setShippingMethodsCheckout(array &$data, array $rates)
    {
        foreach ($data['shipping_methods'] as &$method) {

            if (empty($method['module']) || $method['module'] !== 'shippo') {
                continue;
            }

            if (!$this->setShippingMethod($method, $rates, $data['order']['currency'])) {
                unset($data['shipping_methods'][$method['id']]);
            }
        }

        // Show cheapest items first
        gplcart_array_sort($data['shipping_methods'], 'price');
    }

    /**
     * Adjust price and label for the given shipping method
     * @param array $method
     * @param array $rates
     * @param string $currency
     * @return boolean
     */
    protected function setShippingMethod(array &$method, array $rates, $currency)
    {
        $service_id = $this->getShippoServiceId($method['id']);

        if (empty($rates[$service_id])) {
            return false;
        }

        $converted = $this->currency->convert($rates[$service_id]['amount_local'], $rates[$service_id]['currency_local'], $currency);
        $price = $this->price->format($converted, $currency, false, true);

        $method['title'] .= " - $price";

        if (isset($rates[$service_id]['days'])) {
            $method['description'] = $this->translation->text('Estimated delivery time: @num day(s)', array(
                '@num' => $rates[$service_id]['days']));
        }

        $method['data'] = $rates[$service_id];
        $method['price'] = $this->price->amount($converted, $currency);

        return true;
    }

    /**
     * Returns the default rates if unabled to calculate via Shippo API
     * @return array
     */
    protected function getDefaultRates()
    {
        if (empty($this->settings['default']['method'])) {
            return array();
        }

        $service_id = $this->getShippoServiceId($this->settings['default']['method']);

        return array(
            $service_id => array(
                'currency' => 'USD',
                'amount' => $this->settings['default']['price']
            )
        );
    }

    /**
     * Converts the system method ID into Shippo's service ID
     * @param string $system_method_id
     * @return string
     */
    protected function getShippoServiceId($system_method_id)
    {
        return str_replace('shippo_', '', $system_method_id);
    }

    /**
     * Converts an address into Shippo's format
     * @param array $data
     * @return array
     */
    protected function getShippoAddress(array $data)
    {
        if (empty($data)) {
            return array();
        }

        $name = array();

        if (isset($data['first_name'])) {
            $name[] = $data['first_name'];
        }
        if (isset($data['middle_name'])) {
            $name[] = $data['middle_name'];
        }
        if (isset($data['last_name'])) {
            $name[] = $data['last_name'];
        }

        $city = '';

        if (isset($data['city_name'])) {
            $city = $data['city_name'];
        } else if (isset($data['city_id']) && !is_numeric($data['city_id'])) {
            $city = $data['city_id'];
        }

        $state = '';

        if (isset($data['state_name'])) {
            $state = $data['state_name'];
        } else if (isset($data['state_id'])) {
            $state_data = $this->state->get($data['state_id']);
            $state = isset($state_data['name']) ? $state_data['name'] : '';
        }

        if (!empty($data['country'])) {
            $country = $data['country'];
        } else {
            $store = $this->store->getDefault(true);
            $country = $store['data']['country'];
        }

        return array(
            'city' => $city,
            'state' => $state,
            'country' => $country,
            'name' => implode(' ', $name),
            'email' => $this->user->getSession('email'),
            'phone' => isset($data['phone']) ? $data['phone'] : '',
            'zip' => isset($data['postcode']) ? $data['postcode'] : '',
            'company' => isset($data['company']) ? $data['company'] : '',
            'street1' => isset($data['address_1']) ? $data['address_1'] : '',
            'street2' => isset($data['address_2']) ? $data['address_2'] : '',
        );
    }

    /**
     * Returns an array of parcel data in Shippo's format
     * @param array $cart
     * @param array $order
     * @return array
     */
    protected function getParcel(array $cart, array $order)
    {
        $dimensions = $this->getDimensions($cart, $order);
        $dimensions += $this->settings['default'];

        return array(
            'width' => $dimensions['width'],
            'height' => $dimensions['height'],
            'length' => $dimensions['length'],
            'weight' => $dimensions['weight'],
            'mass_unit' => $order['weight_unit'],
            'distance_unit' => $order['size_unit']
        );
    }

    /**
     * Returns total dimensions of all products in the order
     * @param array $cart
     * @param array $order
     * @return array
     */
    protected function getDimensions(array $cart, array $order)
    {
        $width = $height = $length = $weight = array();

        foreach ($cart['items'] as $item) {
            $product = $item['product'];
            $width[] = (float) $this->convertor->convert($product['width'], $product['size_unit'], $order['size_unit']);
            $height[] = (float) $this->convertor->convert($product['height'], $product['size_unit'], $order['size_unit']);
            $length[] = (float) $this->convertor->convert($product['length'], $product['size_unit'], $order['size_unit']);
            $weight[] = (float) $this->convertor->convert($product['weight'], $product['weight_unit'], $order['weight_unit']);
        }

        $result = array(
            'height' => max($height),
            'length' => max($length),
            'width' => array_sum($width),
            'weight' => array_sum($weight),
        );

        if (count(array_filter($result)) != count($result)) {
            return array();
        }

        return $result;
    }

    /**
     * Sets a source shipping address
     * @param array $data
     * @return array
     */
    protected function getSourceAddress(array $data)
    {
        if (!empty($data['order']['shipping_address'])) {
            $address_id = $data['order']['shipping_address'];
            return $this->address->get($address_id);
        }

        if (!empty($data['show_shipping_address_form']) && !empty($data['address']['shipping'])) {
            return $data['address']['shipping'];
        }

        return array();
    }

}