2019-10-23 17:52:20 +02:00
==========================================
Wagtail 2.8 release notes - IN DEVELOPMENT
==========================================
.. contents ::
:local:
:depth: 1
What's new
==========
2019-12-17 13:51:23 +01:00
Django 3.0 support
~~~~~~~~~~~~~~~~~~
This release is compatible with Django 3.0. Compatibility fixes were contributed by Matt Westcott and Mads Jensen.
2019-10-23 17:52:20 +02:00
Other features
~~~~~~~~~~~~~~
2019-03-12 10:51:47 +01:00
* Removed leftover Python 2.x compatibility code (Sergey Fedoseev)
* Combine flake8 configurations (Sergey Fedoseev)
* Improved diffing behavior for text fields (Aliosha Padovani)
2019-10-24 12:05:10 +02:00
* Improve contrast of disabled inputs (Nick Smith)
2019-11-16 09:28:21 +01:00
* Added `` get_document_model_string `` function (Andrey Smirnov)
2019-11-19 15:50:01 +01:00
* Added support for Cloudflare API tokens for frontend cache invalidation (Tom Usher)
2019-11-26 16:50:44 +01:00
* Cloudflare frontend cache invalidation requests are now sent in chunks of 30 to fit within API limits (Tom Usher)
2019-11-19 15:50:01 +01:00
* Added `` ancestors `` field to pages endpoint in admin API (Karl Hobley)
2019-11-13 20:45:50 +01:00
* Removed Django admin management of `` Page `` & `` Site `` models (Andreas Bernacca)
2019-11-26 10:05:25 +01:00
* Cleaned up Django docs URLs in documentation (Pete Andrew)
2019-11-11 23:52:09 +01:00
* Add StreamFieldPanel to available panel types in documentation (Dan Swain)
* Add {{ block.super }} example to ModelAdmin customisation in documentation (Dan Swain)
2019-11-12 14:43:09 +01:00
* Add ability to filter image index by a tag (Benedikt Willi)
2019-09-06 17:32:34 +02:00
* Add formal support for nested InlinePanels (Matt Westcott)
2019-12-13 16:14:23 +01:00
* Added cache control headers when serving documents (Johannes Vogel)
2019-10-23 17:52:20 +02:00
Bug fixes
~~~~~~~~~
2019-10-20 06:56:21 +02:00
* Rename documents listing column 'uploaded' to 'created' (LB (Ben Johnston))
2019-10-07 17:05:44 +02:00
* Submenu items longer then the page height are no longer broken by the submenu footer (Igor van Spengen)
2019-09-06 13:30:07 +02:00
* Unbundle the l18n library as it was bundled to avoid installation errors which have been resolved (Matt Westcott)
2019-11-05 23:25:00 +01:00
* Prevent error when comparing pages that reference a model with a custom primary key (Fidel Ramos)
2019-11-16 09:28:21 +01:00
* Moved `` get_document_model `` location so it can be imported when Models are not yet loaded (Andrey Smirnov)
2019-11-06 23:14:40 +01:00
* Fixed incorrect HTML escaping of Jinja2 form templates for StructBlocks (Brady Moe)
2019-11-13 23:03:58 +01:00
* All templates with wagtailsettings and modeladmin now use `` block.super `` for `` extra_js `` & `` extra_css `` (Timothy Bautista)
2019-11-13 21:57:30 +01:00
* Layout issue when using FieldRowPanel with a heading (Andreas Bernacca)
2019-11-13 20:10:35 +01:00
* `` file_size `` and `` file_hash `` not updated when Document file changed (Andreas Bernacca)
2019-12-12 16:34:17 +01:00
* Fixed order of URLs in project template so that static / media URLs are not blocked (Nick Smith)
2019-12-06 16:18:18 +01:00
* Added verbose_name_plural for form submission model (Janneke Janssen)
2019-10-23 17:52:20 +02:00
2019-03-12 10:51:47 +01:00
2019-10-23 17:52:20 +02:00
Upgrade considerations
======================
2019-11-06 18:10:32 +01:00
Removed support for Django 2.0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Django 2.0 is no longer supported as of this release; please upgrade to Django 2.1 or above before upgrading Wagtail.
2019-10-23 22:41:37 +02:00
2019-11-28 12:21:18 +01:00
API endpoint classes have moved
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
For consistency with Django REST Framework, the `` PagesAPIEndpoint `` , `` ImagesAPIEndpoint `` and `` DocumentsAPIEndpoint `` classes have been renamed to `` PagesAPIViewSet `` , `` ImagesAPIViewSet `` and `` DocumentsAPIViewSet `` and moved to the `` views `` module in their respective packages. Projects using the Wagtail API should update their registration code accordingly.
Old code:
.. code-block :: python
from wagtail.api.v2.endpoints import PagesAPIEndpoint
from wagtail.api.v2.router import WagtailAPIRouter
from wagtail.images.api.v2.endpoints import ImagesAPIEndpoint
from wagtail.documents.api.v2.endpoints import DocumentsAPIEndpoint
api_router = WagtailAPIRouter('wagtailapi')
api_router.register_endpoint('pages', PagesAPIEndpoint)
api_router.register_endpoint('images', ImagesAPIEndpoint)
api_router.register_endpoint('documents', DocumentsAPIEndpoint)
New code:
.. code-block :: python
from wagtail.api.v2.views import PagesAPIViewSet
from wagtail.api.v2.router import WagtailAPIRouter
from wagtail.images.api.v2.views import ImagesAPIViewSet
from wagtail.documents.api.v2.views import DocumentsAPIViewSet
api_router = WagtailAPIRouter('wagtailapi')
api_router.register_endpoint('pages', PagesAPIViewSet)
api_router.register_endpoint('images', ImagesAPIViewSet)
api_router.register_endpoint('documents', DocumentsAPIViewSet)
2019-10-23 22:41:37 +02:00
`` wagtail.documents.models.get_document_model `` has moved
2019-11-13 20:45:50 +01:00
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2019-10-23 22:41:37 +02:00
The `` get_document_model `` function should now be imported from `` wagtail.documents `` rather than `` wagtail.documents.models `` . See :ref: `custom_document_model` .
2019-11-13 20:45:50 +01:00
Removed `` Page `` and `` Site `` models from Django admin
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Django admin will no longer provide editing access to `` Page `` or `` Site `` models, if required these models can be registered within individual projects using `Django's ModelAdmin <https://docs.djangoproject.com/en/2.2/ref/contrib/admin/#modeladmin-objects> `_ .
.. code-block :: python
# my_app/admin.py
from django.contrib import admin
from wagtail.core.models import Page, Site
admin.site.register(Site)
admin.site.register(Page)
