Drupal Release: 9.2.7

TL;DR

Drupal 9.2.7: Accessibility Improvements and Bug Fixes

This minor release of Drupal 9.2.7 focuses primarily on accessibility improvements in the Olivero theme, fixing several color contrast issues and improving user experience across different devices. It also addresses important bugs in Layout Builder, JSON:API file uploads, and Views contextual filters. This update is recommended for all Drupal 9.2.x sites to ensure better accessibility compliance and improved functionality.

Highlight of the Release

• Multiple accessibility improvements in the Olivero theme, fixing color contrast issues in buttons, skip links, and comment forms
• Fixed JSON:API file upload functionality to the public file root
• Improved Views contextual filter handling for multiple values with user roles
• Fixed Layout Builder breadcrumb handling
• Added performance optimization for migrate message tables

Migration Guide

This minor release does not require any specific migration steps. Simply update your Drupal core to version 9.2.7 following the standard update procedure:

1. Back up your database and code
2. Put your site into maintenance mode
3. Update Drupal core using Composer:

   composer update drupal/core 'drupal/core-*' --with-all-dependencies
   

4. Run the database updates:

   drush updatedb
   

5. Clear caches:

   drush cache:rebuild
   

6. Take your site out of maintenance mode

If you're using the JSON:API for file uploads, this update will fix issues with uploading to the public file root, so no additional configuration is needed.

Upgrade Recommendations

It is recommended to upgrade to Drupal 9.2.7 for all sites currently running Drupal 9.2.x. This release contains important accessibility improvements and bug fixes that enhance the overall user experience and site functionality.

The update is particularly important for:

• Sites using the Olivero theme, as it includes multiple accessibility improvements
• Sites using JSON:API for file uploads
• Sites using Views with contextual filters on user roles
• Sites using Layout Builder

As this is a minor release, the upgrade process should be straightforward with minimal risk. However, as with any update, it's always recommended to test the update in a development or staging environment before applying it to your production site.

Bug Fixes

• Layout Builder: Fixed an issue where layout_builder_system_breadcrumb_alter wasn't checking for a null route object, which could cause errors in certain scenarios.

• JSON:API File Uploads: Resolved a critical issue where users couldn't upload files to the public file root through JSON:API, which was returning a 422 Unprocessable Entity error.

• Views Contextual Filters: Fixed a bug where the "allow multiple" option wasn't working correctly for user roles filters, improving the functionality of Views with multiple contextual filter values.

• HAL Links: Corrected broken HAL links in multisite or multi-domain setups where different domains, protocols, or ports are used.

• Email Link Formatting: Fixed an issue where links containing "@" were incorrectly converted into email addresses even without a domain suffix present.

• Media Embedding:

  • Fixed OembedMediaController to properly bubble cacheability metadata and attachments
  • Added proper content-type header to OEmbedIframeController::render

• CKEditor Issues: Resolved a JavaScript error that occurred with elements in "allowed HTML tags" that couldn't be direct descendants of a div element.

• Olivero Theme Fixes:

  • Fixed mobile search input in IE11 not visually responding to keypress
  • Corrected wide dropdown hover states that were broken
  • Fixed an issue where site branding text could be cut off on mobile when it spans two lines
  • Improved title wrapping around images in teasers

• Claro Theme: Fixed underlined text in CKEditor 5 not rendering as underlined in the Claro theme.

New Features

• Added new committers to MAINTAINERS.txt: ckrina, quietone, and bnjmnm have been added as provisional committers, expanding the core development team.

• Performance optimization for migrations: Added an index on source_ids_hash for migrate_message_* tables to improve migration performance and database query efficiency.

Security Updates

No specific security fixes were included in this release. However, keeping your Drupal installation up to date with the latest minor version is always recommended as a security best practice.

Performance Improvements

• Migration Performance: Added an index on source_ids_hash for migrate_message_* tables, which improves query performance during migrations, especially for sites with large amounts of migration data.

• ResourceTypeRepository Optimization: Simplified the ResourceTypeRepository control flow for returning cached data, making the code more efficient and easier to maintain.

Impact Summary

Drupal 9.2.7 is a minor release that focuses on accessibility improvements and bug fixes. The most significant impacts include:

1. Accessibility Enhancements: Multiple fixes in the Olivero theme improve color contrast and user experience for people using assistive technologies or with visual impairments. These changes help sites meet WCAG accessibility standards.

2. JSON:API File Upload Fix: Sites using JSON:API for file uploads will now be able to upload files to the public file root, resolving a critical functionality issue that was preventing proper file management.

3. Views Functionality: The fix for Views contextual filters with multiple values for user roles improves the flexibility and reliability of Views-based displays that filter content based on user roles.

4. Layout Builder Improvements: The fix for breadcrumb handling in Layout Builder ensures a more consistent user experience when navigating through the site building interface.

5. Developer Experience: Updates to PHPUnit test methods and improved code organization make the codebase more maintainable and compatible with newer testing frameworks.

Overall, this release enhances both the end-user experience through better accessibility and the developer experience through bug fixes and code improvements, without introducing any breaking changes.