Drupal Release: 10.0.9

TL;DR

Drupal 10.0.9 is a maintenance release that includes numerous bug fixes, accessibility improvements, and performance enhancements. This update addresses issues with media handling, database operations, UI/UX improvements in the Claro admin theme, and fixes for PHP 8.1 deprecation notices. Key improvements include fixes for language negotiation, contextual links, layout builder stability, and media thumbnail handling. This release is recommended for all Drupal 10 sites to ensure stability and security.

Highlight of the Release

• Fixed media thumbnail field formatter loading behavior
• Improved accessibility for language switcher links and secondary tabs
• Enhanced CKEditor 5 display in off-canvas sidebar
• Fixed PostgreSQL schema support for unique indexes
• Addressed PHP 8.1 deprecation notices
• Improved error handling in language negotiation
• Enhanced mobile menu positioning and UI elements in Claro theme

Migration Guide

No specific migration steps are required for this maintenance release. This is a standard bug fix release that should not require any special migration procedures when updating from Drupal 10.0.8 to 10.0.9.

However, as with any update, it's recommended to:

1. Back up your database and files before updating
2. Test the update on a staging environment first
3. Run update.php after deploying the new code
4. Clear caches after the update is complete

Upgrade Recommendations

This update is recommended for all Drupal 10 sites. As a maintenance release containing numerous bug fixes and improvements, Drupal 10.0.9 enhances stability, accessibility, and performance without introducing breaking changes.

The update addresses several issues that could affect site functionality, particularly for sites using:

• Media fields and thumbnails
• Layout Builder
• CKEditor 5
• PostgreSQL databases
• Sites with complex language negotiation

Priority: Medium Complexity: Low (standard update procedure)

To update:

1. Use Composer: composer require drupal/core-recommended:10.0.9 --update-with-dependencies
2. Run database updates: drush updatedb or visit /update.php
3. Clear caches: drush cache:rebuild or via the admin UI

As always, perform the update in a staging environment first to ensure compatibility with your site's specific configuration and custom code.

Bug Fixes

Media and File Handling

• Fixed issue where setting media field to loading="eager" doesn't work when using the media_thumbnail field formatter
• Fixed duplicated summary item when linking to content with the MediaThumbnailFormatter
• Improved handling of invalid input in time zone abbreviation to TZID route
• Fixed handling of .m4a files to use audio/mp4 MIME type instead of audio/mpeg

Database and Schema

• Fixed incorrect totals count when importing config that contains a theme uninstall
• Improved query optimization in DatabaseBackend::garbageCollection()
• Fixed handling of empty options lists in ListItemBase::generateSampleValue()

UI/UX and Accessibility

• Fixed inaccessible language switcher links
• Fixed required summary element hidden when other text-with-summary fields do not require summary
• Improved CKEditor 5 content display in off-canvas sidebar
• Fixed mobile menu positioning when side canvas is open
• Fixed secondary tabs accessibility when there are many tabs
• Fixed dropbutton white line appearance at various zoom settings
• Fixed "Add or select media" translation issues
• Improved preview usability
• Fixed Claro theme issues with H3 elements in status report
• Fixed wrong background for active vertical tab in Claro theme
• Fixed select form field values hidden at narrow screen widths in Claro theme
• Fixed vertical tab focus on form validation

PHP and Compatibility

• Fixed DateTime::__construct() deprecation with null parameters
• Addressed deprecations for PHP 8.1 get_class() and get_called_class() without argument
• Added deprecation silencer on Drupal 10.0

Layout and Forms

• Fixed contextual links not sorted by weight
• Fixed readonly attribute not working with #States
• Fixed library order asset weights with large number of JavaScript files
• Fixed XSS filtering for datetime attribute
• Fixed validation messages not showing for views exposed filters with AJAX enabled

New Features

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

Security Updates

This release does not contain any specific security fixes. For security-related updates, users should always refer to the official Drupal Security Advisories.

Performance Improvements

Query Optimization

• Improved query efficiency in DatabaseBackend::garbageCollection() to optimize garbage collection processes

Asset Loading

• Fixed htaccess rewrite rules for gzipped CSS and JavaScript aggregates to ensure proper caching and delivery
• Improved library order asset weights handling when a large number of JavaScript files are loaded between jQuery UI libraries

JavaScript Optimization

• Refactored uses of jQuery ready function to use VanillaJS for better performance
• Updated webpack for improved build performance

Impact Summary

Drupal 10.0.9 is a maintenance release that brings significant improvements to stability, accessibility, and user experience. The update addresses several key areas:

For site builders and administrators, the release fixes issues with media handling, particularly with thumbnail field formatters and loading attributes. Language switcher accessibility has been improved, and configuration import processes are more reliable.

Developers will benefit from fixes to PostgreSQL schema handling, better error handling in language negotiation, and addressing of PHP 8.1 deprecation notices. Documentation improvements for hook_update_N() numbering provide clearer guidance for module development.

Content editors will experience better usability with fixes to CKEditor 5 in off-canvas sidebars, improved handling of required summary elements, and enhanced preview functionality.

End users will notice improved accessibility throughout the site, particularly with language switchers and secondary tabs navigation. Mobile menu positioning has been fixed, and form validation feedback is more reliable.

Overall, this release enhances Drupal 10's stability and user experience without introducing breaking changes, making it a recommended update for all Drupal 10 sites.