• Posted:

  • Type:Blog Post
  • Type:Claude

5.0.0 moves wms-drupal to Drupal 11.4.13 on PHP 8.4. It's a major release because the platform changes underneath every site: Drupal core 10 → 11, jQuery 3 → 4, Bootstrap 4 JS → Bootstrap 5 JS, and a new major of the admin theme. It ships with lehigh_clutch 3.0.0. There are no new features. Pages should look and behave the same as they did on 4.0.5.

What changed for editors

  • Admin theme: Gin 5 and Gin Toolbar 3. Menus and forms are where they were, but the styling is a little different. Seven is still installed.
  • Bootstrap markup in body content: the theme now loads Bootstrap 5 JavaScript (the Bootstrap 4 CSS stays). If you pasted Bootstrap 4 attributes such as data-toggle straight into a body field, that collapse or tab won't open any more. Use the accordion and tab components instead. Theme components were tested and are not affected.
  • Image cropping: the crop widget now uses Cropper.js, because the old jQuery plugin doesn't work with jQuery 4. Cropping works the same way. Required crops no longer complain as soon as you upload; they're checked when you save.
  • Exclude node title: the obsolete use exclude node title permission is removed. The exclude any and exclude own permissions still apply.
  • 404 search: a missing URL that ends in a file extension (for example .pdf or .docx, but not .html or .php) now shows "Denied file query" instead of running a site search.
  • Teaser previews: previewing an unsaved plaque or volunteer opportunity no longer returns an error. lehigh_clutch 3.0.0 also fixes errors in previews for teasers, accordions, videos and new person pages.

Known issues

  • /sitemap.xml can no longer be sorted by column in the browser. The XML that search engines read is unchanged. Simple XML Sitemap 5.x removes this view anyway.
  • If you resize the browser window while a Layout Paragraphs dialog is open, the dialog doesn't re-center. Nothing is lost.

Platform

  • Drupal core 10.6.22 → 11.4.13 and PHP 8.2 → 8.4 (DRUP-3719). Drush 13.8.1, PHPUnit 11.5.
  • lehigh_clutch 2.0.4 → 3.0.0: Bootstrap 5.2.3 JS, a Slick fix for jQuery 4, and fixes for single-directory components that returned a 500 when a prop was empty (maintenance page, footer, previews).
  • Contrib majors for Drupal 11: Gin 5, Gin Toolbar 3, Seven 2.0.0-beta8, ImageMagick 5, Image Effects 5, Exclude Node Title 2, Scanner 2, Search 404 2.2, SMTP 1.4. Packages used only by some splits moved to their D11 lines too: Media PDF Thumbnail 7, Migrate CS 2, Migrate Devel 3, ckeditor_bootstrap_table 2 and finder 2.
  • Telephone: Drupal 11.4 drops the core Telephone module, so it now comes from contrib (drupal/telephone 1.0.1).
  • ECA stays on 2.x. It already supports Drupal 11, and 3.x removes modules that some splits use.
  • lehigh_card_validation 1.3.1 and a backported Quick Node Clone fix (#3536484) mean new sites can be installed from config again with drush si --existing-config.
  • ImageMagick config now says v7, which matches production.

Patches

  • Added: Image Widget Crop #3093928 (Cropper.js), a local follow-up for it, and #3626475 (required-crop validation on Drupal 11.3+). Same patch set as lts-drupal-website and global-website. Quick Node Clone #3536484 (moved NodeForm class).
  • Dropped: core #2923634 (no longer applies), Exclude Node Title #3346319 and File MDM #3492414 (fixed upstream), Seven #2688793 (not needed in 2.x).
  • patches/htaccess.patch was rerolled against the 11.4.13 scaffold.

Deploy and CI

  • drupal-deploy.sh is unchanged (updatedb, cr, cim, cr, cim). Expect about 50 database updates on the default site. Split sites will have a different number.
  • The first cim on each site deletes and recreates three config items once: the search_index and search_result view modes and the webform_default text format. Their UUIDs changed, but the IDs and settings are the same. The second cim finds no changes.
  • The build has to allow the symfony/runtime Composer plugin and keep vendor/autoload_runtime.php, because the Drupal 11.4 index.php loads it.
  • All 45 config splits were run through the Drupal 11 updates and re-exported, so cim doesn't undo the update hooks on split sites. Ignored config in sync was brought up to date too, so fresh installs match upgraded sites.
  • The existing warnings about lehighwms schema 1000 and the orphaned minimal schema still appear. They're harmless.

How it was tested

  • Deploy rehearsal from a Drupal 10 snapshot of the default site, ending with a clean config status.
  • A crawl of every node, term and edit form, both anonymous and as admin, with PHP assertions on. It found no 500s and no PHP warnings or deprecations.
  • A JavaScript error sweep of all 134 front-end pages. The only errors left are on two pages that throw the same errors on production (embedded content).
  • An interaction suite for accordions, menus and togglers, compared with production: 21 of 23 steps match, and the other two differ only by a class with identical computed styles.
  • Image crop tested end to end in the browser, a fresh drush si --existing-config install, and the QA checklist in docs/DRUP-3719/QA.md.

What's next

  • Per-site checks of the split sites on Drupal 11.
  • pfaffs needs its own jQuery 4 / Bootstrap fix, because it uses bootstrap_drupal directly.
  • Simple XML Sitemap 5.x, a tagged Maintenance 200 2.2 release, and removing the deprecated Ban module.