WordPress Release: 5.0.2

TL;DR

WordPress 5.0.2 is a maintenance release that focuses on improving the block editor experience, fixing PHP 7.3 compatibility issues, and enhancing theme support for the block editor. This update includes numerous improvements to the Twenty Nineteen theme, fixes for custom color handling in bundled themes, and resolves several internationalization issues. The release also updates the WordPress packages to version 4.7.1 and addresses hierarchical post type display in the admin.

Highlight of the Release

• PHP 7.3 compatibility fixes for the compact() function
• Updated WordPress packages to version 4.7.1 for the block editor
• Numerous improvements to the Twenty Nineteen theme
• Fixed custom color handling in button blocks across bundled themes
• Improved internationalization support for JavaScript translations

Migration Guide

No specific migration steps are required for this release. WordPress 5.0.2 is a maintenance release that focuses on bug fixes and compatibility improvements.

If you're upgrading from WordPress 4.x to 5.x, please refer to the WordPress 5.0 documentation for guidance on transitioning to the block editor.

Upgrade Recommendations

WordPress 5.0.2 is recommended for all WordPress 5.0+ sites, especially for:

• Sites running on PHP 7.3 or planning to upgrade to PHP 7.3
• Sites using the block editor with custom themes
• International sites, particularly those installed in subdirectories
• Sites using the Twenty Nineteen theme or other bundled themes

This is a maintenance release that addresses several bugs and compatibility issues. The update process should be smooth and doesn't introduce any breaking changes.

Bug Fixes

PHP 7.3 Compatibility

Fixed notices related to the compact() function in PHP 7.3, which now issues an E_NOTICE level error if a passed string refers to an unset variable.

Theme Fixes

Twenty Nineteen

• Fixed gallery caption link color
• Removed left padding from pullquote blocks
• Fixed left/right-aligned pullquote spacing
• Fixed PHP warning related to Countable parameter
• Added missing text domain and escaping to comment author text
• Removed hyphens rule for cover image text
• Fixed center-aligned archive and category blocks
• Fixed image_filter theme option conditional function

Other Bundled Themes

• Fixed button block custom colors on the front end for Twenty Ten through Twenty Sixteen
• Fixed superscript and subscript display in Twenty Sixteen
• Corrected block editor font-size issue in Twenty Eleven
• Updated font-family for Simplified Chinese (zh_CN) in Twenty Seventeen
• Removed unnecessary ol styles from Twenty Seventeen editor
• Added focus style to cookies consent checkbox in Twenty Seventeen
• Removed editor style that prevented image resizing in Twenty Seventeen

Other Fixes

• Fixed hierarchical post type display in admin
• Fixed JavaScript translations for subdirectory installations
• Removed duplicate require_once() in WP_REST_Attachments_Controller::create_item()
• Fixed misplaced parenthesis when wp-tinymce-lists is added
• Updated default block appender selector in bundled themes
• Removed a deprecated notice from meta box compatibility functions

New Features

Block Editor Improvements

The WordPress packages for the block editor have been updated to version 4.7.1, which includes improvements to the following packages:

• @wordpress/[email protected]
• @wordpress/[email protected]
• @wordpress/[email protected]
• @wordpress/[email protected]

Internationalization Enhancements

• Added load_script_translations() as a wrapper for loading and filtering translation data for JavaScript files
• Introduced new filters for script translations:
  • pre_load_script_translations to short-circuit the function
  • load_script_translation_file to filter the file path
  • load_script_translations to filter the JSON-encoded translation data
• Added a filter for sites using CDNs to customize relative path resolution for translations

Security Updates

No significant security fixes were included in this release. This is primarily a maintenance and bug fix release focusing on compatibility, theme improvements, and block editor enhancements.

Performance Improvements

Performance Optimizations

• The Twenty Nineteen theme now prints the skip-link-focus-fix inline instead of enqueueing it as a blocking script, improving page load performance
• Fixed script loading for internationalization, which improves performance for sites using translations
• Removed duplicate code in the REST API attachments controller

Impact Summary

WordPress 5.0.2 is a maintenance release that improves the stability and compatibility of WordPress 5.0. The most significant changes include PHP 7.3 compatibility fixes, updates to the block editor packages, and numerous theme improvements.

For theme developers, this release fixes several issues with custom colors in button blocks across all bundled themes, ensuring that custom color selections properly override theme defaults. The Twenty Nineteen theme received substantial improvements to block styling and functionality.

For site administrators, the PHP 7.3 compatibility fixes address notices that would appear when using the latest version of PHP, and the hierarchical post type display in admin has been fixed.

For international users, the release improves JavaScript translations for sites installed in subdirectories and enhances font support for Simplified Chinese.

Overall, this release focuses on refinement and polish rather than introducing new features, making WordPress 5.0 more stable and reliable for all users.