Drupal Release: 9.2.8

TL;DR

Drupal 9.2.8: Accessibility Improvements, Bug Fixes, and Migration Enhancements

This maintenance release for Drupal 9.2.x focuses on accessibility improvements in the Olivero theme, fixes several critical bugs affecting user management and content display, and enhances migration functionality. Key improvements include fixing race conditions, addressing accessibility issues in the Olivero theme, resolving JSON:API user deletion problems, and fixing various migration-related bugs. This release is recommended for all Drupal 9.2.x sites to ensure proper functionality and improved accessibility.

Highlight of the Release

• Fixed accessibility issues in Olivero theme for better support of high contrast and forced-colors modes
• Resolved JSON:API user deletion to properly follow site-wide cancellation method settings
• Fixed CSS aggregation issues with various @import rules
• Improved menu editing user experience that had regressed in previous versions
• Multiple migration-related fixes for entity references, term translations, and CCK fields

Migration Guide

No specific migration guide is needed for this maintenance release. This is a bugfix release that maintains backward compatibility with Drupal 9.2.x.

If you're upgrading from Drupal 9.2.7 to 9.2.8, follow the standard update procedure:

1. Back up your database and site files
2. Put your site into maintenance mode
3. Update your codebase to use Drupal 9.2.8
4. Run the database updates by visiting /update.php or using Drush: drush updatedb
5. Clear caches: drush cache:rebuild or via the admin interface
6. Take your site out of maintenance mode

No special steps are required for this particular update.

Upgrade Recommendations

Priority: Medium

This update is recommended for all sites running Drupal 9.2.x, especially those that:

• Use the Olivero theme and need improved accessibility
• Utilize JSON:API for user management
• Rely on CSS aggregation with complex @import rules
• Use Layout Builder with reusable content blocks
• Perform migrations from Drupal 7
• Have multilingual content with alternate hreflang links

While this release doesn't contain critical security fixes, it addresses several important bugs that could affect site functionality and user experience. Sites should plan to upgrade to this version at their earliest convenience.

For long-term planning, note that Drupal 9.2.x will reach end-of-life when Drupal 9.4.0 is released. Consider planning your upgrade path to newer Drupal versions accordingly.

Bug Fixes

Core Functionality

• Fixed race condition in public://simpletest mkdir call (#3192365)
• Fixed JSON:API user deletion to follow site-wide cancel_method settings (#3228000)
• Fixed vertical tabs with #parents in Claro theme (#3219340)
• Fixed CSS aggregation failures with various @import rules (#2936067)
• Fixed TypeError in _editor_get_file_uuids_by_field() function (#2974156)
• Fixed toolbar menu theme override omitting 'menu_name' variable (#3227370)
• Fixed LogMessageParser breaking messages containing braces (#2909805)
• Fixed PHP errors when overriding query settings (#3231861)
• Fixed contextual links display for reusable content blocks in Layout Builder (#3020876)
• Fixed machine name field throwing notices if placed before source field (#990218)
• Fixed regression in menu editing user experience (#2957953)
• Fixed text format creation issue causing JavaScript errors (#2763075)
• Fixed HtmlHeadLink processing to allow duplicated alternate hreflang links (#2945033)

Olivero Theme Accessibility

• Fixed primary nav search icon visibility in forced-colors mode in MS Edge (#3223281)
• Improved select dropdown icons contrast in Windows High Contrast mode (#3223271)
• Fixed insufficient contrast on fieldset elements (#3242456)
• Fixed insufficient contrast on inactive vertical form labels (#3242469)
• Fixed z-index issue with the search bar (#3212670)

Migration System

• Fixed MigrateException in d7_language_content_comment_settings when source bundle is too long (#3219140)
• Fixed EntityReferenceTranslationDeriver process pipeline (#3199578)
• Fixed TermTranslation query and added missing source plugin test (#3187616)
• Fixed FieldLink process plugin treating protocol-relative external URLs as internal (#3232681)
• Fixed text_plain field formatter mapping to basic_string for long text fields (#3088917)
• Fixed migration of nodes with CCK nodereferrer fields (#2784783)
• Fixed source plugin documentation (#3225227)
• Added media_requirements() reporting for missing source fields (#3205866)

Other Fixes

• Fixed OEmbedWidget to display the field's help text (#3208849)
• Fixed Claro theme compatibility with Themable Forms module (#3203745)
• Updated EntityQueryAggregateTest to make it pass for SQL Server (#3244156)
• Fixed file mode for scaffold fixture script (#3241318)

New Features

No significant new features were added in this maintenance release. This update focuses primarily on bug fixes, accessibility improvements, and enhancing existing functionality.

Security Updates

While this release doesn't contain explicit security fixes labeled as such, it does include improvements that enhance security posture:

• Fixed race condition in public://simpletest mkdir call (#3192365), which could potentially have security implications in certain environments
• Fixed JSON:API user deletion to follow site-wide cancel_method settings (#3228000), ensuring consistent and secure user data handling

Performance Improvements

This release does not include specific performance improvements as its primary focus. However, fixing the CSS aggregation issues with various @import rules (#2936067) may indirectly improve frontend performance for sites using complex CSS import patterns.

Impact Summary

Drupal 9.2.8 is a maintenance release that addresses 33 issues across various components of Drupal core. The most significant impacts include:

1. Accessibility Improvements: Multiple fixes in the Olivero theme enhance the experience for users with disabilities, particularly those using high contrast modes or screen readers.

2. User Management: The fix for JSON:API user deletion ensures that site-wide user cancellation policies are consistently applied regardless of the API used, maintaining data integrity and security.

3. Frontend Rendering: Fixes to CSS aggregation with @import rules prevent potential styling issues, while improvements to contextual links in Layout Builder enhance the content editing experience.

4. Migration Stability: Several fixes to migration plugins and processes improve the reliability of content migrations, especially for sites with complex content structures or multilingual content.

5. Admin Experience: The fix for menu editing regression restores expected functionality for site administrators, and vertical tabs fixes in Claro improve the content editing interface.

This release demonstrates Drupal's commitment to accessibility, stability, and backward compatibility while addressing important bugs that affect real-world usage scenarios. The changes are focused on maintaining and improving existing functionality rather than introducing new features.