1.40.0
Warning: Potential breaking changes to shipping methods. Read release notes
To progress past a number of limitations with shipping integrations this update introduces a:
- shipping provider interface
- shipping service interface
- shipping rate object
- shipping quote object
Whilst efforts have been made to make this update backwards compatible it is strongly recommended you deploy this update to a staging server to test compatibility with any custom modules and integrations unique to your website, or not considered by this update.
To facilitate a rollback the following steps should be taken:
- Update your site to v1.39.2
- Make a copy of your
modules/shop
directory - Update your site to v1.40.0
If you encounter any issues presenting and applying shipping quotes to checkout/orders, restore the copy of your modules/shop
directory.
Some helper traceLog()
notices have been added to log usage of deprecated methods and properties.
It is recommended you check your log file after update to assist with bringing any custom module/integration code up to date.
These notices will be removed in subsequent releases.
Adds methods
-
Shop_ShippingOption::getQuoteForOrder()
-
Shop_ShippingOption::getQuoteForCheckout()
-
Shop_ShippingOption::getQuoteForCheckout()
-
Shop_ShippingOption::getQuotes()
-
Shop_ShippingOption::getShippingOptionsForCheckout()
-
Shop_ShippingOption::getShippingOptionsForOrder()
-
Shop_CheckoutData::hasAddressInfo()
-
Shop_CheckoutData::getShippingTaxes()
-
Shop_CheckoutData::getShippingQuotes()
-
Shop_AddressInfo::getHash()
-
Shop_Order::getApplicableShippingOptions()
-
Shop_Order::getAppliedShippingQuoteId()
-
Shop_RetailItem::getCurrencyCode()
Deprecates methods
-
Shop_Order::list_available_shipping_options()
-
Shop_OrderHelper::getShippingSubOptionHash()
-
Shop_ShippingOption::get_applicable_options()
-
Shop_ShippingOption::filter_applicable_options()
-
Shop_ShippingOption::get_quote_currency()
-
Shop_ShippingOption::convert_to_currency()
-
Shop_ShippingType::supports_shipping_labels()
-
Shop_ShippingType::generate_shipping_labels()
-
Shop_ShippingType::list_enabled_options()
-
Shop_CheckoutData::list_available_shipping_options()
-
Shop_CheckoutData::get_shipping_method()
-
Shop_CheckoutData::set_shipping_method()
-
Shop_CheckoutData::refresh_active_shipping_quote()
-
Shop_CheckoutData::get_shipping_taxes()
-
Shop_CheckoutData::flatten_shipping_options()
Removes deprecated methods:
-
Shop_Orders::getAVailableShippingMethods()
-
Shop_Orders::findLastOrder()
-
Shop_Orders::find_customer()
-
Shop_Orders::find_customer_group_id()
-
Shop_ShippingOption::get_quote()
-
Shop_ShippingOption::list_applicable()
-
Shop_ShippingOption::eval_quote()
-
Shop_CheckoutData::reset_shiping_method()
-
Shop_OrderHelper::getAvailableShippingMethods()
Adds events
- onUpdateShippingOptionsForCheckout
- onUpdateShippingOptionsForOrder
- onUpdateShippingQuotesForCheckout
- onUpdateShippingQuotesForOrder
Events affected by changes
- onBeforeShippingQuote
- onUpdateShippingQuote
- onAfterShippingQuoteApplied
Deprecated events
- onUpdateShippingOptions
- onAppendShippingQuoteCacheKey
- onFilterShippingOptions