UT Drupal Kit 3.21.0 release notes

Release date - December 3, 2024

Contents

Release summary

Release 3.21.0 is part of the Drupal Kit’s normal, bi-monthly maintenance release schedule. Developers and content editors should note that the Bootstrap framework is updated in this release, detailed below.

Bootstrap framework update

Utility libraries for creating modals, alerts, horizontal tabs, and tooltips, provided by the Bootstrap framework have been updated from version 4 to version 5. Bootstrap made changes to what HTML markup is used with these utilities. For example, horizontal tabs in version 4 used the attribute data-toggle to indicate different tabs. In version 5, that attribute changes to data-bs-toggle. Developers who have built components using any of these utilities and content editors who have placed Bootstrap utility markup in rich text areas will need to review that content and potentially update the markup to work properly with version 5.

The base Bootstrap CSS is also updating from version 4 to 5 in this release; however, that does not introduce any changes to the grid system or other notable visual changes. More details are below in the “Visual changes” section.

Visual changes

Forty Acres now uses Bootstrap framework version 5, updated from version 4

Sites using the Forty Acres theme or a sub-theme based on Forty Acres will update from Bootstrap 4 to 5. The grid system remains the same, and our team has included backwards-compatibilty affordances. This update should not cause visual or behavioral changes other than minor (pixel-level) spacing differences, as shown in the screenshot below:

Event add-on has modernized the ‘add to calendar’ pop-up

This release includes a visual change to the ‘add to calendar’ pop-up for sites using the Event add-on.

Issue: https://github.austin.utexas.edu/eis1-wcs/utevent/issues/380

Before
After

Site announcement now displays text in readable width

The sitewide announcement body text now wraps at a readable screen width, as shown below.

Issue: https://github.austin.utexas.edu/eis1-wcs/utevent/issues/380

Before
After

Focus indicators are now scoped to browser heuristics

The previous release, 3.20.0, added a two-color focus indicator to ensure sufficient color contrast. However, for some interactions like button and link clicks, this visual indicator is both not required for accessibility and can be visually distracting. Release 3.21.0 refines the use of the focus indicator to use the more modern focus-visible selector, which ensures that the focus indicator is always present during keyboard navigation, but is only visible when visual focus is needed during mouse navigation. The screenshot below shows the focus indicator that will be visible with keyboard navigation but not visible during mouse interaction, since hover indicators are already present:

Issue: https://github.austin.utexas.edu/eis1-wcs/forty_acres/issues/646

Additional developer callouts

• The Drupal Kit now provides a setting for determining whether a site should receive updates to the Full HTML text format. Up till now, we have not updated existing sites’ configuration of the Full HTML text format, since some developers have added their own configuration. Going forward, developers can choose whether or not to receive updates. Sites installed prior to release 3.21.0 will continue not to receive updates unless developers choose to opt in. Sites installed subsequent to the 3.21.0 will initially be configured to receive updates, unless developers choose to opt out. This setting can be controlled at Configuration > Drupal Kit (/admin/config/content/utexas). Issue: https://github.austin.utexas.edu/eis1-wcs/utdk_profile/issues/2289

• The Drupal Kit code includes a library for displaying sliders (also referred to as carousels) called Accessible360 Slick. This release adds a modified version of that library that is compatible with contemporary versions of jQuery. Developers who have created custom implementations that rely on that library should switch to the new version after updating to 3.21.0 and before our future release that updates to Drupal 11. The new version can be included as a Drupal asset library by declaring a dependency on utexas/accessible-slick. For details on the code change, see https://github.austin.utexas.edu/eis1-wcs/utdk_profile/issues/2554 . For questions about how to transition code to the new library, contact us at drupal-kit-support@utlists.utexas.edu

Drupal core updates

• https://www.drupal.org/project/drupal/releases/10.3.6 (Bugfix release)

• https://www.drupal.org/project/drupal/releases/10.3.7 (Bugfix release)

• https://www.drupal.org/project/drupal/releases/10.3.8 (Bugfix release)

• https://www.drupal.org/project/drupal/releases/10.3.9 (Security release)

• https://www.drupal.org/project/drupal/releases/10.3.10 (Bugfix release)

Contributed module updates

Modules included with the UT Drupal Kit installation profile

• Add to Any: from 2.0.5 to 2.0.7

• Admin Toolbar: from 3.5.0 to 3.5.1

• Diff: from 1.7.0 to 1.8.0

• Layout Builder Styles: from 2.0.0 to 2.1.0

• Linkit: from 6.1.4 to 6.1.6

• Metatag: from 2.0.2 to 2.1.0

• Pantheon Advance Page Cache: from 2.2.0 to 2.3.1

• Responsive Tables Filter: from 1.18.0 to 2.0.2

Modules included with the News add-on

Search API: from 1.35.0 to 1.36.0

Modules included with the Event add-on

• Add to Calendar Date Augmenter: from 1.2.1 to 1.2.3

• Fullcalendar View: from 5.2.2 to 5.2.3

• Smart Date: from 4.1.6 to 4.2.1

Modules included with the Profile add-on

• None

All changes since 3.20.3

UTexas installation profile (20)

• Bug: Site announcement always shows “Inactive” when returning to form #2657

• Task: Update coding standards to match new rules #2661

• Task: [After update to 10.3 (Release 3.21.0)] Uninstall “Layout Builder Expose All Field Blocks” #2636

• Enhancement: [CTA Component] - Update URL field to use Linkit #2655

• Bug: responsive_tables_filter 2.0.1 is stripping out html found in a <th> tag #2648

• Enhancement: Provide screen-reader-only text for links that open in new window/tab #1007

• Task: Document update hook preservation policy #2663

• Task: Replace deprecated file_validate_extensions with ‘file.validator’ service #2666

• Task: jQuery 4 compatibility: Accessible 360 Slick Library #2554

• Enhancement: Site Announcement: constrain announcement body text to readable width #2676

• Task: Convert jobs to use wcs-gh-p02-group #2366

• Task: Update kernel-provided Bootstrap utility libraries to version 5 #2572

• Enhancement: Disable “Apply blur to image?” when no background image is used #2633

• Enhancement: Provide configuration for opt-in/opt-out of receiving configuration updates for Full HTML text format #2289

• Enhancement: Set default block title to “AddToAny” blocks to “Share this content” and “Follow us” #1867

• Bug: Bootstrap 5 default ‘dropdown’ CSS is missing #2688

• Bug: Scope hook to UTDK blocks #2693

• Bug: Layout builder modal close button color change #2691

• Bug: Performance Degraded after update to Twig 3.14.2 #2687

• Task: Update contributed dependencies #2695

Forty Acres theme (10)

• Task: Override Bootstrap default font color for <code> #667

• Task: PHP Warning: Trying to access array offset #647

• Bug: “No events match the criteria.” message moved alongside buttons #649

• Task: Consolidated utprof css in forty_acres cause alignment issues when using basic view mode in utprof profile listings #653

• Bug: Unlinked main menu L1s with children are no longer keyboard navigable #658

• Task: Investigate removing csscombx #571

• Bug: Bootstrap base CSS introduces unwanted breakpoint behavior #661

• Task: Layout builder modal loading at bottom of screen #663

• Task: Drupal 11 compatibility: set core_version_requirement to be compatible with Drupal 11 #664

• Enhancement: Distinguish focus indicator from focus-visible for links and buttons #646

• Task: Update Forty Acres Bootstrap CSS base & grid system to version 5 #608

News add-on (1)

• Task: Update contributed dependencies #343

Event add-on (5)

• Enhancement: Distinguish whether past or upcoming events are shown in “No event match the criteria” output for /events and /past-events #374

• Task: Add test coverage to confirm that “Add to calendar” button provides basic functionality #379

• Bug: Events time for “midnight” or “noon” show incorrect times on “Upcoming events” listing #383

• Task: Update contributed dependencies #386

• Task: Modify Add To Calendar button/dialog to accommodate changes between v1.1.1 and v1.2.1 #380

Upstream repository (4)

• Task: Ensure all sites are updated to Drupal 10.3 prior to updating to Drupal 11 #165

• Task: Allow Composer plugin composer-xmlprovider-installer for use with Enterprise Authentication #181

• Task: Allow tbachert/spi and dealerdirect/phpcodesniffer-composer-installer Composer plugins #183

• Task: Add simpleSAMLphp plugin via Composer script rather than directly in composer.json #185

Enterprise Authentication integration (2)

• Task: Update simpleSAMLphp from 2.1.1 to 2.3.5 #85

• Bug: Fatal error during SAML authentication due to robrichards/xmlseclibs 3.1.2 #79

• Task: Establish methodology for providing regular maintenance releases #87

Drupal Kit ‘Managed’ integration (1)

• Task: Full HTML updates: set opt-in to TRUE for existing sites and prevent editing #160