UT Drupal Kit 3.11.0 release notes

Release date - March 28, 2023

Contents

Release summary

UT Drupal Kit 3.11.0 is a bi-monthly maintenance release for the University of Texas at Austin’s custom distribution of the Drupal web content management system.

In addition to the usual mix of bugfixes and visual improvements, there are several notable changes in this release including the update to PHP 8 as the default version of PHP for sites hosted on Pantheon, the update to CKEditor 5, and the addition of an Instagram feed component.

This release also continues to pave the way for the planned update to Drupal 10 in the next scheduled maintenance release. Please see below for a special note about base themes and an action item for site owners using a custom theme that is NOT a sub-theme of Forty Acres.

For full details of all other changes in this release, please refer to the “All changes” section at the end of this page, which contains links to the corresponding GitHub issues.

PHP 8 update

In preparation for the planned update to Drupal 10, this release updates the default version of PHP for sites hosted on Pantheon from 7.4 to 8.1 by updating the pantheon.upstream.yml file and removing the PHP platform requirement from the root composer.json file.

Drupal 10 will require PHP 8.1, but site owners on Pantheon who wish to continue using PHP 7.4 for the time being can manually “pin” their site’s PHP version by modifying the site’s pantheon.yml file. See Pantheon YAML Configuration Files for more information.

Note

Site owners on hosting platforms other than Pantheon will be responsible for updating their sites’ PHP version to a minimum of PHP 8.1 before the Drupal 10 update scheduled for UTDK 3.12.0 in May 2023.

CKEditor 5 update

In preparation for the planned update to Drupal 10, this release switches the default rich text editor from CKEditor 4, which was bundled as part of Drupal 9, to CKEditor 5, which is the default in Drupal 10.

The CKEditor module in Drupal 9 will be uninstalled, and the CKEditor 5 contributed module for Drupal 9 will be enabled in its place. All text formats included with the UT Drupal Kit (Basic HTML, Full HTML, Flex HTML) will be re-configured to use CKEditor 5.

There are two important callouts related to this change for owners of customized sites:

Warning

The “Flex HTML” text format included with the UT Drupal Kit will be reset to its default configuration.

Any customizations which have been made directly to the Flex HTML text format will be lost, and will have to be re-applied after the update. ITS recommends that site owners only modify the Flex HTML text format using an approach which overrides the base configuration, rather than modifying it directly.

Warning

This update will uninstall any custom modules that declare a dependency on Drupal core’s CKEditor module.

A custom module could declare a dependency without the developer originally having intended to explicitly declare that dependency if they use a configuration bundler such as the Features module. To ensure that no modules that should not be uninstalled are not uninstalled, run the site update in a testing environment and then immediately check the site’s Watchdog logs after running the database updates. Filtering the log entries by the “System” parameter will provide a list of the modules uninstalled. If any modules were unexpectedly uninstalled, examine the dependencies declared in those modules to see if they reference drupal:ckeditor and remove that dependency if found.

Instagram Feed component

The 3.11.0 release includes a new addition to the UT Drupal Kit’s collection of content components, for integrating Instagram content into a site. An example of this component is available at https://demo.drupalkit.its.utexas.edu/instagram.

Due to the complexities of integrating with the Instagram API, configuration of this component requires multiple steps which must be completed by a user with a Meta developer account. See Instagram for detailed instructions.

Action item for non-Forty Acres themes

This update will uninstall the “Stable” theme and install the “Stable9” theme, which was added to Drupal core for backward compatibility after the retirement of “Stable” in Drupal 10. See https://www.drupal.org/node/3107179 for more details on this change.

Warning

If a site is using a custom theme that is NOT a sub-theme of Forty Acres and that uses stable as its base theme, the updates will not complete correctly. The site owner must change the base theme from stable to stable9 before applying the 3.11.0 update. No functional or visual changes will be involved in this switch.

Drupal core update

The 3.11.0 release incorporates the most recent release of Drupal core for the 9.5 minor release branch, bringing it from version 9.5.2 to 9.5.7.

Here are the release notes for all Drupal Core releases inclusive in this release:

Contributed module updates

The following contributed modules are updated in this release:

Modules included with the UT Drupal Kit installation profile

Modules included with the Event add-on

Modules included with the Profile add-on

All changes since 3.10.0

UTexas installation profile

  • Task: Update Drupal Core to 9.5.7 #2160

  • Task: Remediate PHP 8.1 deprecation notice related to null values passed to “unserialize()” #2154

  • Task: Update contributed dependencies (automated) #2152

  • Task: Display CKEditor 5 toolbar items on two lines #2146

  • Task: Respect row height configuration in CKEditor 5 + Drupal 9.5.x #2145

  • Task: Drupal 10 : RouteSubscriber::getSubscribedEvents() must declare array type hint #2138

  • Task: Uninstall ckeditorheight module in preparation for Drupal 10 #2137

  • Task: Uninstall Bartik and Stable themes in preparation for Drupal 10 update #2135

  • Bug: Enable the Stable9 base theme on existing sites for use with Forty Acres #2133

  • Enhancement: Integrate Qualtrics plugin into CKEditor 5 toolbars #2132

  • Task: Run test suite using PHP 8 #2124

  • Bug: External link to KB article within Layout Builder iframe triggers ServiceNow X-Frame-Options: SAMEORIGIN policy #2117

  • Bug: Expand/collapse chevrons in Promo List, Promo Unit, and Resources overlap text in Claro #2116

  • Bug: Retain uninstalled modules Layout Builder Modal and Media Library Theme Reset #2115

  • Enhancement: New component: Instagram feed module part 1 #2114

  • Task: Pin UTDK multidev creator to use pantheon_saml_integration 3.x #2109

  • Task: Uninstall CKEditor 4 concurrent with update to CKEditor 5 #2107

  • Task: Replace deprecated Drupal 9 code for Drupal 10 compatibility #2098

  • Task: Field UI is no longer enabled by default with Drupal 9.5 #2097

  • Task: CKEditor 5 Support: URL Embed #2093

  • Bug: utexas_readonly conflicts with the feeds module #2092

  • Enhancement: Add “access toolbar” permission to default “Manager” permissions set #2090

  • Enhancement: Encourage content editors to upload documents to a third-party file sharing service #2089

  • Enhancement: Convert base elements of flex_html basic_html and full_html text formats to CKEditor 5 #2088

  • Task: Enable CKEditor 5 on new and existing sites #2086

  • Task: CKEditor 5 Support: Linkit #2084

  • Enhancement: Site builders are inadvertently removing site-wide blocks using the contextual “Pencil icon” #2069

  • Task: Ensure that all JsWebAssert::waitFor*() methods have assertion wrappers #2026

  • Task: Reorganize WidgetsTest related trait files #2024

  • Task: Integrate new testing methods introduced in Drupal Core 9.4.0 #2023

  • Task: Ensure type-hinting in VS Code for all variables in Tests #2022

  • Task: Create base class for FunctionalJavaScript tests #2021

  • Enhancement: Create shared methods for node delete and block delete in FunctionalJavaScript Tests #2020

  • Enhancement: Improve consistency and display of editing forms in Layout Builder #1982

  • Task: [EPIC] Switch to CKEditor 5 #1839

  • Bug: ‘Undefined’ text shows in form-error div after dragging items #973

  • Bug: Pressing escape within media browser closes parent modal #775

  • Bug: Entity clone patch fails to apply due to Composer behavior with commit hashes #2164

Forty Acres theme

  • Task: Confirm no regressions of list display in CKEditor 5 #474

  • Bug: Base theme stable9 not installed #470

  • Task: Replicate table border styling in CKEditor 5 #469

  • Bug: Remove core: 8.x from info.yml files #467

  • Task: Drupal 10 compatibility: forty_acres #455

  • Bug: Monsido is confused by changing unique id hashes generated by Accessible Mega Menu library #443

  • Task: Maintain mega-menu functionality internally #154

News add-on

  • Bug: News categories on full view mode render inline rather than stacked #247

  • Task: Drupal 10 compatibility (Part 1: nominal code compatibility) #242

Event add-on

  • Task: Drupal 10 compatibility (Part 1: nominal code compatibility) #244

Profile add-on

  • Task: Drupal 10 compatibility (Part 1: nominal code compatibility) #338

  • Bug: Update to Bootstrap Horizontal Tabs 2.x incompatible with Metatag module #335

Upstream repository

Documentation

  • Task: Remove reference to horizontal tabs as an ‘anchor’ option #460

  • Task: Update screenshots depicting CKEditor 4 to show CKEditor 5 #459

  • Task: Explain how to configure an Instagram app #456

  • Task: Update image for “Style” in Quick Reference Guide PDF for Drupal Kit Managed #396

  • Enhancement: Document L2 menu layout behavior #214