# Wagtail 4.2 release notes - IN DEVELOPMENT _Unreleased_ ```{contents} --- local: depth: 1 --- ``` ## What's new ### Other features * Switch to using [Willow](https://github.com/wagtail/Willow/) instead of Pillow for images (Darrel O'Pry) * Test assertion [`WagtailPageTestCase.assertCanCreate`](testing_reference) now supports the kwarg `publish=True` to check publish redirection (Harry Percival, Akua Dokua Asiedu) * Ensure that the `rebuild_references_index` command can run without console output if called with `--verbosity 0` (Omerzahid Ali, Aman Pandey) * Add full support for secondary buttons with icons in the Wagtail design system - `button bicolor button--icon button-secondary` including the `button-small` variant (Seremba Patrick) * Add [`purge_embeds`](purge_embeds) management command to delete all the cached embed objects in the database (Aman Pandey) * Make it possible to resize the page editor’s side panels (Sage Abdullah) * Add ability to include [`form_fields` as an APIField](form_page_fields_api_field) on `FormPage` (Sævar Öfjörð Magnússon, Suyash Singh, LB (Ben) Johnston) * Ensure that images listings are more consistently aligned when there are fewer images uploaded (Theresa Okoro) ### Bug fixes * Make sure workflow timeline icons are visible in high-contrast mode (Loveth Omokaro) * Ensure authentication forms (login, password reset) have a visible border in Windows high-contrast mode (Loveth Omokaro) * Ensure visual consistency between buttons and links as buttons in Windows high-contrast mode (Albina Starykova) * Ensure `ChooserBlock.extract_references` uses the model class, not the model string (Alex Tomkins) * Incorrectly formatted link in the documentation for Wagtail community support (Bolarinwa Comfort Ajayi) * Ensure logo shows correctly on log in page in Windows high-contrast mode (Loveth Omokaro) * Comments notice background overflows its container (Yekasumah) * Ensure links within help blocks meet colour contrast guidelines for accessibility (Theresa Okoro) * Ensure the skip link (used for keyboard control) meets colour contrast guidelines for accessibility (Dauda Yusuf) * Ensure tag fields correctly show in both dark and light Windows high-contrast modes (Albina Starykova) * Ensure new tooltips & tooltip menus have visible borders and tip triangle in Windows high-contrast mode (Juliet Adeboye) * Ensure there is a visual difference of 'active/current link' vs normal links in Windows high-contrast mode (Mohammad Areeb) * Avoid issues where trailing whitespace could be accidentally removed in translations for new page & snippet headers (Florian Vogt) * Make sure minimap error indicators follow the minimap scrolling (Thibaud Colas) * Remove the ability to view or add comments to `InlinePanel` inner fields to avoid lost or incorrectly linked comments (Jacob Topp-Mugglestone) * Use consistent heading styles on top-level fields in the page editor (Sage Abdullah) * Allow button labels to wrap onto two lines in dropdown buttons (Coen van der Kamp) * Allow both horizontal and vertical manual resizing of TextFields (Anisha Singh) * Move DateField, DateTimeField, TimeField comment buttons to be right next to the fields (Theresa Okoro) * Support text resizing in workflow steps cards (Ivy Jeptoo) * Ignore images added via fixtures when using `WAGTAILIMAGES_FEATURE_DETECTION_ENABLED` to avoid errors for images that do not exist (Aman Pandey) ### Documentation * Add custom permissions section to permissions documentation page (Dan Hayden) * Wagtail's documentation (v2.9 to v4.0) has been updated on [Dash user contributions](https://github.com/Kapeli/Dash-User-Contributions) for [Dash](https://kapeli.com/dash) or [Zeal](https://zealdocs.org/) offline docs applications (Damilola Oladele, Mary Ayobami, Elizabeth Bassey) * Add documentation for how to get started with [contributing translations](contributing_translations) for the Wagtail admin (Ogunbanjo Oluwadamilare) * Officially recommend `fnm` over `nvm` in development documentation (LB (Ben) Johnston) * Mention the importance of passing `request` and `current_site` to `get_url` on the [performance](performance) documentation page (Jake Howard) * Add documentation for [`register_user_listing_buttons`](register_user_listing_buttons) hook (LB (Ben Johnston)) * Add development (contributing to Wagtail) documentation notes for [development on Windows](development_on_windows) (Akua Dokua Asiedu) * Mention Wagtail’s usage of Django’s default user model by default (Temidayo Azeez) * Add links to treebeard documentation for relevant methods (Temidayo Azeez) * Add clarification on where to register entity plugins (Mark McOsker) * Fix logo in README not being visible in high-contrast mode (Benita Anawonah) * Improve 'first wagtail site' tutorial (Akua Dokua Asiedu) * Grammatical adjustments of `page models` usage guide (Damilola Oladele) * Add class inheritance information to StreamField block sreference (Temidayo Azeez) * Document the hook [`register_image_operations`](register_image_operations) and add an example of a [custom Image filter](custom_image_filters) (Coen van der Kamp) ### Maintenance * Upgrade to Node 18 for frontend build tooling (LB (Ben) Johnston) * Run Python tests with coverage and upload coverage data to codecov (Sage Abdullah) * Clean up duplicate JavaScript for the `escapeHtml` function (Jordan Rob) * Ensure that translation file generation ignores JavaScript unit tests and clean up unit tests for Django gettext utils (LB (Ben Johnston)) * Migrated `initButtonSelects` from core.js to own TypesScript file and add unit tests (Loveth Omokaro) * Migrated `initSkipLink` util to TypeScript and add JSDoc & unit tests (Juliet Adeboye) * Clean up some unused utility classes and migrate `unlist` to Tailwind utility class `w-list-none` (Loveth Omokaro) * Clean up linting on legacy code and add shared util `hasOwn` in TypeScript (Loveth Omokaro) * Remove unnecessary box-sizing: border-box declarations in SCSS (Albina Starykova) * Migrated `initTooltips` to TypeScript add JSDoc and unit tests (Fatuma Abdullahi) * Migrated `initTagField` from core.js to own TypeScript file and add unit tests (Chisom Okeoma) * Added unit tests & JSDoc to `initDissmisibles` (Yekasumah) ## Upgrade considerations ### Wagtail-specific image field (`WagtailImageField`) The `AbstractImage` and `AbstractRendition` models use a Wagtail-specific `WagtailImageField` which extends Django's `ImageField` to use [Willow](https://github.com/wagtail/Willow/) for image file handling. This will generate a new migration if you are using a [custom image model](custom_image_model) ### Comments within `InlinePanel` not supported When the commenting system was introduced, support for `InlinePanel` fields was incorrectly added. This has lead to issues where comments can be lost on save or in most cases will be added to the incorrect item within the `InlinePanel`. The ability to add comments here has now been removed and as such any existing comments that were added will no longer show. See https://github.com/wagtail/wagtail/issues/9685 for tracking of adding this back officially in the future.