Platform Upgrade -- Wagtail 7.2, Node 24

[engineervix]

Link to Ticket

When applied this MR will

• Upgrade Wagtail to v7.2
• Upgrade Node.js to v24
• Upgrade several outdated python and Node.js dependencies

Important

• Before it's deployed run poetry update modelsearch to be sure we pick up the latest modelsearch package

How to Test

Please see the relevant spreadsheet

Screenshots

Expand to see more

Wagtail 7.2 release notes

Add a link to the commit or file for each consideration if you made any code changes.

Code reviewing a consideration.

Use the tick box to indicate a consideration has been code reviewed as OK

Upgrade considerations - changes affecting all projects

• Elasticsearch and OpenSearch users should run update_index after upgrading ES not used
• ATOMIC_REBUILD now active by default on Elasticsearch and OpenSearch ES not used
• INDEX configuration option on Elasticsearch and OpenSearch replaced with INDEX_PREFIX ES not used

Upgrade considerations - deprecation of old functionality

• Removed support for Python 3.9

Upgrade considerations - changes to undocumented internals

• File title generation in document and image uploads now uses SyncController
• refresh_index method on search backends renamed to refresh_indexes

All versions extras

Identified by the support team as additional considerations to be checked for all Wagtail upgrades

• Node version should be >=20: Is there a node upgrade to be combined with this? Raise as a follow up action if a node upgrade is required
• Dockerfile images should be at least python 3.13 and the OS should be pinned. Is there a python docker image upgrade to be combined with this? Raise as a follow up action if a Docker image upgrade is required
• TBX forms should be updated to at least version if it's used.
• Django has been updated to the latest 4.2 or 5.2 patch version.
• If an upgrading.md file exists, update it with the latest information for any future upgrade checks.
• Overridden admin templates have been updated, if required, to match the latest Wagtail version.
• Are any wagtail packages using our forked version tags?
• Run trivy to check for security patches that poetry may not bump.
• CHANGELOG updated or created.

Additional Considerations

Any other considerations you've made and/or considered.

• Before it's deployed run poetry update modelsearch to be sure we pick up the latest modelsearch package

MR Checklist

• Add a description of your pull request and instructions for the reviewer to verify your work.

• If your pull request is for a specific ticket, link to it in the description.

• Stay on point and keep it small so the merge request can be easily reviewed.

• Tests and linting passes.

• Added

• Not required

Documentation

• Updated build docs
• Updated editor guidelines (See https://intranet.torchbox.com/torchbox-com-project-docs for the private link, for Torchbox employees only)
• Updated field spec (See https://intranet.torchbox.com/torchbox-com-project-docs for the private link, for Torchbox employees only)
• Not required

Browser testing

• I have tested in the following browsers and environments (edit the list as required)
  • Latest version of Chrome on mac
  • Latest version of Firefox on mac
  • Latest version of Safari on mac
  • Safari on last two versions of iOS
  • Chrome on last two versions of Android
• Not required

Data protection

• Not relevant
• This adds new sources of PII and documents it and modifies Birdbath processors accordingly

Light and dark mode

• I have tested the changes in both light and dark mode
• The change is not relevant to dark and light mode

Accessibility

• Automated WCAG 2.1 tests pass
• HTML validation passes
• Manual WCAG 2.1 tests completed
• I have tested in a screen reader
• I have tested in high-contrast mode
• Any animations removed for prefers-reduced-motion
• Not required

Sustainability

• Images are optimised and lazy-loading used where appropriate
• SVGs have been optimised
• Performance and transfer of data considered
• If JavaScript is needed alternatives have been considered
• Not required

Pattern library

• The pattern library component for this template displays correctly, and does not break parent templates
• The styleguide is updated if relevant
• Changes are not relevant the pattern library

[nickmoreton]

Thanks @engineervix You code changes all look good and the UI looks correct locally.

Can you please update the upgrading.md file, there's a couple of Wagtail 7.1 references to bump to 7.2

[engineervix]

Thanks @engineervix You code changes all look good and the UI looks correct locally.

Can you please update the upgrading.md file, there's a couple of Wagtail 7.1 references to bump to 7.2

Thanks @nickmoreton, done in 41edd18