Skip to content

1.40.0

Compare
Choose a tag to compare
@damanic damanic released this 13 Apr 04:32
· 38 commits to master since this release

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