Drupal Release: 5.0-beta-2

TL;DR

Drupal 5.0-beta-2 brings significant improvements over beta-1 with numerous bug fixes, usability enhancements, and API refinements. This release focuses on stabilizing core functionality, improving the administration interface, and addressing session handling issues. Key updates include jQuery upgrade to 1.0.3, enhanced block administration, improved module management, and better theme handling. This beta represents an important step toward the final 5.0 release, with particular attention to security, performance, and developer experience.

Highlight of the Release

• jQuery updated to version 1.0.3 with verified JS functionality
• Enhanced block administration interface for better usability
• Improved module management page now displays version numbers
• New 'select all' and range select features for administrative tables
• Better session handling for improved compatibility with various server configurations
• Added sites/all directory structure for better organization of contributed modules and themes
• Fixed book module database updating issues
• Improved Garland theme with header region and secondary tabs display

Migration Guide

Upgrading from 5.0-beta-1 to 5.0-beta-2

1. Backup Your Site

   • Create a complete backup of your database and files before upgrading.

2. Update Your Files

   • Replace all Drupal core files with the new 5.0-beta-2 files.
   • Keep your sites directory intact, especially your settings.php file.

3. Run update.php

   • Navigate to http://yoursite.com/update.php and follow the instructions to update the database schema.

4. Check Module Compatibility

   • Some API changes may affect contributed modules. Test all functionality after upgrading.
   • The new hook for content type changes may require updates to modules that interact with content types.

5. Theme Considerations

   • If using Garland with color module, you may need to resave your colors to clear the CSS cache (#92372).
   • Check custom themes for compatibility with the new header region in Garland.

6. Directory Structure Changes

   • The new sites/all directory is now available for contributed modules and themes.
   • Consider moving contributed modules from sites/default/modules to sites/all/modules for better organization.

7. Session Handling

   • If you were experiencing session-related issues, this release includes several fixes that may resolve them.
   • Test user login and session persistence thoroughly after upgrading.

8. Clear Caches

   • Clear all caches after upgrading to ensure all changes take effect.

Upgrade Recommendations

For Drupal 5.0-beta-1 Users

We strongly recommend upgrading to Drupal 5.0-beta-2 as it contains numerous bug fixes, security improvements, and performance enhancements. This beta release significantly improves stability and addresses many issues reported in beta-1.

For Drupal 4.7.x Users

If you're running a production site on Drupal 4.7.x, we recommend waiting for the final 5.0 release before upgrading. However, if you're planning to upgrade to Drupal 5.0 eventually, now is a good time to set up a test environment with 5.0-beta-2 to identify potential migration issues and prepare for the final release.

For Developers

Developers building sites or modules for Drupal 5.0 should update immediately to ensure compatibility with the latest API changes and to take advantage of the new features and improvements in this release.

Testing Recommendation

This is still a beta release and not recommended for production sites. Test thoroughly in a development environment before considering deployment to production.

Bug Fixes

• Session Handling: Fixed handling of expired sessions (#91046) and improved session handling for FastCGI setups (#93204).

• Book Module: Fixed book outline saving (#90395) and corrected database updating issues (#93678).

• Theme Issues: Fixed Garland theme not displaying secondary tabs when color module is off (#92365) and resolved broken Garland logo when using subdirectories (#92696).

• Path Handling: Fixed issues with path aliases (#98293) and increased URL length limit to match the de facto standard of 2048 characters (#98551).

• Form Handling: Fixed radio buttons to always have something selected (#92936) and corrected validation of paths with query strings.

• Menu Management: Fixed menu item expanded attribute saving (#48178) and prevented local task interference when adding menu items (#72674).

• User Management: Fixed variable substitution in administrator notification of pending accounts (#85358) and corrected validation of role names to prevent duplicates (#41293).

• Content Type Management: Fixed node edit type form to honor 'has title' and 'has body' settings (#90606) and implemented proper validation of content type names (#99180).

• Cache Issues: Fixed theme cache clearing when theme settings are saved and prevented over-caching (#97317).

• Database Issues: Fixed encoding of blobs (#92430) and added proper handling of database column types for PostgreSQL (#93506).

• File Handling: Improved file information updating as files are saved (#97870) and enhanced attachment downloading to be handled by the browser (#61528).

• PHP Notices: Fixed numerous PHP notices and warnings throughout the codebase (#93821, #93816, #98261).

New Features

• Enhanced Module Management: The modules page now displays version numbers, making it easier to track which version of each module is installed (#87298).

• Administrative Table Improvements: Added 'select all' and range select features to admin tables, significantly improving bulk operations (#84961).

• Garland Theme Enhancements: Added a header region to the Garland theme (#93187), providing more flexibility for site builders.

• Sites/all Directory Structure: Implemented a new sites/all directory with accompanying documentation for better organization of contributed modules and themes (#93750).

• Fieldset Improvements: Enhanced fieldsets to maintain focus after expansion, improving the administrative user experience (#88045).

• Module Enabling API: Refactored module enabling for greater API availability during hook_enable(), giving developers more flexibility (#93212).

• Content Type Hooks: Added a hook for content type changes and implemented it to maintain vocabulary associations when content types are modified (#80257).

• Permission Improvements: Authors can now always view their own posts, addressing a common usability issue (#91817).

• Module-specific Links: Added direct links to specific modules in the permissions page, improving navigation (#87700).

Security Updates

• Session Security: Improved Drupal sessions to work with SHA1 session IDs, enhancing security (#78732).

• Access Control: Removed redundant access checks to streamline and improve security (#83288) and prevented editing of locked roles (#54167).

• User Data: Removed an instance of loading uid 0 unnecessarily (#76931), improving security by limiting access to the anonymous user account.

• Data Sanitization: Enhanced node cloning to keep the cache sanitized (#86842), preventing potential security issues with cached content.

• Input Validation: Fixed handling of magic quotes to address PHP inconsistencies that could lead to security vulnerabilities (#91624).

• Path Handling: Improved decoding of destination paths (#89059) to prevent potential security issues with redirects.

Performance Improvements

• Database Optimization: Added an index to the watchdog table to improve logging performance (#99128).

• Code Efficiency: Replaced loops with standard PHP functions for better performance (#97686).

• Cache Management: Improved cache handling to prevent unnecessary cache entries and better cache invalidation when needed (#93188, #97317).

• Session Handling: Enhanced session management to save sessions before objects are destroyed on certain configurations (#93945).

• Query Optimization: Removed redundant queries to improve database performance (#62035).

• Module Loading: Fixed scanning of module directories to only look in the correct locations, preventing unnecessary file system operations (#93882).

Impact Summary

Drupal 5.0-beta-2 represents a significant step toward a stable 5.0 release, with over 2,300 changes across 97 files. This update focuses on stabilizing core functionality while introducing targeted enhancements to improve usability and developer experience.

The most impactful changes include improved session handling for better compatibility across different server configurations, enhanced administrative interfaces (particularly for blocks and modules), and important API refinements that make module development more consistent. The addition of the sites/all directory structure improves site organization, while fixes to the book module and Garland theme address commonly reported issues from beta-1.

For administrators, the improved module page with version numbers and enhanced administrative tables with select-all functionality will significantly improve day-to-day site management. Developers will benefit from the refactored module enabling API and new hooks for content type changes. Content editors will appreciate fixes to book outline saving and better handling of node types.

While this release contains many bug fixes and improvements, it's still a beta version intended for testing rather than production use. The changes in this release demonstrate Drupal's commitment to stability, security, and usability as it moves toward the final 5.0 release.