Wagtail 2.14 release notes¶
August 2, 2021
What’s new¶
New features¶
Added
ancestor_of
API filter. See Filtering by tree position (pages only). (Jaap Roes)Added support for customising group management views. See Customising group edit/create views. (Jan Seifert)
Added
full_url
property to image renditions (Shreyash Srivastava)Added locale selector when choosing translatable snippets (Karl Hobley)
Added
WAGTAIL_WORKFLOW_ENABLED
setting for enabling / disabling moderation workflows globally (Matt Westcott)Allow specifying
max_width
andmax_height
on EmbedBlock (Petr Dlouhý)Add warning when StreamField is used without a StreamFieldPanel (Naomi Morduch Toubman)
Added keyboard and screen reader support to Wagtail user bar (LB Johnston, Storm Heg)
Added instructions on copying and aliasing pages to the editor’s guide in documentation (Vlad Podgurschi)
Add Google Data Studio to the list of oEmbed providers (Petr Dlouhý)
Allow ListBlock to raise validation errors that are not attached to an individual child block (Matt Westcott)
Use
DATETIME_FORMAT
for localization in templates (Andrew Stone)Added documentation on multi-site, multi instance and multi tenancy setups (Coen Van Der Kamp)
Updated Facebook / Instagram oEmbed endpoints to v11.0 (Thomas Kremmel)
Performance improvements for admin listing pages (Jake Howard, Dan Braghis, Tom Usher)
Bug fixes¶
Invalid filter values for foreign key fields in the API now give an error instead of crashing (Tidiane Dia)
Ordering specified in the
construct_explorer_page_queryset
hook is now taken into account again by the page explorer API (Andre Fonseca)Deleting a page from its listing view no longer results in a 404 error (Tidiane Dia)
The Wagtail admin urls will now respect the
APPEND_SLASH
setting (Tidiane Dia)Prevent “Forgotten password” link from overlapping with field on mobile devices (Helen Chapman)
Snippet admin urls are now namespaced to avoid ambiguity with the primary key component of the url (Matt Westcott)
Prevent error on copying pages with ClusterTaggableManager relations and multi-level inheritance (Chris Pollard)
Prevent failure on root page when registering the Page model with ModelAdmin (Jake Howard)
Prevent error when filtering page search results with a malformed content_type (Chris Pollard)
Prevent multiple submissions of “update” form when uploading images / documents (Mike Brown)
Ensure HTML title is populated on project template 404 page (Matt Westcott)
Respect cache_age parameters on embeds (Gordon Pendleton)
Page comparison view now reflects request-level customisations to edit handlers (Matt Westcott)
Add
block.super
to remainingextra_js
&extra_css
blocks (Andrew Stone)Ensure that
editor
andfeatures
arguments on RichTextField are preserved byclone()
(Daniel Fairhead)Rename ‘spin’ CSS animation to avoid clashes with other libraries (Kevin Gutiérrez)
Prevent crash when copying a page from a section where the user has no publish permission (Karl Hobley)
Ensure that rich text conversion correctly handles images / embeds inside links or inline styles (Matt Westcott)
Upgrade considerations¶
Removed support for Django 2.2¶
Django 2.2 is no longer supported as of this release; please upgrade to Django 3.0 or above before upgrading Wagtail.
User bar with keyboard and screen reader support¶
The Wagtail user bar (“edit bird”) widget now supports keyboard and screen reader navigation. To make the most of this, we now recommend placing the widget near the top of the page <body>
, so users can reach it without having to go through the whole page. See Wagtail user bar for more information.
For implementers of custom user bar menu items, we also now require the addition of role="menuitem"
on the a
element to provide the correct semantics. See construct_wagtail_userbar for more information.
Deprecation of Facebook / Instagram oEmbed product¶
As of June 2021, the procedure for setting up a Facebook app to handle Facebook / Instagram embedded content (see Facebook and Instagram) has changed. It is now necessary to activate the “oEmbed Read” feature on the app, and submit it to Facebook for review. Apps that activated the oEmbed Product before June 8, 2021 must be migrated to oEmbed Read by September 7, 2021 to continue working. No change to the Wagtail code or configuration is required.