Drupal Release: 8.0.2

TL;DR

Drupal 8.0.2 is a maintenance release that focuses primarily on documentation improvements, bug fixes, and code quality enhancements. This update addresses numerous documentation issues, fixes several critical bugs in Views, improves accessibility, resolves issues with entity references and translations, and enhances the stability of the migration system. While there are no major new features, this release significantly improves the developer experience and fixes several user-facing issues that were causing problems in the UI.

Highlight of the Release

• Fixed critical issues with Views functionality including exposed filters, table captions, and performance statistics
• Improved documentation across numerous APIs and modules with better PHPDoc comments and README files
• Enhanced accessibility with fixes for RTL support and form elements
• Resolved issues with entity references and translations
• Fixed color scheme configuration issues that affected cached pages

Migration Guide

Drupal 8.0.2 is a maintenance release with bug fixes and documentation improvements. No specific migration steps are required when upgrading from Drupal 8.0.1 to 8.0.2.

However, if you've been experiencing any of the fixed issues, you may want to review your site after upgrading:

1. If you're using Views with exposed filters, check that they now work correctly
2. If you've customized theme logo settings, verify they're still working properly
3. If you're using entity references, verify that entity translations display correctly
4. If you've implemented custom migrations, test them thoroughly as several migration-related fixes were included

No database updates are required for this release.

Upgrade Recommendations

It is recommended to upgrade to Drupal 8.0.2 as soon as possible, especially if you're experiencing any of the issues fixed in this release. This is a maintenance release that focuses on bug fixes and documentation improvements, so the risk of upgrade issues is minimal.

The upgrade process from 8.0.1 to 8.0.2 should be straightforward:

1. Back up your database and code
2. Put your site into maintenance mode
3. Update your Drupal core codebase to 8.0.2
4. Run update.php
5. Take your site out of maintenance mode
6. Clear caches

This release fixes several important bugs related to Views, entity references, theme settings, and migrations, so sites using these features will benefit significantly from the upgrade.

Bug Fixes

Views

• Fixed Views Messages area handler that was broken when added to a view
• Fixed "Hide empty column" functionality that was only hiding the header
• Fixed database exceptions for Views with combined field filters
• Fixed Views performance statistics display
• Fixed missing caption when views (format table) are grouped by a field
• Fixed exposed form state not being saved when placed in a block
• Fixed missing labels and descriptions for exposed numeric filters when using 'between' filter
• Fixed default option <Any> not being set in exposed filters when terms are selected
• Fixed issue when adding a tag to a View

Entity and Field System

• Fixed entity reference widgets not displaying entity translations
• Fixed PHP notice for single value image field configured with a default image and hidden label
• Fixed fatal error when calling getFieldStorageDefinition() on certain entities
• Fixed issue with ConfigEntityBundleBase not clearing bundle cache when updating a bundle
• Fixed breadcrumb navigation on taxonomy term pages (now shows term name instead of ID)

UI and Theming

• Fixed color scheme configuration changes not being reflected in cached pages
• Fixed locks not being visible when locking colors together
• Fixed theme logo upload settings that were broken and could result in data loss
• Fixed theme logo upload settings being shown even when file module is not installed
• Fixed JavaScript error in Firefox in node edit form when UID field is not visible
• Fixed issue with removing caption from a previously captioned image
• Fixed incorrect padding for tags in RTL languages

Migration System

• Fixed menu links parent migration
• Fixed D6/D7 actions table migration
• Fixed user settings migration constants alignment
• Added schema for migration process plugins

Other

• Fixed exception when deleting a translation when there is no canonical link template
• Fixed infinite loop in ConfigurableLanguageManager->getLanguages() on language config entities import
• Fixed issue where deleting a view did not rebuild routes
• Fixed states collapsed/open/closed not working for <details> elements
• Fixed issue with CKEditor alignment buttons being usable even when align filter is disabled
• Fixed contexts not being mapped in time for BlockInterface::access()
• Fixed AJAX progress throbber URL in dialog.css

New Features

This maintenance release focuses primarily on bug fixes and documentation improvements rather than introducing new features. However, there are some minor enhancements:

• Added link to settings page for automated cron on modules overview page
• Added README.txt files to Stable and Classy themes to better explain their purpose
• Added interface for MigrateTemplateStorage and MigrationBuilder to improve API consistency
• Enhanced documentation for plugin systems and API functionality

Security Updates

While this release doesn't contain major security fixes, it does include some improvements related to security:

• Fixed Twig sandbox policy to whitelist instances instead of specific classes, improving the security of the templating system
• Improved documentation for various APIs, which helps developers implement more secure code
• Enhanced error handling in several components, reducing the risk of exposing sensitive information

Performance Improvements

This release includes a few performance-related improvements:

• Fixed Views performance statistics display, which now properly shows execution time and query information
• Improved route rebuilding when deleting views, which prevents potential performance issues
• Enhanced context mapping timing for BlockInterface::access(), which improves block rendering performance
• Fixed caching issues with color scheme configurations, ensuring proper cache invalidation

Impact Summary

Drupal 8.0.2 is a maintenance release that primarily addresses documentation improvements and bug fixes across various components of Drupal core. The most significant improvements are in the Views module, where several critical issues have been fixed including problems with exposed filters, table captions, and performance statistics display.

For developers, this release brings substantial documentation enhancements with improved PHPDoc comments, better README files for themes, and clearer API documentation. The migration system has been stabilized with fixes for menu links parent migration and D6/D7 actions table migration.

Content editors will benefit from fixes to the CKEditor (particularly with alignment buttons and image captions) and improvements to the Views UI. Site administrators will see improved breadcrumb navigation on taxonomy term pages and fixed theme logo upload settings.

While there are no major new features, this release significantly improves the stability and usability of Drupal 8, making it an important update for all Drupal 8 sites. The fixes for color scheme configuration in cached pages and entity reference translations address particularly frustrating issues that affected many sites.