UT Drupal Kit 2.21 Release

ITS is happy to announce the immediate availability of UT Drupal Kit 2.21.0, the latest maintenance release for our University distribution of the Drupal web content management system. This release includes a Drupal core update, an update to the SAML identity provider for Pantheon sites, and a number of other small enhancements. Please read on for details.

DRUPAL CORE UPDATE

The 2.21 release incorporates the most recent release of Drupal Core, bringing it up to the latest version (7.69).

SWITCHING TO ENTERPRISE AUTHENTICATION IDP

The Pantheon custom upstream for the UT Drupal Kit includes configuration for adding UT EID-based authentication to a site using the simplesamlphp library. Prior to this release, this authentication method used the UTLogin SAML identity provider (IdP). With the 2.21 release, the default configuration now uses the new Enterprise Authentication IdP.

This change should be completely transparent to site owners, except that users authenticating to their sites should now see the newer login screen associated with Enterprise Authenication, rather than the old UTLogin login screen.

Enterprise Authentication login screen

The Enterprise Authentication login screen

METATAG TWITTER CARDS ENABLED BY DEFAULT

“Metatag: Twitter Cards” is a submodule of the Metatag project, and has been included with the UT Drupal Kit since the initial 2.0 release, but was not enabled by default. The 2.21 release includes an update hook to enable the Metatag: Twitter Cards module by default, and it will also be enabled by default on all new installations.

This module provides support for the Twitter Cards metatag format, to allow greater control over how pages appear when shared on Twitter.

RESPONSIVE SUPPORT FOR VIMEO MEDIA

In the 2.20 release, the Media Vimeo module was enabled for both existing and new sites in order to provide support for video sources from the Vimeo streaming service to be used in Media Library objects.

The 2.21 release adds custom functionality to wrap these videos in a <div> with the flex-video class so that they will behave responsively, providing parity with the Kit’s existing treatment of Media YouTube videos.

DEFAULT STYLING FOR NESTED ORDERED LIST ITEMS

Prior to this release, list items in nested ordered lists all displayed with the default arabic numeral (“1”) list style. In the latest release of the Forty Acres theme, nested ordered lists now have specific list item styles for each level through six nested lists.

SUPPORT FOR SOCIAL SHARING ON EVENTS

The UT Drupal Kit includes a custom module called “UTexas Social Sharing” which implements a social media sharing block that appears by default on articles created using the News add-on feature. The 2.21 release includes an update which now allows site builders to also place the social sharing block on events created using the Kit’s Events add-on feature.

For more information about enabling the social sharing block on events, please see the updated documentation for the Events add-on feature. Additionally, a minor CSS change is required to allow the block to display correctly on events, which is described in the developer  notes for the 2.21.0 release.

HOW TO UPDATE THE UT DRUPAL KIT

Complete instructions and download links for updating a UT Drupal Kit site are available on the documentation wiki. Pantheon site dashboards that use the UT Drupal Kit distribution should see the upstream updates available now; see the Pantheon documentation for more information on applying upstream updates.

Please review the changelog thoroughly, and always make backups of your code, files, and database before proceeding with an update!

NEXT RELEASES

The 2.x (Drupal 7) branch of the UT Drupal Kit is updated on a bi-monthly maintenance release schedule, with releases targeted for the second Tuesday of even-numbered months. The next planned release is UT Drupal Kit 7.x-2.22, due on April 14, 2020. Please see 2020 Release Schedule for UT Drupal Kit for more details.

If you have questions or concerns about the UT Drupal Kit, please feel free to email us at drupal-kit-support@utlists.utexas.edu.

UT Drupal Kit 2.20 Release

ITS is happy to announce the immediate availability of UT Drupal Kit 2.20.0, the latest maintenance release for our University distribution of the Drupal web content management system. This release includes a Drupal core update, several contrib module updates, and a bugfix for print behavior of tables. Additionally, the Media Vimeo module is now enabled by default.

DRUPAL CORE UPDATE

The 2.20 release incorporates the most recent release of Drupal Core, bringing it up to the latest version (7.68).

CONTRIB UPDATES

The 2.20 release includes updates to the following contrib modules:

BUG FIX FOR RESPONSIVE TABLES

The UTexas Tablesaw Filter, which is responsible for dynamically generating responsive table displays via the Filament Group’s Tablesaw Library, was converting tables to a responsive display when webpages were being printed. To fix this issue, Tablesaw responsive behavior is now excluded from print stylesheets so that tables will print using the default “desktop” styling.

MEDIA VIMEO ENABLED BY DEFAULT

The Media Vimeo contrib module has been included with the UT Drupal Kit since the initial 2.0 release, but was not enabled by default. The 2.20 release includes an update hook to enable the Media Vimeo module on existing sites, and it will also be enabled by default on all new installations.

This module allows video sources from the Vimeo streaming service to be used in Media Library objects. This functionality was already provided for YouTube by the Media YouTube module.

HOW TO UPDATE THE UT DRUPAL KIT

Complete instructions and download links for updating a UT Drupal Kit site are available on the documentation wiki. Pantheon site dashboards that use the UT Drupal Kit distribution should see the upstream updates available now; see the Pantheon documentation for more information on applying upstream updates.

Please review the changelog thoroughly, and always make backups of your code, files, and database before proceeding with an update!

NEXT RELEASES

The UT Drupal Kit is released on a bi-monthly maintenance release schedule, with releases targeted for the second Tuesday of the month. The first planned release for 2020 is UT Drupal Kit 7.x-2.21, due on February 11, 2020.

If you have questions or concerns about the UT Drupal Kit, please feel free to email us at drupal-kit-support@utlists.utexas.edu.

UT Drupal Kit 3 – Beta 2 release

ITS has posted the second beta release of UT Drupal Kit 3.0 (UTDK 3).

This release incorporates the 8.8.0-beta1 release of Drupal Core, along with a number of small bug fixes and improvements.

Please visit the UT Drupal Kit 3 documentation for complete release notes and instructions for updating an existing 3.0.0-beta.1 codebase using Composer. The Drupal 8.8.0-beta1 update does include database updates, so be sure to run database updates after updating the codebase.

A note about beta releases

This is a beta release for the next major version of the UT Drupal Kit. Betas are good testing targets for developers and site builders who are comfortable reporting (and where possible, fixing) their own bugs. Beta releases are not recommended for non-technical users, nor for production websites.

How do I get started with UTDK 3?

The first thing anyone interested in starting with UTDK 3 should do is to head over to our brand-new documentation site:

https://drupalkit.its.utexas.edu/docs/

The “What is the UT Drupal Kit?” chapter contains detailed explanations of what the Kit contains, as well as a list of differences between versions 2 and 3.

The “Getting Started” chapter includes technical requirements for running version 3, as well as detailed instructions for setting up an environment on your own local workstation, a LAMP server, or Pantheon.

If you run into problems or have questions, please check the “Support” page for available support options.

 

UT Drupal Kit 2.19.4 Security Release

ITS has posted a patch-level release of the UT Drupal Kit in order to address a critical security vulnerability in the SimpleSAMLphp library.

This release is only available via Pantheon upstream repository, as SimpleSAMLphp is not bundled with the standalone download version of the UT Drupal Kit.

It is recommended that all users of the UT Drupal Kit on Pantheon update their sites with this latest version as soon as practicable.

How to Update the UT Drupal Kit

Complete instructions for updating a UT Drupal Kit site are available on the documentation wiki.

Please review the release notes thoroughly, and always make backups of your code, files, and database before proceeding with an update!

UT Drupal Kit 2.19.3 Release

ITS has posted a patch-level release of the UT Drupal Kit in order to address issues in text formatting behavior that resulted from a change in the previous patch release (see UT Drupal Kit 2.19.2 Release).

The 2.19.3 release includes a new custom input filter that must be installed, enabled, and manually configured as part of the “Filtered HTML” and “Filtered HTML for Blocks” text formats on all existing sites in order to address this issue. The full description of the issue, recommended configuration change, and a root cause analysis are described in a special release notes article on the UT Drupal Kit wiki.

Please read this article carefully, and feel free to email drupal-kit-support@utlists.utexas.edu to open a support ticket if you have any questions before proceeding with the configuration change.

HOW TO UPDATE THE UT DRUPAL KIT

Complete instructions and download links for updating a UT Drupal Kit site are available on the documentation wiki. Pantheon site dashboards that use the UT Drupal Kit distribution should see the upstream updates available now; see the Pantheon documentation for more information on applying upstream updates.

Please review the changelog thoroughly, and always make backups of your code, files, and database before proceeding with an update!

NEXT RELEASES

This release replaces the regularly scheduled maintenance release for October 2019.

The UT Drupal Kit is released on a bi-monthly maintenance release schedule, with releases targeted for the second Tuesday of the month. The last planned release for 2019 is UT Drupal Kit 7.x-2.20, due on December 10, 2019.

If you have questions or concerns about the UT Drupal Kit, please feel free to email us at drupal-kit-support@utlists.utexas.edu.

UT Drupal Kit 2.15 Release

ITS is happy to announce the immediate availability of UT Drupal Kit 2.15, the latest maintenance release for our University distribution of the Drupal web content management system and the final scheduled release for 2018.

The 2.15 release includes an important change to default PHP behavior for Pantheon sites, multiple updates to Drupal core, contrib module updates, several minor bugfixes, and an update to the front-end package list for themes built on the Forty Acres-based STARTERKIT theme.

PHP 7 BY DEFAULT ON PANTHEON CUSTOM UPSTREAM

In August of 2018, Pantheon started specifying PHP 7.1 as the default PHP version in the pantheon.upstream.yml file for their Drupal 7 upstream repository. However, this change occurred after the last release of the UT Drupal Kit custom upstream on Pantheon, so all UT Drupal Kit sites have remained on PHP 5.6 by default until now.

As of version 7.61, Drupal core now passes all tests for compatibility with PHP 7.2, and Pantheon has followed suit by again updating the default PHP version in pantheon.upstream.yml. However, in testing the UT Drupal Kit codebase with PHP 7.2, we have encountered some deprecation notices associated with the Field Collection module, and are therefore staying with PHP 7.1 as the new default for the UTDK custom upstream on Pantheon until this issue is resolved.

We have extensively tested the UTDK codebase with PHP 7.0 and 7.1, and have been running many sites under these older versions of PHP 7 on Pantheon for over a year with no issues (please see “PHP 7, the UT Drupal Kit, and You” from April 2017 for additional discussion). However, any sites with custom code, additional contrib modules, or even certain configurations could still potentially uncover untested cases and encounter PHP 7 incompatibilities. Therefore, we strongly recommend that site owners thoroughly test this release in the DEV/TEST environments before deploying it to the LIVE environment.

If you wish to apply the upstream updates without testing PHP 7 compatibility for your site at this time, then you can first add a pantheon.yml file to the site repository to pin the site’s PHP version to 5.6 until such time as you can test and deploy PHP 7 to your site using Pantheon’s recommended approach. But keep in mind that PHP 5.6’s security support phase ends at the end of 2018. Pantheon will continue to offer PHP 5 support for the time being, but they will eventually remove unsupported versions of PHP from the platform.

DRUPAL CORE UPDATES

The 2.15 release incorporates two versions of Drupal core that have been released since the last UTDK release in August 2018.

Version 7.60 was a security-only release, and the only major change in version 7.61 was compatibility with PHP 7.2 (though as noted, this compatibility does not currently extend to the full UT Drupal Kit codebase).

For complete details about these core updates, please review the release notes:

CONTRIB UPDATES

The 2.15 release includes updates to the following contrib modules:

Please note that because of the interval since the last Drupal Kit release, and depending on the current version of the Drupal Kit distribution on your installed site, some of these contrib updates may represent jumps of multiple versions.

Please check your currently installed module versions and review the release notes on Drupal.org for any additional releases that will be incorporated in this update.

BUG FIXES

  • Fixed an issue that could result in blocks not being visible on Page Builder-enabled content types due to naming conflicts
  • Updated CSS to eliminate orphaned text on floated images placed inside the WYSIWYG A or WYSIWYG B fields
  • Fixed an issue in which use of the <nolink> attribute on a Hero Photo field’s link attribute could cause improper rendering

FRONT-END PACKAGE UPDATES

The list of packages defined in the STARTERKIT subtheme’s package.json and package-lock.json files have updated in this release in order to maintain compatibility with the current stable releases of node and npm.

For full details and instructions for updating your subtheme, please review our special release notes.

HOW TO UPDATE THE UT DRUPAL KIT

Complete instructions and download links for updating a UT Drupal Kit site are available on the documentation wiki. Pantheon site dashboards that use the UT Drupal Kit distribution should see the upstream updates available now; see the Pantheon documentation for more information on applying upstream updates.

Please review the changelog and special release notes thoroughly, and always make backups of your code, files, and database before proceeding with an update!

NEXT RELEASES

The UT Drupal Kit is released on a bi-monthly maintenance release schedule, with releases targeted for the second Tuesday of the month. The first planned release for next year is UT Drupal Kit 7.x-2.16, due on February 12, 2019.

If you have questions or concerns about the UT Drupal Kit, please feel free to email us at drupal-kit-support@utlists.utexas.edu.

No UT Drupal Kit Release for October 2018

The next scheduled bi-monthly release of the UT Drupal Kit was set for October 9, 2018. Due to a lack of new changes, this release has been canceled, and our next maintenance release will now be scheduled for Tuesday, December 11, 2018.

If you have questions or concerns about the UTDK release cycle, please feel free to email us at drupal-kit-support@utlists.utexas.edu.

UT Drupal Kit 2.14 Release

ITS is happy to announce the immediate availability of UT Drupal Kit 2.14, the latest maintenance release for our University distribution of the Drupal web content management system.

The 2.14 release includes several bugfixes, developer-focused enhancements, and a number of contrib module updates.

BUG FIXES

  • Fixed an issue that resulted in errors when trying to clone nodes that do not use the Page Builder system
  • Fixed an issue with table border properties not being respected in Safari
  • Investigated an issue with center justification on table headers. A workaround has been documented in the UT Drupal Kit wiki
  • Updated CSS for responsive tables to enforce left-alignment of table cells at mobile/phone breakpoint

DRUSH LOCK FILES FOR CONTRIB MODULES

In order to prevent accidental updating of contrib modules included in the Drupal Kit distribution, a .drush-lock-update file has been added to the root directory of each contrib project. The presence of this file prevents Drush from updating modules using the drush pm-update command.

With these lock files in place, site owners can safely use the drush pm-update --no-core command to update contrib modules that have been added to their codebase without fear of accidentally updating modules included in the UT Drupal Kit distribution.

Please note that Drupal Core and all contrib modules included with the distribution should NEVER be updated independently of a new UT Drupal Kit release. Please review the upgrade documentation for further details.

DRUSH RUNTIME CONFIG FILE

The 2.14 release adds a new file at sites/default/drushrc.php which implements a default Drush Runtime Config file.

This file, located at sites/default/drushrc.php, contains many examples of possible Drush configuration settings that can be discovered and applied when running Drush commands on a specific site. For more information about the possibilities of using this functionality, review the example file at

http://api.drush.org/api/drush/examples%21example.drushrc.php/7.x.

Because this file is included in the UT Drupal Kit distribution, it should not be modified by developers. Instead, site-specific configuration directives should be placed in a file named sites/default/drushrc.site.php, and directives for local development environments should be placed in a file named sites/default/drushrc.local.php. These files are automatically detected and loaded by include statements at the end of the sites/default/drushrc.php file.

UPDATED BEHAT CONFIGURATION

The configuration for running the Behat functional tests included with the UT Drupal Kit distribution has been updated to switch from using Selenium with an older version of Chrome to run the tests, to using Chromedriver with the latest version of Chrome.

The current documentation for setting up an environment to run the tests is in the distribution package at profiles/utexas/tests/Behat-Setup.md.

CONTRIB UPDATES

The 2.14 release includes updates to the following contrib modules:

Please note that because of the interval since the last Drupal Kit release, and depending on the current version of the Drupal Kit distribution on your installed site, some of these contrib updates may represent jumps of multiple versions.

Please check your currently installed module versions and review the release notes on Drupal.org for any additional releases that will be incorporated in this update.

HOW TO UPDATE THE UT DRUPAL KIT

Complete instructions and download links for updating a UT Drupal Kit site are available on the documentation wiki. Pantheon site dashboards that use the UT Drupal Kit distribution should see the upstream updates available now; see the Pantheon documentation for more information on applying upstream updates.

Please review the changelog and special release notes thoroughly, and always make backups of your code, files, and database before proceeding with an update!

NEXT RELEASES

The UT Drupal Kit is released on a bi-monthly maintenance release schedule, with releases targeted for the second Tuesday of the month. The next planned release for this year is UT Drupal Kit 7.x-2.15, due on October 9, 2018.

If you have questions or concerns about the UT Drupal Kit, please feel free to email us at drupal-kit-support@utlists.utexas.edu.

Coming Soon: UT Drupal Kit 2.3

We are on the cusp of releasing our latest iteration of UT Drupal Kit: version 2.3. As with its predecessors, this release includes Drupal updates and also comes with a number of new features.

Highlights

  • Security updates: Drupal 7.50 & contributed modules. Developers with existing Drupal Kit sites should follow UT Drupal Kit update steps as soon as possible.
  • An events content type is available as a standalone download.
  • Announcements can be displayed on the homepage or sitewide, with a variety of display options.
  • Drupal Kit sites can now be installed on or migrated to Pantheon‘s hosting service.
  • Twitter widget improvements: accessibility & retweet profile images.
  • Blocks from any contributed module can be configured to be available in the drag-and-drop Page Builder tool.
  • <object> and <param> tags (in addition to <script> and <iframe>) are now allowed to trusted content editors via the Blocks interface.
  • Pathologic and View Unpublished modules added.
  • A “Last Updated” timestamp can be displayed on a per-page basis.

Continue reading