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:

  1. For each add-on defined in your composer.json file, change the version constraint to ^3.

  2. 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