This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Drupal 11 Migration Guide

Upgrade YMCA Website Services from Drupal 10 to Drupal 11.

    Overview

    YMCA Website Services 11.1.0.0-beta1 brings compatibility with Drupal 11, released September 23, 2024. This is currently a beta release for early adopters and testing. A stable release is targeted for Q4 2025.

    What’s New in Drupal 11

    From the 11.1.0.0-beta1 release notes:

    Major Platform Upgrades:

    • Drupal 11 core upgrade
    • PHP 8.3+ requirement (Symfony 7 integration)
    • Composer-only module management (module upload UI removed)

    New Development Features:

    • Single Directory Components (SDC) for streamlined UI component development
    • Object-Oriented Hooks (class-based hooks replacing procedural)
    • New Icon Management API
    • Native WebP image support

    Content Editor Improvements:

    • Project Browser for visual module installation
    • Workspaces module for content staging
    • Experimental new admin navigation system

    Removed/Deprecated:

    • ckeditor (replaced by CKEditor 5)
    • ckeditor5_font module
    • inline_entity_menu_form module
    • bartik and seven themes
    • panelbutton module

    For complete release details, see 11.1.0.0-beta1 on GitHub.

    Before You Upgrade

    Important: This is a beta release. Only upgrade if:

    • You’re testing for bugs before the stable Q4 2025 release
    • You have a staging environment for testing
    • You’re comfortable troubleshooting potential issues

    Most YMCAs should remain on Drupal 10 until the stable Drupal 11 release in Q4 2025.

    Prerequisites

    Before upgrading to Drupal 11:

    1. Update to latest Drupal 10: Ensure you’re on Drupal 10.3.x or higher
    2. Upgrade PHP: Update server to PHP 8.3 or higher
    3. Backup everything: Database, files, and code
    4. Test on staging: Never upgrade production directly

    Known Issues

    jQuery 3.x Script Compatibility

    Issue: Drupal 11 uses jQuery 3.x, which breaks some legacy jQuery 1.x/2.x scripts.

    Solution: As of version 11.1.0.0-alpha2, YMCA Website Services includes jQuery Migrate to provide backward compatibility.

    What this means:

    • Legacy jQuery syntax (jQuery 1.x/2.x) continues to work with jQuery 3.x
    • Custom JavaScript and third-party libraries maintain compatibility
    • No immediate action required for most sites

    For developers with custom JavaScript:

    • Test your custom modules with jQuery 3.x
    • Update deprecated jQuery methods when possible
    • jQuery Migrate provides console warnings about deprecated code

    References:

    Getting Help

    Testing Drupal 11 beta?

    Need professional assistance?

    Additional Resources