wagtail/docs/releases/2.6.rst

==========================================
Wagtail 2.6 release notes - IN DEVELOPMENT
==========================================

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


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


Other features
~~~~~~~~~~~~~~

 * Added support for ``short_description`` for field labels in modeladmin's ``InspectView`` (Wesley van Lee)
 * Rearranged SCSS folder structure to the client folder and split them approximately according to ITCSS. (Naomi Morduch Toubman, Jonny Scholes, Janneke Janssen, Hugo van den Berg)
 * Added support for specifying cell alignment on TableBlock (Samuel Mendes)
 * Added more informative error when a non-image object is passed to the ``image`` template tag (Deniz Dogan)
 * Added more ARIA landmarks across the admin interface and welcome page for screen reader users to navigate the CMS more easily (Beth Menzies)
 * Added ButtonHelper examples in the modelAdmin primer page within documentation (Kalob Taulien)
 * Multiple clarifications, grammar and typo fixes throughout documentation (Dan Swain)
 * Use correct URL in API example in documentation (Michael Bunsen)
 * Move datetime widget initialiser JS into the widget's form media instead of page editor media (Matt Westcott)
 * Add form field prefixes for input forms in chooser modals (Matt Westcott)
 * Increase font-size across the whole admin (Beth Menzies, Katie Locke)
 * Improved text color contrast across the whole admin (Beth Menzies, Katie Locke)
 * Added consistent focus outline styles across the whole admin (Thibaud Colas)
 * Removed version number from the logo link’s title. The version can now be found under the Settings menu (Thibaud Colas)
 * Added "don't delete" option to confirmation screen when deleting images, documents and modeladmin models (Kevin Howbrook)
 * Added ``branding_title`` template block for the admin title prefix (Dillen Meijboom)
 * Add image dimensions in image gallery and image choosers for screen reader users (Helen Chapman)
 * Added support for custom search handler classes to modeladmin's IndexView, and added a class that uses the default Wagtail search backend for searching (Seb Brown, Andy Babic)
 * Improved heading structure for screen reader users navigating the CMS admin (Beth Menzies, Helen Chapman)
 * Update group edit view to expose the ``Permission`` object for each checkbox (George Hickman)


Bug fixes
~~~~~~~~~

 * ModelAdmin no longer fails when filtering over a foreign key relation (Jason Dilworth, Matt Westcott)
 * The Wagtail version number is now visible within the Settings menu (Kevin Howbrook)
 * Scaling images now rounds values to an integer so that images render without errors (Adrian Brunyate)
 * Revised test decorator to ensure TestPageEditHandlers test cases run correctly (Alex Tomkins)
 * Wagtail bird animation in admin now ends correctly on all browsers (Deniz Dogan)
 * Explorer menu no longer shows sibling pages for which the user does not have access (Mike Hearn)
 * Fixed occurences of invalid HTML across the CMS admin (Thibaud Colas)
 * Admin HTML now includes the correct ``dir`` attribute for the active language (Andreas Bernacca)
 * Fix type error when using ``--chunk_size`` argument on ``./manage.py update_index`` (Seb Brown)
 * Avoid rendering entire form in EditHandler's ``repr`` method (Alex Tomkins)
 * Add empty alt attributes to HTML output of Embedly and oEmbed embed finders (Andreas Bernacca)
 * Add empty alt attributes to all images in the CMS admin (Andreas Bernacca)
 * Make URL generator preview image alt translateable (Thibaud Colas)
 * Clear pending AJAX request if error occurs on page chooser (Matt Westcott)
 * Prevent text from overlapping in focal point editing UI (Beth Menzies)
 * Screen readers now announce "Dashboard" for the main nav’s logo link instead of Wagtail’s version number (Thibaud Colas)
 * Screen readers now treat page-level action dropdowns as navigation instead of menus (Helen Chapman)
 * Make icon font implementation more screen-reader-friendly (Thibaud Colas)
 * Remove duplicate labels in image gallery and image choosers for screen reader users (Helen Chapman)
 * Restore custom "Date" icon for scheduled publishing panel in Edit page’s Settings tab (Helen Chapman)
 * Added missing form media to user edit form template (Matt Westcott)
 * Added a label to the modals’ “close” button for screen reader users (Helen Chapman, Katie Locke)


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

Removed support for Python 3.4
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Python 3.4 is no longer supported as of this release; please upgrade to Python 3.5 or above before upgrading Wagtail.

Icon font implementation changes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The icon font implementation has been changed to be invisible, by switching to using `Private Use Areas <https://en.wikipedia.org/wiki/Private_Use_Areas>`_ Unicode code points. All of the icon classes (``icon-user``, ``icon-search``, etc) should still work the same, except for two which have been removed because they were duplicates:

 * ``icon-picture`` is removed. Use ``icon-image`` instead (same visual).
 * ``icon-file-text-alt`` is removed. Use ``icon-doc-full`` instead (same visual).

For a list of all available icons, please see the :ref:`styleguide`.