UT Drupal Kit 3.14.0 release notes

Release date - September 26, 2023

Contents

Release summary

The 3.14.0 release is part of the Drupal Kit’s normal, bi-monthly maintenance release schedule. There are two substantial enhancements included in this release: the ability to draft content prior to publication, and the ability to apply display styles through the rich text editor. These, along with other of-note changes, are described below.

Ability to create content drafts prior to publishing

All new and existing sites that do not already define a process for drafting content are now able to create pages in “Draft”, “Published”, or “Archived” state, where previously those pages could only be set to “Published” or “Unpublished”. This will affect the Basic Page and Flex Page content types and, if present on the site, the News, Event, and Profile content types. All existing content will initially retain its current status as either “Published” or “Unpublished”. Going forward, content editors can create new revisions of content in any of the new states:

  • “Draft” versions of the page are not visible to the general public; content editors can preview these staged changes through the “Latest version” tab

  • “Published” versions of the page replace the previously published version, and are viewable by the public

  • “Archived” versions of the page replace the previously published version, presenting users with an “Access Denied” (403) message. The page remains accessible in the system, and content editors can republish it if desired.

Comprehensive documentation is forthcoming.

Selected styles can be applied to rich text through the “Styles dropdown”

Drupal’s default rich text editing tool, CKEditor, provides a toolbar plugin for applying display styles to specific elements, such as a button-styled hyperlink or a fancy title design for heading text. Until to this point, the Drupal Kit had not included this feature; the 3.14.0 release introduces the “Styles dropdown” for the Flex HTML and Full HTML Text formats. In this release, the available styles are limited to setting borders for HTML tables. More styles will be added in future releases.

For developers

Developers may supplement the available styles, but should use Drupal’s Configuration Override System to ensure that their modifications are retained during subsequent updates. An code example of adding a style to the dropdown is found in Drupal Kit Examples.

Path exclusions for Google Tag Manager have been standardized

The Drupal Kit uses a contributed module, Google Tag Manager, to embed Google’s tool of the same name, a tool commonly used for page tracking and analytics. Over time, the default settings for Google Tag Manager changed. This release standardizes those the default page exclusions for new and existing sites: the container will not be present on Page Not Found (404) or Access Denied (403) pages, and will not be present on administrative pages.

For developers

Developers who have modified Google Tag Manager page exclusion settings should note their modifications before updating, and then reapply those modifications after the 3.14.0 update.

Multi-item components are now draggable and removable

Content editors building content with components such as Quick Links and the Flex Content Area will notice a change in the editing interface: each item in these components can now be reordered through a drag-and-drop interface and can be deleted with a new “Remove” button. The full list of components that have new this editing capability is:

  • Flex List

  • Flex Content Area

  • Hero Carousel

  • Promo List

  • Promo Unit

  • Quick Links

  • Resources

Drupal core updates

The 3.14.0 release incorporates the most recent release of Drupal core for the 10.1 minor release branch, bringing it from version 10.1.1 to 10.1.4.

Here are the release notes for all Drupal core releases inclusive in this release:

Contributed module updates

The following contributed modules are updated in this release.

Modules included with the UT Drupal Kit installation profile

Modules included with the Event add-on

All changes since 3.13.1

UTexas installation profile (26)

  • Enhancement: Exclude drupal.org-specific syntax checking #2273

  • Enhancement: Manage table border through user interface in CKEditor5 #2131

  • Task: [Hero image] Relocate “Image anchor position” field description above radio buttons #2262

  • Enhancement: [Flex list] Display field__label in Flex list field.html.twig #2260

  • Enhancement: [Promo List] Add form text that explains that the headline can be linked #2254

  • Task: Add module description to UTexas Text Format Flex HTML #2252

  • Task: Evaluate new major version release of Google Tag Manager for update #2204

  • Task: Replace patch for Entity Clone that excludes entity types with built-in module solution #2227

  • Enhancement: Ability to create content drafts prior to publishing #1895

  • Enhancement: [Resource component] Make individual items removable, draggable, addable, and collapsible #2293

  • Enhancement: Investigate better ways to add anti-flicker JS #2271

  • Enhancement: [Hero Carousel] Make individual items removable, draggable, addable, and collapsible #2300

  • Enhancement: [Promo Unit] Make individual items removable, draggable, addable, and collapsible #2291

  • Enhancement: [Flex List] Make individual items removable, draggable, addable, and collapsible #2299

  • Enhancement: [Flex Content Area] Make individual items removable, draggable, addable, and collapsible #2292

  • Task: Remove “Placeholder for the moderation control field” block from Flex pages #2316

  • Enhancement: Standardize path exclusions for Google Tag Manager on existing sites #2302

  • Enhancement: [Promo List] Make individual items removable, draggable, addable, and collapsible #2295

  • Bug: Google Tag Manager 2.x no longer provides default path/response code exclusions #2301

  • Bug: Form layout when the “main” region has a smaller height than the “secondary” region is broken #2247

  • Task: Update contributed dependencies #2322

  • Task: [Quick Links] Make individual items removable, draggable, addable, and collapsible #2294

  • Enhancement: Vertically align “Remove item” button to top on components with remove buttons #2310

  • Task: Update to Drupal core 10.1.4 #2331

  • Task: Install Metatag OpenGraph module on new and existing sites #2306

  • Enhancement: Create ADR to define configuration for Basic Page content type #2325

  • Task: Add “view any unpublished content” to for roles on existing sites receiving new Workflow-related permissions #2335

    • Task: “Moderated content” display does not show all expected moderated state content #2338

Forty Acres theme (2)

  • Task: Manage table border through user interface in CKEditor5 #497

  • Task: Update frontend build dependencies #501

Profile add-on (2)

  • Task: Run automated test suite as a GitHub Action check on pull requests #357

  • Enhancement: Ability to use “Standard workflow” on Profile nodes #361

News add-on (3)

  • Task: Add basic automated test coverage for Create, Read, Update, and Delete actions #265

  • Task: Run automated test suite as a GitHub Action check on pull requests #266

  • Task: Ability to use “Standard workflow” on News nodes #271

Event add-on (7)

  • Task: Update to smart_date 4.x #274

  • Bug: Event listing page doesn’t include periods for “a.m.” and “p.m.” time display #262

  • Task: Refactor AddToCal customizations when updating to addtocal_augment 1.1.0-beta2 #266

  • Task: Add basic automated test coverage for Create, Read, Update, and Delete actions #270

  • Task: Run automated test suite as a GitHub Action check on pull requests #271

  • Enhancement: Ability to use “Standard workflow” on Event nodes #289

  • Task: Update contributed dependencies #286

Documentation (19)

  • Task: Document available styles that can be applied to HTML elements in rich text editors #495

  • Task: Correct typo in first bullet of “Append an icon to a link” #483

  • Task: Add text about nine image limit to Instagram documentation #476

  • Task: Document Forty Acres’ build process compatibility with Node version 20 #500

  • Enhancement: Document usage of table head and its corresponding effect on full-width table styling #496

  • Task: Update documentation relating to location of Block library #504

  • Enhancement: Provide guidance on adding page-specific Open Graph images for social media #454

  • Bug: Typo in “Setting Page Options” #510

  • Task: Add example of admonition for developers #516

  • Task: Revisit documentation around Pantheon SAML integration version constraint for new integrations #473

  • Task: Define issue templates that better reflect the types of documentation changes made #522

  • Bug: Typo: email address “drupal-kit-admins” should be “drupal-kit-support” #514

  • Task: Document that “Border” styles may be added to all components #308

  • Enhancement: Add automated enforcement of Docs style guide #91

  • Task: Develop allow list for Vale-based spelling false positives and remediate misspellings #518

  • Enhancement: Document how to use “Move” function in “pencil” contextual menu #108

  • Task: [Internal] Update documentation guidelines to explain how we handle images (figures) with alt text and captions #507

  • Task: Update Qualtrics embed information with accessibility guidance #472

  • Task: Detail settings.php inheritance for sites #371

Drupal Kit ‘Managed’ integration (2)

  • Task: Update outdated “UTDK - Managed” sites to latest release of UT Drupal Kit #139

  • Task: Add hook for updating full HTML text format #138

Migration tool (2)

  • Task: Update google_tag_manager migration to work with version 2.x #322

  • Task: Remove Twitter Widget #321