UT Drupal Kit 3.0.0 release notes

Release date - May 11, 2021

Important

As of this release, UT Drupal Kit version 3 is now considered the “current” stable version of the UT Drupal Kit, and is available as a custom upstream on Pantheon using their “Integrated Composer” platform feature. It is also available as standard Composer packages for developers wishing to install on non-Pantheon hosting.

Version 3 (based on Drupal 9) should be used by developers creating new sites. Version 2 (based on Drupal 7) will remain available and supported until at least November 2022, which is the scheduled end-of-life for Drupal 7.

As there is no direct upgrade path from Drupal 7 to Drupal 9, there is also no direct upgrade path from UT Drupal Kit version 2 to version 3. To discuss migration strategies and options, please contact the UT Drupal Kit team by emailing drupal-kit-support@utlists.utexas.edu.

Contents

Release summary 

This release marks as “stable” the UT Drupal Kit version 3, as well as all of its Add-ons. Following definitions established by SemVer and Drupal core, this means:

All identified critical bugs have been fixed
No backwards-compatibility-breaking changes will be introduced
New features will still be added in the future
The code is considered ready to use in production environments

Update actions for existing sites 

If you created a site prior to this stable release, review the following for potential changes you need to make.

Add custom Composer installer paths 

If you are updating from beta.10.2 or earlier, start by reading the UT Drupal Kit 3.0.0-RC.1 release notes, which include specific actions maintainers of existing sites must take.

Change plugin for Enterprise Authentication 

As of this release, sites that are Integrating Enterprise Authentication should use the ITS-provided Composer plugin pantheon_saml_integration. Prior to the 3.0.0 release, sites used the utexas_pantheon_saml_auth plugin, which is no longer supported and will be removed in the future. Existing sites already using the previous plugin should email drupal-kit-support@utlists.utexas.edu for instructions on how to switch to the new plugin.

Read about configuring Enterprise Authentication in the Integrating Enterprise Authentication section.

Change version constraints for add-ons 

If you previously installed any of the Add-ons, your composer.json will contain version constraints of ^1 or similar. The stable release of each of the add-ons changes the version number to 3.0.0, which will require you to make change to retrieve further updates:

For each add-on defined in your composer.json file, change the version constraint to ^3.
Then run composer update/utexas*

Discontinue use of UTexasLinkElement 

The former UTexasLinkElement class, which was deprecated on May 12, 2020, has been removed from the codebase. Sites which have not implemented custom code that leverages this element class need not take action. Sites which have implemented custom code that leverages this element can contact ITS at drupal-kit-support@utlists.utexas.edu for assistance in replacing this with the newer UTexasLinkOptionsElement.

All changes since 3.0.0-RC.2 

UTexas installation profile 

Task: Update to Drupal 9.1.8 #1573
Bug: UI-based site installation initially fails until cache rebuild #1567
Task: Remove no longer scaffolded settings.php #1564
Task: Update to Menu Block 1.7.0 #1562
Task: Update contributed projects #1560
Bug: Promo Unit with image, but without URL generates “Undefined index: link” php notice #1234
Bug: Missing iframe title on video embeds inserted via Media library #1201

Forty Acres theme 

Bug: Mobile menu button sometimes obscured if tall logo used #274
Bug: Insufficient whitespace between Header and Main Content regions on pages with no page title and breadcrumbs #271
Task: Convert Composer type to “custom” #266
Bug: Typo in package.json prevents “npm install” from executing #264
Bug: Featured Highlight dark themes do not have sufficient color contrast on link appearance icons #263
Task: Remove “potential reviewers” from pull request template #262
Task: Finalize repository for public mirror #259
Task: Final review of all contents of composer.json and package.json #252
Bug: “Tall” logo option distorts positioning of secondary menu #249

Profile add-on 

Task: Update contributed projects #247
Enhancement: Add configuration UI read-only functionality #246
Task: Release 3.0.0 #244
Task: Convert Composer type to “custom” #238
Task: Remove “potential reviewers” from pull request template #237
Task: Finalize repository for public mirror #235
Enhancement: Add ability to create listings of specific profiles with arbitrary order #188
Bug: Deleted taxonomy terms referenced in Profile listing blocks affect filtering #177
Enhancement: Add external link icon to “Building Code” field when rendered #143
Enhancement: External link icon for “View in directory” link #142

News add-on 

Enhancement: Add configuration UI read-only functionality #107
Task: Convert Composer type to “custom” #102
Task: Remove “potential reviewers” from pull request template #101
Task: Finalize repository for public mirror #99

Event add-on 

Task: Update contributed projects #121
Enhancement: Add configuration UI read-only functionality #120
Task: Convert Composer type to “custom” #114
Task: Remove “potential reviewers” from pull request template #113
Task: Finalize repository for public mirror #111
Bug: “Create new revision” is unchecked by default #104