WordPress Release: 6.8.1

TL;DR

WordPress 6.8.1 is a maintenance release that fixes several critical bugs affecting multisite installations, filesystem operations, block hooks, REST API behavior, and more. This update restores expected behaviors from previous versions that were inadvertently changed in 6.8, fixes fatal errors in specific configurations, and improves overall stability. Site administrators should update immediately to ensure proper functionality, especially those running multisite installations or using non-direct filesystem methods.

Highlight of the Release

• Fixed fatal error in multisite installations when using legacy file rewrites with SHORTINIT
• Restored proper filesystem credential handling during upgrades
• Fixed REST API behavior to ignore sticky posts by default (restoring pre-6.8 behavior)
• Added new filter for bulk action fields to improve compatibility with plugins
• Fixed issues with Block Hooks when used with Post Content wrapper blocks
• Improved SVG image handling to prevent unnecessary resize attempts

Migration Guide

WordPress 6.8.1 is a maintenance release focused on bug fixes and does not introduce any breaking changes that would require migration steps. The update primarily restores expected behaviors from previous versions that were inadvertently changed in 6.8.

If you were experiencing any of the specific issues mentioned in the bug fixes section, updating to 6.8.1 should resolve those problems without requiring additional configuration changes.

For developers who may have implemented workarounds for the REST API sticky posts behavior change in 6.8, note that 6.8.1 restores the pre-6.8 behavior (ignoring sticky posts by default).

Upgrade Recommendations

Immediate upgrade recommended for all WordPress 6.8 users.

This maintenance release fixes several critical bugs that could cause fatal errors or unexpected behavior in specific configurations. In particular:

• Multisite installations using legacy file rewrites should update immediately to prevent potential fatal errors
• Sites using non-direct filesystem methods for updates should update to fix potential fatal errors during upgrade processes
• Sites relying on the REST API posts endpoint behavior from WordPress 6.7 and earlier should update to restore the expected behavior

The update process follows the standard WordPress update procedure and should not cause any disruption to your site. As always, it's recommended to back up your site before performing any update.

Bug Fixes

Critical Bug Fixes

• Multisite Fatal Error Fix: Removed a call to the is_super_admin() function in ms-files.php as the function isn't available when using the SHORTINIT feature, preventing fatal errors on systems using file rewrites.

• Filesystem Credentials Fix: Fixed an issue in WP_Upgrader::maintenance_mode() where required credentials were not being passed to WP_Filesystem() when using non-direct filesystem methods, leading to fatal errors.

• Block Hooks Rendering Fix: Fixed an issue where hooked blocks marked for insertion before or after a Post Content block were causing garbled markup due to incorrect removal of block delimiters.

• REST API Behavior Restoration: Changed the posts endpoint to use ignore_sticky=true by default, restoring the pre-6.8 behavior where sticky posts were not included by default.

• Classic Editor Translation Fix: Fixed an issue where the 'Text' tab was renamed to 'Code' but 'Code' was already used as a key in the array of translatable text, potentially causing incorrect translations.

• Admin Bar Navigation Fix: Reverted a change to the "Edit Site" link in the admin bar, restoring its behavior to navigate to the current template rather than the top-level screen of the Site Editor.

• SVG Handling Improvement: Prevented unnecessary attempts to resize SVG images, recognizing their nature as scalable vector graphics.

• Bulk Action Validation Fix: Added a filter to allow modifying accepted bulk actions, fixing issues for sites that customize these actions.

New Features

New Filter for Bulk Actions

A new filter bulk_action_observer_ids has been added that allows modifying the actions accepted to fulfill validation rules. This helps sites that remove or change the default bulk actions to avoid failures due to missing required inputs.

Security Updates

• Filesystem Operations: Improved the handling of filesystem credentials during upgrade operations, ensuring proper initialization of filesystem connections and preventing potential security issues related to improper filesystem access.

Performance Improvements

• SVG Image Handling: Improved the handling of SVG images by preventing unnecessary resize attempts, which can save processing resources when working with vector graphics.

• Block Hooks Processing: Enhanced the Block Hooks algorithm to better handle specific block types, preventing unnecessary processing and potential markup issues.

Impact Summary

WordPress 6.8.1 is a critical maintenance release that addresses several important bugs introduced in WordPress 6.8. The most significant fixes include resolving fatal errors in multisite installations using legacy file rewrites, fixing filesystem credential handling during upgrades, restoring expected REST API behavior for sticky posts, and improving block hooks rendering.

This release primarily focuses on restoring expected behaviors and fixing compatibility issues rather than introducing new features. The changes ensure better compatibility with existing plugins and themes, particularly for sites with custom configurations or those using multisite installations.

The fixes for fatal errors in specific configurations are especially important for maintaining site stability and preventing downtime. The restoration of pre-6.8 behavior for the REST API posts endpoint will help maintain compatibility with existing code and plugins that rely on that behavior.

Overall, this release improves the stability, compatibility, and security of WordPress 6.8 installations without introducing any breaking changes.