wagtail/docs/releases/6.0.md

# Wagtail 6.0 release notes - IN DEVELOPMENT

_Unreleased_

```{contents}
---
local:
depth: 1
---
```

## What's new


### Other features

 * Added `search_index` option to StreamField blocks to control whether the block is indexed for searching (Vedant Pandey)
 * Remember previous location on returning from page add/edit actions (Robert Rollins)
 * Update settings file in project settings to address Django 4.2 deprecations (Sage Abdullah)
 * Improve layout and accessibility of the image URL generator page, reduce reliance on JavaScript (Temidayo Azeez)

### Bug fixes

 * Update system check for overwriting storage backends to recognise the `STORAGES` setting introduced in Django 4.2 (phijma-leukeleu)
 * Prevent password change form from raising a validation error when browser autocomplete fills in the "Old password" field (Chiemezuo Akujobi)
 * Ensure that the legacy dropdown options, when closed, do not get accidentally clicked by other interactions wide viewports (CheesyPhoenix, Christer Jensen)
 * Add a fallback background for the editing preview iframe for sites without a background (Ian Price)
 * Preserve whitespace in rendered comments (Elhussein Almasri)
 * Remove search logging from project template so that new projects without the search promotions module will not error (Matt Westcott)
 * Ensure text only email notifications for updated comments do not escape HTML characters (Rohit Sharma)
 * Use the latest draft when copying an unpublished page for translation (Andrey Nehaychik)

### Documentation

 * Document, for contributors, the use of translate string literals passed as arguments to tags and filters using `_()` within templates (Chiemezuo Akujobi)

### Maintenance

 * Update BeautifulSoup upper bound to 4.12.x (scott-8)
 * Migrate initialization of classes (such as `body.ready`) from multiple JavaScript implementations to one Stimulus controller `w-init` (Chiemezuo Akujobi)
 * Adopt the usage of of translate string literals using `arg=_('...')` in all `wagtailadmin` module templates (Chiemezuo Akujobi)
 * Migrate the contrib styleguide index view to a class-based view (Chiemezuo Akujobi)
 * Update djhtml to 3.0.6 (Matt Westcott)
 * Migrate the contrib settings edit view to a class-based view (Chiemezuo Akujobi, Sage Abdullah)
 * Remove django-pattern-library upper bound in testing dependencies (Sage Abdullah)
 * Split up functions in Elasticsearch backend for easier extensibility (Marcel Kornblum, Cameron Lamb, Sam Dudley)
 * Relax draftjs_exporter dependency to allow using version 5.x (Sylvain Fankhauser)
 * Refine styling of listings, account settings panels and the block chooser (Meli Imelda)
 * Remove icon font support (Matt Westcott)
 * Remove deprecated SVG icons (Matt Westcott)
 * Migrate account editing view to a class-based view (Kehinde Bobade)


## Upgrade considerations - changes affecting all projects

### Support for Elasticsearch 5 and 6 dropped

The Elasticsearch 5 and 6 backends have been removed. If you are using one of these backends, you will need to upgrade to Elasticsearch 7 or 8 before upgrading to Wagtail 6.0.

## Upgrade considerations - deprecation of old functionality

## Upgrade considerations - changes affecting Wagtail customisations

## Upgrade considerations - changes to undocumented internals
Update version number to 6.0 2023-10-26 09:29:31 +00:00			`# Wagtail 6.0 release notes - IN DEVELOPMENT`
Set up release notes for 5.3 2023-10-20 13:27:19 +00:00
			`_Unreleased_`

			```{contents}
			`---`
			`local:`
			`depth: 1`
			`---`
			```

			`## What's new`


			`### Other features`

Add search_index option to control search indexing of StreamField blocks (#11135) 2023-10-26 09:11:49 +00:00			* Added `search_index` option to StreamField blocks to control whether the block is indexed for searching (Vedant Pandey)
Add next_url to Edit and Add Child page-listing buttons (#11170) 2023-11-01 23:31:05 +00:00			`* Remember previous location on returning from page add/edit actions (Robert Rollins)`
Release note for #11196 2023-11-07 14:28:50 +00:00			`* Update settings file in project settings to address Django 4.2 deprecations (Sage Abdullah)`
Improve layout of Image URL Generator - Move preview image to above the 'fold' so it's clearer to users what this page is for - Avoid the JS driven (non-responsive) alert that shows if the image is too large and instead opt for a simpler CSS approach, allowing the image to overflow with a scrolling container - Add w-prefixed classes for elements - Ensure URL has an accessible label - Relates to #3683 2023-11-03 09:44:48 +00:00			`* Improve layout and accessibility of the image URL generator page, reduce reliance on JavaScript (Temidayo Azeez)`
Set up release notes for 5.3 2023-10-20 13:27:19 +00:00
			`### Bug fixes`

Update checks.py (#10462) Prevent "RemovedInDjango51Warning: The DEFAULT_FILE_STORAGE setting is deprecated. Use STORAGES instead." 2023-05-22 14:03:08 +00:00			* Update system check for overwriting storage backends to recognise the `STORAGES` setting introduced in Django 4.2 (phijma-leukeleu)
fix validation error on save from autocomplete (#11113) 2023-10-22 16:44:36 +00:00			`* Prevent password change form from raising a validation error when browser autocomplete fills in the "Old password" field (Chiemezuo Akujobi)`
Update changelog contributors for #11101 2023-10-26 12:07:48 +00:00			`* Ensure that the legacy dropdown options, when closed, do not get accidentally clicked by other interactions wide viewports (CheesyPhoenix, Christer Jensen)`
Add a background on the preview iframe Ensures that when the iframe content is loaded there is a background on the iframe. So that transparent websites show correctly in the preview panel. Fixes #11174 2023-11-05 00:33:35 +00:00			`* Add a fallback background for the editing preview iframe for sites without a background (Ian Price)`
Preserve whitespace in rendered comments Fixes #11171 2023-11-02 19:42:53 +00:00			`* Preserve whitespace in rendered comments (Elhussein Almasri)`
Remove search logging from project template The search view on the project template is still attempting to log queries against the now-removed wagtailsearch.Query model - as of 6.0a0 this is causing an ImportError when running initial migrations on a newly-created project. Since the wagtail.contrib.search_promotions module is optional (and off by default on new projects), I've opted to comment out the query logging code with instructions for developers who wish to re-enable it. 2023-11-06 12:08:53 +00:00			`* Remove search logging from project template so that new projects without the search promotions module will not error (Matt Westcott)`
Ensure updated comments notifications (text) render unescaped strings Fixes #11143 2023-10-27 18:40:34 +00:00			`* Ensure text only email notifications for updated comments do not escape HTML characters (Rohit Sharma)`
Use the latest draft when copying an unpublished page for translation (#7755) Fixes #7754 Co-authored-by: Andrey Nehaychik <andrey.nehaychik@vizor-games.com> 2023-11-08 18:31:20 +00:00			`* Use the latest draft when copying an unpublished page for translation (Andrey Nehaychik)`
Set up release notes for 5.3 2023-10-20 13:27:19 +00:00
			`### Documentation`

Update contributing translation docs - template usage Closes #10126 2023-10-21 20:21:25 +00:00			* Document, for contributors, the use of translate string literals passed as arguments to tags and filters using `_()` within templates (Chiemezuo Akujobi)
Set up release notes for 5.3 2023-10-20 13:27:19 +00:00
			`### Maintenance`

update beautifulsoup pin (#11096) 2023-10-19 16:09:55 +00:00			`* Update BeautifulSoup upper bound to 4.12.x (scott-8)`
Add changelog for #11120 Closes #11071 2023-10-24 21:14:34 +00:00			* Migrate initialization of classes (such as `body.ready`) from multiple JavaScript implementations to one Stimulus controller `w-init` (Chiemezuo Akujobi)
Use use _() over interim template vars for translations as args (wagtailadmin) Closes #10126 2023-10-21 13:19:03 +00:00			* Adopt the usage of of translate string literals using `arg=_('...')` in all `wagtailadmin` module templates (Chiemezuo Akujobi)
Release notes for #11014 2023-11-06 14:41:02 +00:00			`* Migrate the contrib styleguide index view to a class-based view (Chiemezuo Akujobi)`
Bump djhtml to 3.0.6 (#11158) Notably, this changes the behaviour of multi-line HTML tags so that attributes are aligned (https://github.com/rtts/djhtml#new-multi-line-html-elements). The pre-commit hook was already set to use djhtml 3.0.6, which meant that it was making changes that conflicted with the formatting rules enforced by the Makefile and CI. 2023-10-30 15:49:41 +00:00			`* Update djhtml to 3.0.6 (Matt Westcott)`
Release notes for #11014 2023-11-06 14:41:02 +00:00			`* Migrate the contrib settings edit view to a class-based view (Chiemezuo Akujobi, Sage Abdullah)`
Remove upper bound on django-pattern-library in testing dependencies 2023-11-06 10:30:44 +00:00			`* Remove django-pattern-library upper bound in testing dependencies (Sage Abdullah)`
Split out Elasticsearch backend functionality out for easier extensibility (#11199, #11018) Co-authored-by: marcelkornblum <me@marcelkornblum.com> Co-authored-by: Cameron Lamb <cameron.lamb@digital.trade.gov.uk> 2023-11-07 14:11:07 +00:00			`* Split up functions in Elasticsearch backend for easier extensibility (Marcel Kornblum, Cameron Lamb, Sam Dudley)`
Allow using draftjs_exporter 5.0 (#11024) Fixes #10723 2023-11-08 07:48:36 +00:00			`* Relax draftjs_exporter dependency to allow using version 5.x (Sylvain Fankhauser)`
Add changelog for #11097 Relates to partial styling improvements as specified in #11065 2023-11-08 20:48:55 +00:00			`* Refine styling of listings, account settings panels and the block chooser (Meli Imelda)`
Release notes for #11201 2023-11-09 08:56:08 +00:00			`* Remove icon font support (Matt Westcott)`
			`* Remove deprecated SVG icons (Matt Westcott)`
Refactored the Account editing view to CBV Relates to #8629 2023-10-15 14:31:00 +00:00			`* Migrate account editing view to a class-based view (Kehinde Bobade)`
Set up release notes for 5.3 2023-10-20 13:27:19 +00:00

			`## Upgrade considerations - changes affecting all projects`

Drop support for Elasticsearch 5 and 6 2023-10-23 16:16:34 +00:00			`### Support for Elasticsearch 5 and 6 dropped`

			`The Elasticsearch 5 and 6 backends have been removed. If you are using one of these backends, you will need to upgrade to Elasticsearch 7 or 8 before upgrading to Wagtail 6.0.`

Set up release notes for 5.3 2023-10-20 13:27:19 +00:00			`## Upgrade considerations - deprecation of old functionality`

			`## Upgrade considerations - changes affecting Wagtail customisations`

			`## Upgrade considerations - changes to undocumented internals`