edan_f0/docs/source/releases/v1.6.rst

=======================
Oscar 1.6 release notes
=======================

:release: tbd

Welcome to Oscar 1.6


Table of contents:

.. contents::
    :local:
    :depth: 1


.. _compatibility_of_1.6:

Compatibility
-------------

Oscar 1.6 is compatible with Django 1.8, 1.10 and 1.11 as well as Python 2.7,
3.3, 3.4, 3.5 and 3.6. Support for Django 1.9 is no longer officialy supported
since it is longer supported by Django (end of life).


.. _new_in_1.6:

What's new in Oscar 1.6?
------------------------


Removal of deprecated features
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 - Removed ``OSCAR_PROMOTION_MERCHANDISING_BLOCK_TYPES`` setting since
   merchandising block promotions, which used it, already removed for a while.

Minor changes
~~~~~~~~~~~~~
 - Majority of the Oscar imports now using dynamic loading, instead of
   direct importing for better extensibility and customizability, except
   signals.
 - Customer transaction emails reworked on top of mailgun layout and has
   better look.
 - ``SearchHandler.get_search_form`` method now accepts additional
   keyword arguments, which will be passed on search form class instance
   initiation.
 - Added ``get_stock_info`` hook to ``oscar.apps.basket.models.Basket``  for
   implementing strategies that depend on product options.
 - Fixed the page create/update views in the dashboard to correctly validate
   URLs. Invalid characters in URLs will raise a validation error, as will
   URLs longer than 100 characters.
 - Default shipping method on basket summary page uses default user shipping
   address in order to calculate indicative shipping cost. Default shipping
   address definition can be overridden in
   ``oscar.apps.basket.views.BasketView.get_default_shipping_address`` method.
 - Fixed `ExtendedURLValidator` for locale-prefixed URLs for locales, different
   from current (see :issue:`1481`). Previously, validation did not pass when
   current locale is "en-gb" and URL is "/de/catalogue/" and visa versa due to
   default Django URL resolvers behaviour  - they do not take into account all
   locales, only current.
 - Product attribute value save now handled by separate methods, similar to
   validation which allows to override save logic for file, multi-option or
   generic attribute values.
 - Address hash generation is now separated from the summary in order to
   preserve same behavior when summary property customized (see :issue:`1537`).
   They can use different field names, listed out in `base_fields` and
   `hash_fields` respectively. Also hash generation now became
   platform-independent and generates the same for Python 2 and 3.
   Corresponding data migration will update hashes automatically. Take it into
   account that it will take time to run if you have large user base.

.. _incompatible_in_1.6:

Backwards incompatible changes in Oscar 1.6
-------------------------------------------

 - ``oscar.apps.customer.auth_backends.EmailBackend`` now rejects inactive users
   (where ``User.is_active`` is ``False``).

 - ``oscar.apps.offer.models.ConditionalOffer`` now has a new flag
   ``exclusive`` to denote that the offer involved can not be combined on the
   same item on the same basket line with another offer.
   This flag is used by ``oscar.apps.basket.utils.LineOfferConsumer``, a facade
   that supercedes the old ``oscar.apps.basket.models.Line._affected_items`` counter,
   and replaces it with a more finegrained approach. This makes it possible to apply
   two distinct non-exclusive offers on the same basketline items, for example
   multiple distinct vouchers.
   A couple of methods on the basketline model have been extended with an
   optional ``offer`` argument, i.e. ``discount`` and ``consume``, so if you
   are using a customized basketline model, you have to update your methods'
   signatures.

 - Invalid URL names supplied to the ``OSCAR_DASHBOARD_NAVIGATION`` setting
   are now logged as an exception (previously they were silently ignored).
   The offending menu item will be skipped during menu rendering.
   In Oscar 1.8 the exception will be raised without being intercepted.

 - All signals are now loaded directly.

Dependency changes
------------------


.. _deprecated_features_in_1.6:

Deprecated features
~~~~~~~~~~~~~~~~~~~

The following features have been deprecated in this release:

* ``StockRecord.price_excl_tax`` will be renamed into ``StockRecord.price`` in
  Oscar 2.0. Please see :issue:`1962` for more details.

* The ``StockRecord.price_retail`` and ``StockRecord.cost_price`` fields are
  deprecated and will be removed in Oscar 2.0.

* The ``order.Line.est_dispatch_date``,  ``order.Line.line_price_incl_tax``,
  ``order.Line.unit_retail_price``, ``order.Line.unit_cost_price`` and
  ``order.Line.line_price_excl_tax`` fields are deprecated and will be removed
  in Oscar 2.0.