Drupal 11 Upgrade Analysis and Plan

[yepzdk]

Summary

This issue documents the analysis and planning for upgrading Høringsportal from Drupal 10 to Drupal 11.

Current Status

Component	Version	D11 Ready
Drupal Core	^10.0	Needs update to ^11.0
PHP	^8.4.0	✅ Exceeds D11 minimum (8.3)
Custom Modules	27 modules	✅ All declare ^11 compatibility
Contrib Modules	57 modules	✅ Major versions compatible
Themes	2 themes	✅ Already declare ^11 compatibility

Compatibility Analysis

✅ PHP Version - READY

• Current requirement: PHP ^8.4.0
• Drupal 11 requires: PHP 8.3+
• Status: Already exceeds requirements

✅ Custom Modules - READY

All 27 custom modules already declare Drupal 11 compatibility in their core_version_requirement:

• Core modules: hoeringsportal_hearing, hoeringsportal_citizen_proposal, hoeringsportal_public_meeting, etc.
• All use modern patterns (Hook attributes, AutowireTrait, DrushCommands)
• No deprecated API usage detected

✅ Themes - READY

• hoeringsportal: core_version_requirement: ^8 || ^9 || ^10 || ^11
• hoeringsportal_admin: core_version_requirement: ^10 || ^11

✅ Deprecated APIs - NONE FOUND

• No @deprecated comments in custom code
• All validation methods use current API (addViolation)
• All messenger methods use current API (addError)
• Modern Hook attributes already in use

⚠️ Patches - REQUIRES REVIEW

4 patches need verification for D11 compatibility:

1. drupal/better_exposed_filters - Visually hidden label (local patch)
2. drupal/core - 3 patches:
   • Text format wrapper description_display (2421445)
   • Validation bug fix (3210319)
   • AutowireTrait for plugins (3294266)
3. drupal/site_status_message - Cache support patch
4. vincentlanglet/twig-cs-fixer - Trans tag plural handling

Action Required: Check if these issues are resolved in D11 core or contrib releases.

⚠️ Contrib Modules in Pre-release

Some modules are in alpha/beta/RC status:

• webform (^6.3@beta)
• openid_connect (^3.0@alpha)
• email_registration (^2.0@RC)
• entityqueue (^1.0@alpha)
• viewsreference (^2.0@beta)

Action Required: Monitor for stable releases before/during upgrade.

⚠️ jQuery Dependencies - MINIMAL

Only 2 custom modules have jQuery dependencies:

• hoeringsportal_quicklinks
• itk_admin_links

Status: Not blocking, but worth noting for future modernization.

Upgrade Plan

Phase 1: Pre-Upgrade Preparation

• Run upgrade_status module report (already installed)
• Update all contrib modules to latest D10-compatible versions
• Review each patch for D11 compatibility
• Check for stable releases of alpha/beta modules
• Create full database and file backup

Phase 2: Perform Upgrade

• Update composer.json: Change drupal/core from ^10.0 to ^11.0
• Update all drupal/core-* packages to ^11.0
• Run composer update drupal/core* --with-all-dependencies
• Run drush updatedb for database schema updates
• Run drush cache:rebuild
• Export configuration: drush config:export

Phase 3: Post-Upgrade Validation

• Verify all custom modules load correctly
• Test Deskpro integration
• Test OpenID Connect authentication
• Test Pretix integration for public meetings
• Test search functionality (search_api)
• Run full Playwright test suite
• Visual regression testing of key pages

Risk Assessment

Risk	Level	Mitigation
Custom module compatibility	Low	All already declare D11 support
Contrib module compatibility	Low	Major versions compatible
Core patches breaking	Medium	Manual review required
Integration failures	Low	Test in staging first
Theme issues	Low	Already D11 compatible

Estimated Effort

• Pre-upgrade preparation: 1-2 days
• Upgrade execution: 1 day
• Testing and validation: 3-5 days
• Total: ~1-2 weeks

Conclusion

The codebase is well-prepared for Drupal 11 upgrade with:

• ✅ No major blockers identified
• ✅ All custom code already D11-compatible
• ✅ Modern development patterns in use
• ⚠️ Only patches require manual review

References

• Drupal 11 Upgrade Guide
• Drupal 11 Requirements

[yepzdk]

Upgrade Status Module Scan Results

Ran upgrade_status:analyze on all custom modules, themes, and key contrib modules.

Custom Modules - ALL PASSED ✅

Module	Status
hoeringsportal_hearing	✅ No issues
hoeringsportal_citizen_proposal	✅ No issues
hoeringsportal_public_meeting	✅ No issues
hoeringsportal_data	✅ No issues
hoeringsportal_deskpro	✅ No issues
hoeringsportal_openid_connect	✅ No issues
hoeringsportal_project	✅ No issues
hoeringsportal_activity	✅ No issues
hoeringsportal_dialogue	✅ No issues
hoeringsportal_forms	✅ No issues
hoeringsportal_config_settings	✅ No issues
hoeringsportal_audit_log	✅ No issues
hoeringsportal_anonymous_edit	✅ No issues
hoeringsportal_content_access	✅ No issues
hoeringsportal_content_blocks	✅ No issues
hoeringsportal_quicklinks	✅ No issues
hoeringsportal_misc	✅ No issues
hoeringsportal_project_timeline	✅ No issues (not installed - library check skipped)
hoeringsportal_decision	✅ No issues
itk_admin	✅ No issues
itk_admin_links	✅ No issues
itk_media_entity	✅ No issues
aarhus_hero	✅ No issues

Custom Themes - ALL PASSED ✅

Theme	Status
hoeringsportal	✅ No issues
hoeringsportal_admin	✅ No issues

Contrib Modules Scan Results

Module	Version	Status	Notes
openid_connect	3.0.0-alpha6	✅ No issues
entityqueue	8.x-1.9	✅ No issues
viewsreference	8.x-2.0-beta10	✅ No issues
search_api	8.x-1.38	⚠️ Minor	Check manually items (non-blocking)
paragraphs	8.x-1.19	⚠️ Deprecations	See details below
webform	-	⏭️ Skipped	Too large for local analysis - check drupal.org

Paragraphs Module Deprecation Details

The paragraphs module (8.x-1.19) has deprecations that need updating:

Removed in Drupal 11.0.0:

• loadRevision() → Use RevisionableStorageInterface::loadRevision() (15 occurrences)
• deleteRevision() → Use RevisionableStorageInterface::deleteRevision() (1 occurrence)

Removed in Drupal 12.0.0:

• renderPlain() → Use RendererInterface::renderInIsolation() (2 occurrences)
• RenderElement → Use RenderElementBase (2 occurrences)

Other:

• Twig spaceless filter deprecated (2 occurrences in templates)

Action Required: Update drupal/paragraphs to latest version before D11 upgrade. Check drupal.org/project/paragraphs for D11-compatible release.

Summary

Ready for Drupal 11:

• ✅ All 23 custom modules
• ✅ Both custom themes
• ✅ Most contrib modules tested

Requires Update Before Upgrade:

• ⚠️ drupal/paragraphs - Update to D11-compatible version
• ⚠️ drupal/webform - Verify D11 compatibility on drupal.org

Scan Date: 2026-01-28