Drupal Release: 9.2.1

TL;DR

Drupal 9.2.1 is a maintenance release that includes numerous bug fixes, documentation improvements, and theme enhancements, particularly for the Olivero theme. This release addresses issues with migrations, test assertions, media embedding, help topics, and various UI/UX improvements. It focuses on code quality, accessibility, and developer experience without introducing breaking changes.

Highlight of the Release

• Fixed media embedding to prevent authors from choosing view modes not enabled for specific media types
• Improved Olivero theme with numerous UI/UX enhancements and better mobile support
• Enhanced migration functionality with fixes for field values sorting and source plugins
• Converted multiple module help sections to the new help topics system
• Fixed Layout Builder issue that caused fatal errors when adding SystemMainBlock

Migration Guide

No specific migration guide is needed for this release as it doesn't contain breaking changes that would require migration steps. This is a maintenance release that fixes bugs and improves existing functionality without introducing backward compatibility issues.

For users upgrading from Drupal 7, several migration-related fixes were included that improve the migration process:

• Fixed D7 migration database fixture to follow documentation (Issue #3213621)
• Fixed FieldableEntity::getFieldValues() to properly sort returned field values by delta (Issue #3164520)
• Fixed MigrationLookup plugin that incorrectly overrode source values for multiple migrations (Issue #3196583)
• Added bundle to sourceIDs for FieldOptionTranslation source plugin (Issue #3103031)

Upgrade Recommendations

This is a minor maintenance release (9.2.0 → 9.2.1) that contains bug fixes and improvements without introducing breaking changes. It is recommended that all sites running Drupal 9.2.0 upgrade to this version to benefit from the numerous bug fixes and enhancements.

The upgrade process should be straightforward:

1. Create a complete backup of your site's files and database
2. Update your codebase to Drupal 9.2.1 using Composer:

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

3. Run database updates:

   drush updatedb
   

4. Clear caches:

   drush cache:rebuild
   

This release is particularly important for sites using:

• The Olivero theme (numerous UI/UX fixes)
• Media embedding functionality
• Layout Builder
• Migration tools from Drupal 7
• Help topics module

Bug Fixes

• Media Embedding: Fixed issue where authors could choose view modes not enabled for specific media types (Issue #3097416)
• Layout Builder: Fixed fatal error when adding SystemMainBlock to a layout builder layout (Issue #3218766)
• Syndication: Corrected syndicate block output that was generating wrong feed URLs (Issue #3048848)
• Migration:
  • Fixed FieldableEntity::getFieldValues() to properly sort returned field values by delta (Issue #3164520)
  • Fixed MigrationLookup plugin that incorrectly overrode source values for multiple migrations (Issue #3196583)
  • Added bundle to sourceIDs for FieldOptionTranslation source plugin (Issue #3103031)
• Help Topics: Fixed issue where help_topics module could break during module uninstall (Issue #3218660)
• Testing:
  • Fixed random test failures due to drupal-settings-json being counted as page text (Issue #3175718)
  • Fixed OEmbed ProviderRepositoryTest not interacting with Guzzle's API correctly (Issue #3220450)
  • Fixed SIMPLETEST_BASE_URL validation to properly check scheme (Issue #3217374)
• Views: Fixed SQL error that occurred when using Views table format sorting with distinct results on some database engines (Issue #3195178)
• Olivero Theme:
  • Fixed mobile sub-navigation menus offset issue (Issue #3213118)
  • Fixed blockquote overflow into sidebar (Issue #3210902)
  • Fixed profile picture and comments alignment in IE11 (Issue #3212702)
  • Fixed focus state outline being cut off in IE11 (Issue #3212700)
  • Fixed inconsistent offset on close button within messages (Issue #3211613)
  • Fixed message icon border radius in Firefox (Issue #3214140)
  • Fixed primary navigation toggle button vertical alignment below 1200px resolution (Issue #3212073)
  • Fixed tags label and items misalignment on mobile screens (Issue #3211907)

New Features

No significant new features were introduced in this maintenance release. This is primarily a bug fix and enhancement release that improves existing functionality rather than adding new features.

Security Updates

No security fixes were explicitly mentioned in this release. This appears to be a maintenance release focused on bug fixes, documentation improvements, and UI enhancements rather than security issues.

Performance Improvements

No significant performance improvements were explicitly mentioned in the release notes. The changes in this release are primarily focused on bug fixes, documentation improvements, and UI enhancements rather than performance optimizations.

Impact Summary

Drupal 9.2.1 is a maintenance release that focuses on bug fixes, documentation improvements, and UI enhancements without introducing breaking changes. The most significant improvements are in the Olivero theme, with numerous fixes for mobile navigation, accessibility, and cross-browser compatibility issues.

Key impacts include:

1. Better media embedding: Authors can no longer select view modes that aren't enabled for specific media types, preventing potential display issues.

2. Enhanced Olivero theme: Multiple UI/UX improvements make the theme more robust across different browsers and devices, with special attention to mobile navigation and accessibility.

3. Improved migration tools: Several fixes to migration plugins and processes make Drupal 7 to Drupal 9 migrations more reliable.

4. Layout Builder stability: Fixed a critical issue that caused fatal errors when adding SystemMainBlock to layouts.

5. Better developer experience: Improved documentation, fixed test assertions, and updated coding standards enhance the developer experience.

This release demonstrates Drupal's commitment to quality, accessibility, and user experience through incremental improvements rather than major feature additions.