WordPress Release: 5.2.1

TL;DR

WordPress 5.2.1 is a maintenance release that addresses 35 bugs from the previous version. This update includes important fixes for the new Site Health feature, accessibility improvements, UI enhancements for mobile screens, and critical updates to core libraries like jQuery and TinyMCE. The release also improves error handling for PHP version incompatibilities and optimizes performance on 32-bit systems.

Highlight of the Release

• Fixed Site Health tool UI and functionality issues
• Improved responsive design for better mobile experience
• Updated core libraries including jQuery and TinyMCE
• Enhanced accessibility with aria attributes and better skip links
• Optimized performance on 32-bit systems

Migration Guide

No specific migration steps are required for this maintenance release. WordPress 5.2.1 is a bug fix release that should be compatible with all themes and plugins that work with WordPress 5.2.0.

If you're upgrading from an earlier version than 5.2.0, please refer to the WordPress 5.2 release notes for important changes that might affect your site.

Upgrade Recommendations

This is a maintenance release that addresses 35 bugs from WordPress 5.2.0. It's recommended that all WordPress sites running version 5.2.0 update to 5.2.1 as soon as possible.

The update includes important fixes for:

• Site Health functionality
• Mobile UI improvements
• Accessibility enhancements
• Core library updates (jQuery and TinyMCE)
• Performance optimizations for 32-bit systems

There are no known compatibility issues with this release, making it a safe and recommended upgrade for all WordPress sites.

Bug Fixes

Site Health Improvements

• Fixed link to plugin update screen in multisite installations
• Improved vertical alignment of icons in test result descriptions
• Enhanced alignment and spacing for section headers
• Fixed HTTP requests test to properly check WP_HTTP_BLOCK_EXTERNAL constant value
• Improved translation handling for PHP modules test descriptions
• Fixed singular string usage for plugin and theme version tests

UI and Responsive Design Fixes

• Prevented cards on the Tools page from overflowing on small screens
• Fixed menu actions alignment on mobile devices
• Prevented email field for personal data requests from overflowing
• Improved "skip links" position for medium and small screens

Core Libraries and Components

• Removed duplicate font-face declaration in Dashicons CSS
• Updated TinyMCE to version 4.9.4
• Fixed jQuery by bringing jquery.js back into WordPress SVN repo with security patch
• Updated Block Editor WordPress packages to latest versions
• Fixed wp_targeted_link_rel() to preserve JSON format and use correct quotes
• Fixed deletion of media files on Windows systems

Error Handling and System Compatibility

• Prevented PHP errors when a drop-in triggers fatal error protection
• Improved error messages for WordPress updates failing due to PHP incompatibility
• Updated sodium_compat to v1.10.0 and optimized for slow 32-bit systems
• Added non-zero exit code in PHP/MySQL version checks for better automated testing

Accessibility Enhancements

• Added aria-current to navigation links
• Fixed search form accessibility in backward compatibility code
• Improved skip links positioning on smaller screens

Other Fixes

• Restored WordPress version placeholder in tagline on About, Credits, and Freedoms pages
• Fixed feed's <lastBuildDate> to ensure correct date

New Features

No significant new features were introduced in this maintenance release. WordPress 5.2.1 focuses on bug fixes and improvements to existing functionality, particularly enhancing the Site Health feature introduced in 5.2.0.

Security Updates

This maintenance release includes an important security update to jQuery by bringing jquery.js back into the WordPress SVN repository with backported security patches from version 3.4.0. While not explicitly labeled as a security release, this update helps protect against potential vulnerabilities in the jQuery library.

Performance Improvements

Performance Optimizations

• 32-bit System Improvements: The sodium_compat library has been updated to version 1.10.0, which includes a new runtime_speed_test() method. This allows WordPress to detect slow 32-bit systems and skip signature verification operations that might cause timeouts during updates.

• Dashicons Optimization: Removed duplicate font-face declaration in Dashicons CSS, which was causing console warnings in some browsers and potentially affecting performance.

• Block Editor Package Updates: Multiple WordPress packages for the Block Editor have been updated to their latest versions, which include various performance improvements and optimizations.

Impact Summary

WordPress 5.2.1 is primarily a bug fix release that enhances stability and user experience. The most significant improvements focus on the Site Health feature introduced in 5.2.0, with multiple UI and functionality fixes that make it more reliable and user-friendly.

The update to core libraries like jQuery and TinyMCE improves security and stability. For developers, fixes to functions like wp_targeted_link_rel() and better error handling for drop-ins will improve code reliability.

Mobile users will benefit from numerous responsive design fixes, including better Tools page display, menu actions alignment, and improved skip links positioning. Users with accessibility needs will appreciate the addition of aria attributes and other accessibility enhancements.

Site administrators on 32-bit systems will see improved performance during updates thanks to optimizations in the sodium_compat library that prevent timeouts during signature verification.

Overall, this release represents an important maintenance update that refines the features introduced in WordPress 5.2.0 without introducing breaking changes.