Drupal Release: 8.8.2

TL;DR

Drupal 8.8.2 is a maintenance release that addresses numerous bugs and issues from the previous version. This update includes important fixes for workspaces, layout builder, migration systems, and various UI improvements. It resolves critical issues like PHP 7.4 compatibility problems, workspace drawer styling, and layout builder section editing. The release focuses on stability and bug fixes rather than introducing new features, making it an important update for sites currently running Drupal 8.8.1.

Highlight of the Release

• Fixed layout builder issue preventing users from deleting or editing blocks placed in sections
• Improved workspace drawer CSS and toolbar UI for better consistency across desktop and mobile
• Added support for PostgreSQL 12
• Resolved PHP 7.4 compatibility issues
• Fixed migration issues with Drupal 7 date fields and filters
• Improved error messages when entity loading fails

Migration Guide

This is a maintenance release that focuses on bug fixes rather than introducing breaking changes. Most sites can be updated directly without any special steps beyond the normal update procedure:

1. Back up your database and site files
2. Put the site into maintenance mode
3. Update Drupal core codebase
4. Run the update script by navigating to /update.php
5. Take the site out of maintenance mode

Special Considerations:

• PHP 7.4 Users: If you're running PHP 7.4, this update is particularly important as it fixes compatibility issues with this PHP version.

• PostgreSQL 12 Users: This release adds support for PostgreSQL 12. If you're planning to upgrade your database to PostgreSQL 12, you should update to Drupal 8.8.2 first.

• Workspaces: If you're using the Workspaces module, this update includes several important fixes. After updating, you may notice UI improvements in the workspace toolbar and drawer.

• Layout Builder: If you've experienced issues with deleting or editing blocks in layout builder sections, this update should resolve those problems without requiring any additional steps.

Upgrade Recommendations

Priority: Medium

This release contains numerous bug fixes and improvements that enhance stability and compatibility. While it doesn't address critical security vulnerabilities, it does fix several important functional issues that could impact site operation.

Who should upgrade immediately:

• Sites experiencing any of the specific issues fixed in this release, particularly problems with Layout Builder, Workspaces, or migrations
• Sites running on PHP 7.4, as this release fixes compatibility issues
• Sites planning to use PostgreSQL 12
• Sites experiencing issues with constraint validation or error handling

Upgrade timeline recommendation:

• Production sites: Plan to upgrade within the next 2-4 weeks during a regular maintenance window
• Development sites: Upgrade at your earliest convenience to ensure development environment matches future production environment

The update process follows the standard Drupal minor version update procedure and should be relatively straightforward for most sites.

Bug Fixes

This release includes numerous bug fixes:

• Layout Builder: Fixed issue preventing users from deleting or editing blocks placed in layout builder sections.

• Workspaces:

  • Fixed CSS issues in the workspace drawer for better consistency
  • Workspaces now only alter non-deprecated path_alias services
  • Fixed hard-coded URI string in WorkflowListBuilder that broke installations in subfolders

• PHP 7.4 Compatibility:

  • Fixed deprecated reverse order of parameters in implode()
  • Fixed deprecated curly brace syntax for accessing array elements

• Migration System:

  • Fixed issues with Drupal 7 date fields that don't collect hour/minute/second granularities
  • Fixed migration filters that are replaced with filter_null
  • Fixed d7_node_title_label migration plugin incorrectly generating base_field_override
  • Fixed Default Value Migration Process plugin unexpected behavior when updating list fields from D7 to D8
  • Fixed getHighestId() failing when destination ID has type string

• Views:

  • Fixed numerical machine names creating problems in view filters
  • Fixed missing views attachments for some display machine names
  • Fixed views bulk forms performing redirects to confirmation pages for unauthorized users

• UI/UX Issues:

  • Fixed multi-select list items "escaping" bounding box in Off-Canvas Forms
  • Fixed double-escaping of special characters in exposed sort labels
  • Fixed default link button styles
  • Removed transition from CKEditor border-color for better performance

• Core System:

  • Fixed "Class 'Drupal\Core\Controller\ArgumentResolver\RawParameterValueResolver' not found" error during update to 8.8.0
  • Fixed reusing initialized constraint validators overwriting validation errors
  • Fixed error backtrace malformatting
  • Fixed undefined index issues in various components

• Media:

  • Fixed "Convert line breaks into HTML" filter to exclude <drupal-media> tag
  • Fixed EditorMediaDialog triggering "undefined index" notice for data-view-mode

New Features

This release is primarily focused on bug fixes and improvements rather than new features. However, there are some notable enhancements:

• PostgreSQL 12 Support: Added compatibility with PostgreSQL 12, expanding database options for Drupal installations.
• Improved Workspace UI: Enhanced workspace toolbar UI for both desktop and mobile devices, providing a more consistent and user-friendly experience.
• Better Error Messages: Entity loading failures now include the entity type in error messages, making debugging easier.
• Media Library Styles: Copied media library styles from Seven theme to Claro theme for better consistency.

Security Updates

This release does not contain any documented security fixes. However, keeping your Drupal installation up-to-date with the latest version is always recommended as a security best practice, as it ensures you have all the latest patches and improvements.

Performance Improvements

While this release is primarily focused on bug fixes, there are a few performance-related improvements:

• CKEditor Optimization: Removed transition from CKEditor border-color, which improves rendering performance.

• Migration Performance: Several migration-related fixes that improve the efficiency of the migration process, particularly for date fields and filters.

• Constraint Validation: Fixed an issue where reusing initialized constraint validators was overwriting validation errors, which could lead to performance degradation in form submissions with multiple validations.

• Caching Improvement: Fixed an issue where Datetime::getInfo() was caching the user's timezone causing unpredictable timestamps, which improves the reliability of datetime handling.

Impact Summary

Drupal 8.8.2 is a maintenance release that addresses approximately 70 bugs and issues from the previous version. The update focuses on stability improvements rather than new features, making it an important but not urgent update for most sites.

Key improvements include fixes for Layout Builder functionality, Workspace UI enhancements, PHP 7.4 compatibility, PostgreSQL 12 support, and numerous migration system improvements. The release also addresses several UI/UX issues, particularly in the admin interface and form handling.

For site administrators, the most noticeable changes will be the improved workspace toolbar UI and the ability to properly delete or edit blocks placed in layout builder sections. Developers will benefit from better error messages, fixed migration tools, and improved compatibility with newer PHP and database versions.

This update represents a solid maintenance release that resolves many pain points reported by the community. While it doesn't introduce major new functionality, the bug fixes and improvements enhance the overall stability and usability of Drupal 8.8.x.