UT Drupal Kit 3.20.0 release notes

Release date - September 24, 2024

Contents

Release summary

The 3.20.0 release is part of the Drupal Kit’s normal, bi-monthly maintenance release schedule. In addition to a greater than usual number of visual adjustments detailed below, developers maintaining existing sites should note two main changes:

  • This release updates Drupal core to version 10.3. This is the final feature release of Drupal 10. Changes included in 10.3 should not require action for developers updating sites. However, sites must update to 10.3 before updating to Drupal 11. Our initial timeline for updating the Drupal Kit to Drupal 11 is early to mid 2025, so there should be ample time to update to this release before updating to Drupal 11.

  • This release relocates all CSS associated with the Forty Acres theme into the forty_acres package. Previously, styling for content components like Featured Highlight and Promo Unit were located in the installation profile (utdk_profile), and styling for the News, Event, and Profile add-ons were located in those add-ons’ packaging. The rationale for this change is to consolidate the Forty Acres look and feel so that an eventual replacement theme can be introduced without style conflicts. This relocation will not affect the look and feel of sites that use Forty Acres theme or a sub-theme of it. If you have a site that uses a theme that is not based on Forty Acres, you may need to add legacy CSS to your theme. Reach out to drupal-kit-support@utlists.utexas.edu for more detail.

  • Legacy code has been removed from the upstream’s composer.json file. Developers will likely need to perform merge resolution on the file during this update; for developers updating via Pantheon, this should simply mean using the “Auto resolve conflicts” checkbox under the “Update options” dropdown.

Visual changes

Release 3.20.0 includes visual changes that may affect content on existing sites. These changes are described below, with before/after examples.

Section backgrounds now display full-width for all content widths

This change affects all new and existing Flex Page sections where a background image or color has been added. Previously, these background accents were limited to displaying as a margin around content. Now the background accent fills the width of the screen viewport, as shown below.

Full description: https://github.austin.utexas.edu/eis1-wcs/utdk_profile/issues/1929

Before

After

Screenshot of non-full-width section backgrounds

Screenshot of full-width section backgrounds

Horizontal tabs now visually associate the tab labels with their content

Previously, the Flex List Horizontal Tab display used a white background for both active and inactive tabs. Now, inactive tabs display with an off-white color, and the active tab text is boldfaced to better indicate active state.

Full description: https://github.austin.utexas.edu/eis1-wcs/utdk_profile/issues/2025

Before

After

Screenshot of horizontal tabs without active indicator

Screenshot of horizontal tabs with active indicator

HTML <details> elements now display with default “Accordion” design

Previously, HTML <details> elements entered in rich text areas displayed with a basic collapse indicator on a gray background. Now they automatically display with the same burnt-orange styling of the Flex List’s Accordion design.

Full description: https://github.austin.utexas.edu/eis1-wcs/forty_acres/issues/610

Before

After

Screenshot of details element with minimal styling

Screenshot of details element with default styling

Component headlines now have equal padding and line height

Previously, different Block types headline fields displayed with divergent padding. In this release, that padding is normalized across components so that items placed side-by-side will align vertically.

Issues:

Example 1

Example 2

Example 3

Screenshot of Featured Highlight headline padding adjustment

Screenshot of Quick Links headline padding adjustment

Screenshot of Event listing block headline padding adjustment

Event listing pages have relocated filters adjacent to buttons

Previously, on large screens, event listing filters displayed below the Calendar/Upcoming Events/Past Events buttons. Now they are adjacent. Additionally, these items stack more uniformly on small screens.

Full description: https://github.austin.utexas.edu/eis1-wcs/forty_acres/issues/634

Before

After

Screenshot of non-adjacent event filters

Screenshot of adjacent event filters

Keyboard navigation focus indicator has improved color contrast

Users navigating via keyboard will now see a focus indicator that has higher contrast than previous, on both light and dark backgrounds.

Full description: https://github.austin.utexas.edu/eis1-wcs/forty_acres/issues/403

Before

After

Screenshot of focus indicator with faint dotted line

Screenshot of focus indicator with high contrast

Copy text font size has been standardized

There were some discrepancies in the size of “copy” text across components and displays. This release makes that font size consistent. No visual screenshot is provided for this change. Full description: https://github.austin.utexas.edu/eis1-wcs/forty_acres/issues/431

Profile (People) Listings using the “Basic” display have been improved

Previously, the “Basic” display for Profiles showed very small thumbnail images with non-wrapping text. This release improves this display at all screen widths, making the images the same size as those used in the “Prominent” display, and fitting text more appropriately around the image.

Full description: https://github.austin.utexas.edu/eis1-wcs/utprof/issues/286

Before

After

Screenshot of Basic display with small images

Screenshot of Basic display with larger images

Additional developer callouts

  • The Forty Acres theme now provides a default look and feel for search facets. Developers with sites which already have customized search facets displays should review the output as part of this update to ensure that the new defaults do not adversely affect customizations.

  • The robots.txt file has received some minor changes. Developers who have modified the robots.txt file should review the file after update to ensure that any still relevant modifications have not been overwritten.

  • Drupal user accounts now have the ability to display the user’s “real name” instead of the Drupal account username throughout the interface. For sites using Enterprise Authentication, this name will be automatically populated from the University directory. Sites not using Enterprise Authentication can use this feature by manually entering the user’s name in the “Full name” field within the user profile.

Drupal core updates

Contributed module updates

Modules included with the UT Drupal Kit installation profile

Modules included with the News add-on

Facets: from 2.0.7 to 2.0.8

Modules included with the Event add-on

Modules included with the Profile add-on

All changes since 3.19.1

UTexas installation profile (25)

  • Enhancement: Render default utexas_image view mode with sensible image style to avoid super high resolution rendering #957

  • Task: Replace deprecated @-moz-document Hero Carousel prev/next button display for Firefox #1911

  • Bug: [Accessibility] Details/summary elements are not navigable by keyboards #2609

  • Enhancement: Add default values for required Open Graph metatags #2004

  • Enhancement: Interface for site owners to upload a social sharing photo, with UT default #2005

  • Task: Grant appropriate user access to Drupal Kit settings #2466

  • Task: Standardize HTML filtering across single-line text input fields #1445

  • Task: Remove deprecated twitter_cards_page_url from global metatags #2611

  • Task: Remove Twitter Profile Widget from codebase #2231

  • Enhancement: Display users’ real names throughout the administrative interface #848

  • Enhancement: Remove version numbers on all sub-modules within the kernel #950

  • Task: Relocate component CSS to Forty Acres #2579

  • Enhancement: Display section background colors/images full-width at all content widths #1929

  • Bug: Quick Links items cannot be re-ordered using “Row weights” #2629

  • Task: Update to url_embed 3.0.0-beta1 #2625

  • Bug: Options for Background Accents display inconsistently in editing form #2632

  • Bug: Section background blur effect cannot be deselected #2638

  • Enhancement: Move social links placeholder help text into description text below input #845

  • Enhancement: Add confirmation dialog when removing an item from a component #2315

  • Bug: [Flex list] Horizontal tabs instances can populate empty ID attributes #2604

  • Task: Relocate utexas_qualtrics_filter to kernel #2622

  • Task: Update to Drupal 10.3 #2568

  • Enhancement: Increase top/bottom padding on sections with background accents #2628

  • Task: Update contributed dependencies #2646

  • Bug: Roll back responsive_tables_filter to 1.18.0 #2649

Forty Acres theme (12)

  • Enhancement: Add default styling for facets blocks #377

  • Task: Standardize line-height for the ut-headline CSS class #599

  • Task: Normalize padding, margins, & line-height of .ut-headline utility classes #604

  • Task: Standardize font size across copy fields throughout components #431

  • Enhancement: Create a two-color focus indicator to ensure sufficient contrast with all components #403

  • Task: Relocate utnews default theme styling to Forty Acres #631

  • Bug: “Today” toggle on Calendar view has insufficient color contrast on hover state #632

  • Task: Relocate utprof default theme styling to Forty Acres #636

  • Task: Adjust padding for News add-on headline after Forty Acres normalization #639

  • Task: Improve how buttons stack on mobile screens #633

  • Task: Relocate event filters adjacent to Calendar/Upcoming/Past events buttons #634

  • Bug: Event selector inputs can overlap if very long selection options are present #643

Profile add-on (4)

  • Enhancement: Improve display of profile items in basic view mode lists #286

  • Task: [UTPROF] - Remove spacing-related styling for .ut-headline from utdk_profile in favor of Forty Acres #406

  • Task: Relocate default theme styling to Forty Acres #407

  • Task: Update contributed dependencies #409

News add-on (5)

  • Task: Convert News teaser variations to separate view modes #233

  • Task: Wrap author bio around image on narrow screens #327

  • Task: Remove spacing-related styling for .ut-headline in favor of default theme #331

  • Task: Relocate default theme styling to Forty Acres #333

  • Task: Update contributed dependencies #337

Event add-on (7)

  • Enhancement: Link location and tags to event listing from individual event node #326

  • Bug: Calendar view changes to full year list on mobile screens #355

  • Task: Relocate default theme styling to Forty Acres #362

  • Task: Relocate event filters adjacent to Calendar/Upcoming/Past events buttons (634b) #365

  • Task: Remove spacing-related styling for .ut-headline in favor of default theme #359

  • Bug: Set date range separator to use “to” #369

  • Task: Update contributed dependencies #367

Upstream repository (1)

  • Task: Remove “upstreamRequire” from root composer.json #159

Enterprise Login integration (2)

  • Bug: SimplesSAMLphp conflicts with Symfony v6.4.8 with “non-existent service serializer.normalizer.object” #69

  • Task: Use version range constraint for dependency of utexas_saml_auth_helper #77

Role-based access (1)

  • Enhancement: Add ability to manually set login redirect destination #24