wagtail/docs/releases/1.3.rst

==========================================
Wagtail 1.3 release notes - IN DEVELOPMENT
==========================================

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


What's new
==========


Minor features
~~~~~~~~~~~~~~

 * Added ``WAGTAIL_PASSWORD_RESET_ENABLED`` setting to allow password resets to be disabled independently of the password management interface (John Draper)
 * Updated fonts for more comprehensive Unicode support
 * Added ``.alt`` attribute to image renditions
 * The default ``src``, ``width``, ``height`` and ``alt`` attributes can now be overridden by attributes passed to the ``{% image %}`` tag
 * Added keyboard shortcuts for preview and save in the page editor
 * Added ``Page`` methods ``can_exist_under``, ``can_create_at``, ``can_move_to`` for customising page type business rules


Bug fixes
~~~~~~~~~

 * HTTP cache purge now works again on Python 2 (Mitchel Cabuloy)
 * Locked pages can no longer be unpublished (Alex Bridge)
 * Site records now implement ``get_by_natural_key``
 * Creating pages at the root level (and any other instances of the base ``Page`` model) now properly respects the `parent_page_types` setting
 * Settings menu now opens correctly from the page editor and styleguide views
 * ``subpage_types`` / ``parent_page_types`` business rules are now enforced when moving pages


Upgrade considerations
======================

ContentType-returning methods in wagtailcore are deprecated
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The following internal functions and methods in ``wagtail.wagtailcore.models``, which return a list of ``ContentType`` objects, have been deprecated. Any uses of these in your code should be replaced by the corresponding new function which returns a list of model classes instead:

 * ``get_page_types()`` - replaced by ``get_page_models()``
 * ``Page.clean_subpage_types()`` - replaced by ``Page.clean_subpage_models()``
 * ``Page.clean_parent_page_types()`` - replaced by ``Page.clean_parent_page_models()``
 * ``Page.allowed_parent_page_types()`` - replaced by ``Page.allowed_parent_page_models()``
 * ``Page.allowed_subpage_types()`` - replaced by ``Page.allowed_subpage_models()``

In addition, note that these methods now return page types that are marked as ``is_creatable = False``, including the base ``Page`` class. (Abstract models are not included, as before.)
Created 1.3 changelog and release notes 2015-11-04 12:20:07 +00:00			`==========================================`
			`Wagtail 1.3 release notes - IN DEVELOPMENT`
			`==========================================`

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


			`What's new`
			`==========`


			`Minor features`
			`~~~~~~~~~~~~~~`

Release note for #468 2015-11-18 13:04:50 +00:00			* Added ``WAGTAIL_PASSWORD_RESET_ENABLED`` setting to allow password resets to be disabled independently of the password management interface (John Draper)
Release note for #1447 2015-11-18 17:04:39 +00:00			`* Updated fonts for more comprehensive Unicode support`
Changelog/release note for #1865 2015-11-19 15:30:23 +00:00			* Added ``.alt`` attribute to image renditions
Allow overriding attributes in {% image %} tag The `alt` attribute that was automatically generated as part of the `{% image %}` tag could not be overridden. If template authors passed their own `alt="..."` attribute in, two would be printed out instead of the default one being overridden. The relevant code has been refactored to build a dict of attributes, allowing the default set to be overridden, and then printing them using `flatatt`. Fixes #1933 2015-11-19 00:12:48 +00:00			* The default ``src``, ``width``, ``height`` and ``alt`` attributes can now be overridden by attributes passed to the ``{% image %}`` tag
Release note for #1969 2015-11-27 16:15:21 +00:00			`* Added keyboard shortcuts for preview and save in the page editor`
Release note for #1572 2015-12-03 13:19:44 +00:00			* Added ``Page`` methods ``can_exist_under``, ``can_create_at``, ``can_move_to`` for customising page type business rules
Release note for #468 2015-11-18 13:04:50 +00:00
Created 1.3 changelog and release notes 2015-11-04 12:20:07 +00:00
			`Bug fixes`
			`~~~~~~~~~`

Release note for #1925 2015-11-17 11:36:57 +00:00			`* HTTP cache purge now works again on Python 2 (Mitchel Cabuloy)`
Ensure that locked pages can't be unpublished. Fixes #1615 2015-11-23 20:52:46 +00:00			`* Locked pages can no longer be unpublished (Alex Bridge)`
Use SiteManager for Sites, add tests The SiteManager class was not used on the Site model, or anywhere else. This was not caught by the tests, because nothing tested the relevant attributes on the Site model, nor were they used in the code base. Tests have been added now. 2015-11-17 05:36:00 +00:00			* Site records now implement ``get_by_natural_key``
Release note for #1978 2015-12-01 13:17:31 +00:00			* Creating pages at the root level (and any other instances of the base ``Page`` model) now properly respects the `parent_page_types` setting
nav-submenu required translate3d due to its fixed position in the presence of animation, apparently. Also animation vendor prefixing removed since autoprefixer handles this already 2015-12-02 17:24:49 +00:00			`* Settings menu now opens correctly from the page editor and styleguide views`
Release note for #1572 2015-12-03 13:19:44 +00:00			* ``subpage_types`` / ``parent_page_types`` business rules are now enforced when moving pages
Release note for #1925 2015-11-17 11:36:57 +00:00
Created 1.3 changelog and release notes 2015-11-04 12:20:07 +00:00
			`Upgrade considerations`
			`======================`
Formally deprecate ContentType-returning methods in wagtailcore 2015-11-20 17:26:17 +00:00
			`ContentType-returning methods in wagtailcore are deprecated`
			`~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~`

			The following internal functions and methods in ``wagtail.wagtailcore.models``, which return a list of ``ContentType`` objects, have been deprecated. Any uses of these in your code should be replaced by the corresponding new function which returns a list of model classes instead:

			* ``get_page_types()`` - replaced by ``get_page_models()``
			* ``Page.clean_subpage_types()`` - replaced by ``Page.clean_subpage_models()``
			* ``Page.clean_parent_page_types()`` - replaced by ``Page.clean_parent_page_models()``
			* ``Page.allowed_parent_page_types()`` - replaced by ``Page.allowed_parent_page_models()``
			* ``Page.allowed_subpage_types()`` - replaced by ``Page.allowed_subpage_models()``
Release note for #1978 2015-12-01 13:17:31 +00:00
			In addition, note that these methods now return page types that are marked as ``is_creatable = False``, including the base ``Page`` class. (Abstract models are not included, as before.)