UT Drupal Kit 3.12.0 is a bi-monthly maintenance release for the University of Texas at Austin’s custom distribution of the Drupal web content management system.
This release is notable in that it includes a major version update from Drupal 9 to Drupal 10. Campus developers should carefully read the release notes below before updating. Site managers and content editors, on the other hand, should not expect any noteworthy changes: site display, behavior, and editing experience are not changing in any substantive way.
Major version update: Drupal 9 to 10
NOTE: The 3.12.0 release increments the version of Drupal core from 9.5.8 to 10.0.9.Action is required by developers maintaining Drupal Kit sites.
We encourage developers to reach out to drupal-kit-support@utlists.utexas.edu with any questions or concerns after reading the contents below. The Drupal Kit team will also be hosting a live webinar session on June 20, 2023 to offer assistance to any teams still working through Drupal 10 compatibility issues.
The update from Drupal 9 to Drupal 10 is a major version update. Most notably, it:
- removes Drupal APIs deprecated during the Drupal 9 development cycle
- requires a minimum PHP version of 8.1
- includes a major version update of CKEditor (v4 to v5)
- includes a major version update for the Symfony framework (v4 to v6)
To reduce the surface area of code change included the 3.12.0 release, many changes related to the Drupal major version update were introduced in previous releases, as noted in the table below. Depending on the version of the Drupal Kit sites are currently running, developers may or may not need to address the items below:
| Change | Update actions |
|---|---|
Bartik, Seven, and Stable themes are removed |
The 3.11.0 release uninstalled Bartik and Stable, and Drupal Kit sites should already be using the Claro administrative theme. Any code dependencies on Bartik, Seven, or Stable will need to be refactored. Developers using an administrative theme other than Claro will need to check if it is compatible with Drupal 10 and potentially switch or update their administrative theme. |
| The minimum PHP version is 8.1 | The 3.11.0 release of the Drupal Kit set the default PHP version for sites hosted on Pantheon to 8.1. Developers with sites hosted elsewhere than Pantheon, or who have set a Pantheon-hosted site to a lower PHP version in the pantheon.yml file, will need to change that version and ensure that custom or contributed code is compatible with PHP 8.1. See PHP 8 update. |
| CKEditor version 4 is removed | The 3.11.0 release of the Drupal Kit converted existing text formats using CKEditor 4 to CKEditor 5. Sites that have already successfully updated to 3.11.0 should not require additional work for CKEditor. Site that have not updated should read CKEditor 5 update. |
| All contributed code must be Drupal 10-compatible | Developers who have added contributed modules or themes beyond those included with the Drupal Kit will need to audit them for Drupal 10 compatibility and potentially update or find a replacement. The Drupal Kit team is available for consultation. |
| Drupal 9 API deprecations must be replaced | Developers who have added custom modules or themes are responsible for making them Drupal 10 compatible. The Drupal Kit team is available for consultation. |
| Symfony 4 API deprecations must be replaced | Developers who have added custom modules or themes are responsible for making them Symfony 6 compatible. The Drupal Kit team is available for consultation. |
| New major version for Enterprise Authentication integration on Pantheon | Developers who have integrated Enterprise Authentication on existing Pantheon sites will need to make sure their codebase can use version 4 of the pantheon_saml_integration plugin. See Add the “Pantheon SAML Integration” plugin |
| Twig templates must be compatible with version 3 | Developers who have added custom Twig templates should audit them for compatibility with Twig 3. The Drupal Kit team is available for consultation. |
Bootstrap dropdown library removed from Forty Acres
Previous releases of the Forty Acres theme included a Boostrap framework library for inserting dropdown menus through HTML snippets. The latest version of CKEditor (the rich text editor that Drupal uses) does not accept the HTML format prescribed for these dropdowns. We therefore designated the dropdown capability as no longer supported within rich text editing and removed the dropdown library from Forty Acres.
Developers wanting to use the dropdown functionality directly in HTML code (e.g., Twig templates) may do so by adding the Bootstrap library to their codebase. See https://getbootstrap.com/docs/4.0/components/dropdowns/ .
Contributed module updates
The following contributed modules are updated in this release.
Modules included with the UT Drupal Kit installation profile
- Admin Toolbar: from 3.3.0 to 3.3.2
- Features: from 3.12.0 to 5.0.0-alpha1
- CKEditor 4 Height: removed from codebase
- Layout Builder Modal: removed from codebase
- Linkit: from 6.0.0-beta4 to 6.0.0-rc1
- Page Title Visibility: from 1.5.0 to 1.6.0
- Pathologic: from 1.0.0-alpha3 to 2.0.0-alpha1
Modules included with the News add-on
- Search API: from 1.28.0 to 1.29.0
Modules included with the Event add-on
- Fullcalendar View: from 5.1.11 to 5.1.12
Modules included with the Profile add-on
- Bootstrap Horizontal Tabs: from 2.0.2 to 2.0.4
Updating an existing codebase
Please visit the UT Drupal Kit 3 documentation for complete release notes and instructions for updating an existing codebase using Composer. Always be sure to check for available database updates after updating the codebase.
How do I get started with UTDK 3?
The first thing anyone interested in starting with UTDK 3 should do is to head over to the documentation site:
https://drupalkit.its.utexas.edu/docs/
The “What is the UT Drupal Kit?” chapter contains detailed explanations of what the Kit contains, as well as a list of differences between versions 2 and 3.
The “Getting Started” chapter includes technical requirements for running version 3, as well as detailed instructions for setting up an environment on your own local workstation, a LAMP server, or Pantheon.
If you run into problems or have questions, please check the “Support” page for available support options.
Next releases
The 3.x (Drupal 9) branch of the UT Drupal Kit is updated on a bi-monthly maintenance release schedule, with releases targeted for the fourth Tuesday of odd-numbered months. The next planned release is UT Drupal Kit 3.13.0, due in July 2023. Please see Release Schedule for UT Drupal Kit for more details.
