This section provides information on releases, including how to find release notes, compatibility information, and upgrade instructions.
Finding Releases
Releases for Drupal core and contributed projects are typically found on their respective project pages on Drupal.org. Look for links labeled “Downloads” or “Releases”.
Release Notes
Release notes provide detailed information about a specific release, including:
New features
Bug fixes
Security updates
Upgrade instructions
Known issues
API changes
Always review the release notes before upgrading to a new version.
Compatibility
Before upgrading, ensure that the new release is compatible with your current Drupal version, PHP version, and other dependencies. Compatibility information is usually included in the release notes.
Upgrade Instructions
Follow the upgrade instructions provided in the release notes carefully. Back up your database and files before starting the upgrade process. Test the upgraded site thoroughly before making it live.
Security Releases
Security releases address critical security vulnerabilities. It is highly recommended to upgrade to the latest security release as soon as possible. Security releases are often designated with a version number that includes “.x” (e.g., 9.1.x).
Contributed Modules and Themes
Remember to check for updates and releases for your contributed modules and themes regularly. Keeping these up-to-date is crucial for maintaining the security and stability of your Drupal site.
Full list of components and content types that will be available in the Small Y Template. The Small Y Template utilizes the
Small Y module. Note that Paragraphs are removed from configuration settings for the Small Y Template.
Navigation / Menus
Global Header
Utility Menu
Mega Menu
Global Footer
Breadcrumbs
Banners
Tall Hero Banner
Sub-page Hero Banners
Chevron
Frame
Promo Banner
Simple Content / WYSIWYG / Tables
Cards
Ping Pongs
Icon Grid
Statistics
Testimonials
Staff
Location Finder
Accordions
Carousels
Partners
Tabs
Branches / Facilities
Branch Amenities
Branch Social Links
Articles
Article Views & Filters
Related Articles
Events
Event Views & Filters
Related Events
Alerts
Donations
Webforms
Search Results
Layout Builder Updates
Continuing general cleanup, updated documentation, and improvements to the content editing experience for new Layout Builder components and content types.
Layout Builder - Event CT - Created ’term pages’ for Event category tags to display all event items tagged with that term. (#1279)
Layout Builder - Simple Content / WYSIWYG - Added styles for highlighted text that was missing in the 4 Colorways. (#1508)
Layout Builder - Event & Article listings
Allow editors to choose how many items to show in Events & Articles Listing views - 3, 6, or 9. (#1542)
Allow editors to choose the type of article to display - News, Press Release, Blog. (#1663)
Layout Builder - Header - Y Logo / Areas of Impact updates - made 2 configuration options available in the distribution. (#1546)
With tagline
Without tagline
Layout Builder - Banners - Headers for in-page banners default to H2 to prevent multiple H1 banners being placed on a page. This prevents multiple H1 banners from being placed on a single page, which impacts SEO and accessibility. (#1552)
Activity Finder / Schedules
Added several styling fixes for the Colorways for Activity Finder. (#1625)
Activity Finder - Added a new “Skip wizard” option on the Activity Finder v4 block that hides the “Start your search for an activity…” wizard and takes users directly to the results (with any filters applied). (#1578)
Continuing general cleanup, updated documentation, and improvements to the content editing experience for new Layout Builder components and content types.
WYSIWYG / Simple Content - Created the ability for Y admins / content editors to copy text from Word and paste it into the WYSIWYG, and have the WYSIWYG clear out text formatting from Word. (#1308)
Social Sharing - Updated the y_lb share block to replace the Twitter logo with the X logo. (#1440)
Partners component - Heading size matches other components. (#1576)
Mega Menu - Allow Menu CTA to reference existing blocks. (#1583)
Design System Updates
Colorways - Set up Schedules styles so that they follow the established YUSA Colorway. (#1358)
Worked to resolve font size issues between YUSA & Y Canada Headings. (#1399)
Activity Finder / Schedules / Y360 Updates
[Y360] Improved Date Handling and Error Management in OpenY Repeat Module (#1535)
[Repeat Schedules] Added URL for studios/rooms. (#1584)
[Simple Schedules] Set up display weekly simple schedules with anonymous site users. (#1554)
[Simple Schedules] Fixed location of Event modal window for content editors. (#1598)
Sandboxes
Fixed a critical Search API issue in the Sandboxes. (#1539)
For users who wish to apply all the updates below without Drupal 10.2, we’ve released
YMCA Website Services 10.3.2.4. This can be applied as a stepping stone to Drupal 10.2, but we recommend moving to 10.2 as community security support for Drupal 10.0
ended in December 2023.
Updated to Drupal core version 10.2. (#758)
NOTE: This release will work with Drupal 10.1 or Drupal 10.2. Run composer require drupal/core-recommended:"^10.1" -W to force your site to use Drupal 10.1.
Updated to OpenY map version 5.2. (#1497)
Layout Builder Updates
Continuing general cleanup, updated documentation, and improvements to the content editing experience for new Layout Builder components and content types.
Memberships - Membership Calculator can be placed in a page using Layout Builder. (#555)
Schedules - Schedules can be placed in a page using Layout Builder. (#1341)
Mega Menu - Allow main menu items with <nolink>. (#1299)
Footer - Added hover states to Y footer logo and social icons, fixed spacing on social icons. (#1356)
Events - Made End Date/Time field optional. (#1386)
Events - Set up metatags and configured Schema.org for new Layout Builder Events content type. (#849)
Events - Enabled ‘Schedule for publishing’ option for the Layout Builder Event content type for content editors to schedule an event to publish at a specific date / time. (#1359)
Articles - Enabled ‘Schedule for publishing’ option for the Layout Builder Article content type for content editors to schedule an article to publish at a specific date / time. (#1492)
Landing Pages - Enabled ‘Schedule for publishing’ option for the Layout Builder Landing Page content type for content editors to schedule landing pages to publish at a specific date / time. (#1493)
Cards - Improved styling for buttons using the “overlapping” style configuration. (#1305)
Cards - Added text formatting to the Card description field. (#1464)
Branch Amenities - Made field_amenities_icon optional so that content editors do not have to include icons. (#1401)
Alerts - Translated Alerts should show the correct/current language. (#1453)
Design System Updates
Colorways - Updated Search Results page to match the 4 Colorways. (#1398)
Colorways - Updated Activity Finder to match the 4 Colorways. (#1340)
Colorways - Ensured Montserrat is being used as the Heading font for Canadian Colorway. (#1407)
Colorways - Ensured Montserrat is being used as body text for the Canadian Colorway. (#1378, #1454)
Added support for responsive favicons to the Distribution. (#1287)
Activity Finder Updates
Added advanced filtering to include additional filters. (#384)
Time of day
Start month
Duration
Included in Membership
Internal Weekly Schedules Updates
Y admins can now access the Create/Edit form component on the FrontEnd APP in the Schedules admin interface. (#1276)
Changed configuration for the color picker field so it is set via the category in the activity content type, and not in the session. (#1400)
Fixed an issue with the close button being hidden for the Schedules modal. (#1388)
Admin / Content Editor Enhancements
Fixed the height for the media directories browser so that admins can view the footer section containing the “Select Media” button without resorting to scrolling. (#1417)
Added help / description text for new Activity Finder filters. (#1494)
Sandboxes
Added a new sandbox for the Traction Rec Activity Finder integration. (#1328)
Camp Content Type - Documented how to use the
Camp Content Type in Layout Builder. (#1313)
Bug Fixes
Menus - Fixed issue with menu links with long text not wrapping on mobile devices. (#1337)
LB Testimonials - Adjusted the line height of the Testimonial component. (#1365)
Membership Framework - Users no longer redirected to an empty page after selecting a membership product. (#1418)
LB Camp Menu / Microsite Menu - Fixed issues with mobile Camp Menu styles. (#1422)
LB Donate - Fixed issue with content editors not being able to add the Donate component. (#1425)
Resolved PHP message: Error: Call to a member function getEntityTypeId() on null (#1426)
LB Cards - Ensured Card top corner settings apply when no image is displayed. (#1431)
LB Cards - Fixed issue with Overlay Card variation title spacing when no image is displayed. (#1432)
LB Cards - Resolved an issue with incorrect button display for Cards with longer titles. (#1465)
LB Camp Content Type - Ensured Alerts on Camp nodes can be closed on mobile devices. (#1450)
LB Home Branch Feature - Resolved an issue where the branch location changes to the previously set location when the user unchecks the “Don’t ask me again” box. (#1421)
Continuing general cleanup, updated documentation, and improvements to the content editing experience for new Layout Builder components and content types.
Reviewed Branch, Camp, and Facility content types to reduce “CSS bleed” when Layout Builder is not used. (#1023)
Update build script to use the latest yusaopeny-project version on Sandboxes. (#1303)
Created upgrade path for btbutton ckeditor4 plugin. (#723)
Added new feature to handle internal weekly schedules, including:
Creating a front end admin interface for admins to edit / manage weekly schedules content. (#1266)
Added drag & drop functionality to the calendar for admins to manage weekly schedules content. (#1269)
Created weekly and daily calendar views for schedule content. (#1268)
Extended the functionality of the Promotion Content type to allow for use in more components and to allow admins to easily order promotional content. (#1175)
Event (LB) Content Type Updates
Leveraging the
Smart Date module to allow for more flexibility for Event displays. (#910)
Improved front end display for a variety of event types all-day, single-day and multi-day events. (#495)
Made some front end design changes to the Event Content Type to include:
Updated icons for calendar and location.
Updated Event node page sidebar design.
Improved Event card linking UX.
Removed the redundant ‘Locations’ section from the body area on the Event node page. (#1280)
Improved handling for recurring events. (#942)
SEO
Added configuration options for ‘search_page_id’ and ‘search_query_key’ to Google Search settings. (#1254)
Updated the ‘Y Styles’ admin interface to include titles for icons, so that site builders can more easily understand the available style configuration options. (#1278)
Layout Builder Articles Listing - Fixed issue where Articles Filter did not search article body. (#1288)
Credit: Carol Petrossi @ ImageX
Layout Builder Programs CT - Fixed issue where Banners were not displaying edge-to-edge. (#1277)
Resolved the 500 error occurring on the /demo-location-finder path after installing the standard YUSAOpenY profile in the open-y-subprojects/openy_map repository. (#1298)
Fixed deprecation notice in strip_tags() function (#1344)
Credit: Roman Salo @ 5Jars
Fixed openy_repeat so it can be used as a Schedules page filter. (#1100)
Applied javascript cookie patch. (#1346)
Credit: YMCA Denver
Polyfill CDN Issue Affecting YMCA Schedules pages, which was experiencing errors due to issues with the polyfill CDN, resulting in JavaScript aggregation problems. More information can be
found in our documentation. (#1351)
Virtual Y 1.9.0
Annotated release notes. Full changelog on
GitHub.
Promotions are pieces of content with scheduled start and end dates that can be used for displaying internal marketing and ad campaigns. Content editors can easily schedule, manage and place multiple promotions throughout their website via the Drupal admin interface.
The first version of this content type allows content editors to place promotions inside the Card component (for Layout Builder), as a hero banner, as promo cards, as a ping pong component or as interstitial content within Activity Finder.
Learn more in our docs.
Layout Builder Updates
Continuing general cleanup, updated documentation, and improvements to the content editing experience for new Layout Builder components and content types.
Facility Content Type - Updated the behavior of Contact / Hours fields so that content editors can include custom contact and hour information for a facility. (#1057)
Facility Content Type - Included ability to add custom hours on Facilities; currently, it is inherited from Branch CT. (#1119)
LB Location Finder - ‘Get Directions’ link on a Branch card should link to the Google Map of the location. (#1132)
Removed a dependency on lb_branch_hours_block. (#1071)
Credit - Andy Fowlston
LB Menus & Navigation - Clarified header / footer region display names so that each region has a unique, easy-to-understand title. (#1055)
LB Mega menu - Resolved hierarchical issues, making top-level pages clickable and including indicators for parent / child relationships. (#1196)
Cleaned up error messages that were blocking content entry in the Layout Builder sidebar. (#827)
Resolved an issue with LB content types being excluded from the Default sitemap in the ‘Simple XML Sitemap’ module configurations. (#1197)
Credit - Jeremy Weedman
LB UX - Fixed the display of Drupal admin warnings and messages. (#828)
Made vertical spacing between components more consistent. (#1167)
LB Cards - De-duplicated code in twig templates. (#1135)
Included Home Branch, Icon Grid, LB Facility, and LB Camp in default standard install. (#1061)
Core, Security & Performance Updates
Update to Drush v12. (#807)
Allowed plugin definitions caching to resolve a caching performance issue. (#1220)
Credit: Andrey Maximov
CKEditor 5
Upgraded from png to svg icons for CKEditor 5 compatibility. (#1194)
Admin / Content Editor Enhancements
Migration from old block + paragraph approach to block + block sub-item approach for Layout Builder. (#’s 301-306, #1087)
Ensured Alert previews display only selected paths. (#1059)
CKEditor 5 - Fixed issue where Selecting “Source” made WYSIWYG text invisible. (#1063)
Layout Builder - Resolved issue with the live site UI menu displaying on top of the admin UI, preventing content editors from accessing the admin UI. (#1060)
Layout Builder - Preferred / Home Location feature - Resolved issue with button alignment (#1052)
Layout Builder - Preferred / Home Location feature - Linked Home Branch link in header to selected Branch page, and the chevron/drop down to the modal to select a different Branch. (#1053)
Resolved an issue with menu items with icons not saving. (#1067)
Added missing config to Articles and Events Content Types. (#1068)
Included Alert Rearrange in Admin menu. (#1074)
Set up schema_article module to be enabled with config. (#1062)
Removed a duplicate instance of media_entity_document in composer.json. (#1113)
Ensured there are no failed patches on composer install. (#1039)
Resolved an error when upgrading from Drupal 9.5.9 to 10.3.0 (#1131)
Credit: Kerry Knopp
Fixed openy_hours_formatter so it can handle non-time entries, i.e. ‘Closed’. (#1105)
Expanding upon the June 2023 release, we are making the final set of page components and content types compatible with Layout Builder. We have also improved the design and functionality of some existing components and content types.
Made VirtualY compatible with Layout Builder and Drupal 10. This enhancement allows content creators to utilize Layout Builder’s drag-and-drop interface for designing Virtual Y pages, and ensures compatibility with the latest Drupal version.
Bug Fixes
Resolved issues with Virtual Y Live Chat and created documentation. This ensures a smoother live chat experience for users. See the Virtual Y Live Chat documentation for details.
Added a fix to ensure that autologout doesn’t occur if a user is playing a video. This prevents interruptions during video playback.
Fixed some minor bugs related to 1:1 meetings. Addresses issues with scheduling, joining, and overall stability of the 1:1 meeting feature.
Expanding upon the March 2023 release, we are making additional page components and content types compatible with Layout Builder.
Learn more in our docs.
The final set of components and content types will be completed in the September 2023 release.
Global Header / Footer Elements
All the components needed for a configurable header and footer, including logo, search, translate menu, main menu, footer, etc.
Existing Layout Builder components have been modified to improve accessibility compliance and include use of brand colors.
Cards
Updated Card styles to make the text over image more accessible and include additional brand colors.
Carousels
Updated Carousels to remove the text and CTA covering the image, and placed controls below the component to reduce visual noise; included additional brand colors.
Statistics
Updated Statistics to remove text, statistics and CTA overlaying the image, and placed them in their own distinct elements; included additional brand colors.
Sidebar Menu
Sidebar Menu updated to include additional brand colors.
Tabs
Tabs updated to include additional brand colors.
Drupal Core Update
Updated the YUSA Distribution to the most recent stable version of Drupal Core - Drupal Core 10
Activity Finder / Schedules
Resolved an issue with keyword search not working
Patched a security issue that allowed malicious redirects
Locations & Maps
Branches - Hid Holiday hours if it contains no content, and ensured Holiday hours display if the current date is a holiday
Allowed Canadian addresses on Branch Layout Builder pages
UX Improvements
Resolved issue with Focal Point module that was causing issues with the front end display of responsive images
Admin / Content Editor Updates
Set the global default theme to Carnation
Removed “Font” and “Size” options from WYSIWYG styles
Design System - Y Styles
“Y Styles” helps site builders customize their sites in an accessible and brand-compliant manner.
A new Article content type combines all news-related content types into a flexible content type and allows content editors to include Layout Builder components within an article page.
Single level sub-menu that displays within a branch page (and sub-pages) that allows users to drill down to additional content specific to that branch.
Included node_revision_delete in distribution w/ default settings
Drupal Core Update
Updated the YUSA Distribution to the most recent stable version of Drupal Core - Drupal Core 9.5.
Activity Finder / Schedules
Resolved an issue with the guided flow for Activity Finder not showing results if users skip a step
Admin alert for Daxko API updates - Created an alert message for admins that directs Y admins to update from GroupEx to the newer version of the Daxko API, along with
documentation on how to make the update.
Removed a filter within the Code block that was preventing direct pasting of GroupEx Pro embed codes.
Locations & Maps
Allow “Directions” link text to be customized by content editors
UX Improvements
404 Page Improvements - users who reach a 404 page will see a 404 page with the association’s basic contact information and a contact webform
Admin / Content Editor Updates
Created documentation for all YUSA Sandbox environments.
Added a
Glossary to Website Services documentation.
Sandboxes, Event Content Type - ensure dates for demo event content are always set to be in the future.
Included node_revision_delete in distribution w/ default settings
Bug Fixes
Resolved an issue with H2 text size not displaying correctly
Removed Google Translate logo from Select Language menu
Virtual Y 1.6.5
Annotated release notes. Full changelog on
GitHub.
Updates & New Features
9.4 Virtual Y Update
Updated Virtual Y to version 9.4.
Bug Fixes
Virtual Y: In Event Series, Host’s Name is not editable
The Host’s Name is now included as an editable field when updating an existing Event Series. It will copy the values from the editable Instructor field upon each Save.
Virtual Y: Released bug fixes - April 2022
Removed additional styling below the menu.
Chat: Fixed an issue with Chat to remove message history/previous chat.
Fixed an issue with the page layout breaking for small videos.
Resolved an error that was displaying when admin tried to install the Virtual 1:1 Meeting module.
Fixed an issue with megamenu links going to the secondary menu.
Resolved an error that was displaying when admin tried to create an export file with logs.
Resolved an error that was displaying when admin tried to install the Open Y Virtual YMCA Search module.
Resolved an error that was displaying when admin tried to install the Open Y Virtual Y shared content server module.
Resolved an error that was displaying when admin tried to install the Virtual Y Shared Content module.
Resolved an error that was displaying when admin tried to export Users logs.
Fixed an issue where the time of a 1:1 meeting didn’t match on the Schedules and 1:1 meeting page.
Fixed an issue where users weren’t able to join the 1:1 meeting.
Fixed an issue where admins could not index searches.
Fixed a problem with the secondary menu shifting.
Resolved an issue in Lily where page titles were partially hidden on mobile devices.
VirtualY 1.6.4 - Additional Bulk Fixes
Migrate to YUSA.
Improved error handling for Reclique SSO.
Resolved an issue where VY is hidden for users that have the admin toolbar.
Small fix to icon paths.
Added option for dummy provider to “auto-login”, providing a kind of “demo mode” for VY.
Added permissions mapping to gc_auth_reclique_sso.
Added on|off toggle for log_archiver cron job in config.
Content editors now have a new tool to build dynamic landing pages: Layout Builder! The “Landing Page (Layout Builder)” content type enables editors to build custom landing pages with a drag-and-drop interface.
Learn more in our docs.
The following components are available in Layout Builder v1.0:
Accordion Components
Pairs of question/answer or header/body components that expand or collapse on click to either hide or reveal content.
Paired sets of full-width page components that allow for an image and text to display either right or left aligned (i.e., image on right, text on left; text on right, image on left).
Updated the YUSA Distribution to the most recent stable version of Drupal Core.
Gated Content - Private Pages
Allows Y’s to have one or more pages of their website gated so that only association employees or members of their board of directors are allowed access.
Branches - Improvements for displaying Branch location Holiday hours
In the Branch Hours section, the day of the week labels (Mon, Tue, Wed, etc.) can be overridden with custom text.
Gives branches the ability to overwrite “Mon” with “Monday, July 4th” and/or “Sat” with “Christmas Day”.
Activity Finder / Schedules
Disabled “View PDF” button when schedule page returns no results
When no results are returned in Activity Finder, the “Download Weekly PDF” button does not display on the page.
Improvements to file names for PDF schedule downloads
PDF Schedule download files have been given more user-friendly names.
Example: “West YMCA October 24 - October 30”
Drupal 10 support
PHP 8.1 compatibility fixes
Locations & Maps
Location Page Improvement on Tablet Breakpoint
On tablets, users will now be able to see the list of amenities displaying below the content rather than in the sidebar.
Filter Locations by ID instead of title
Locations are now filtered by ID instead of title/name. This resolves an issue where duplicate location names were causing problems with results when filtering by amenities.
UX Improvements - Previous story / Next story (for Blogs)
Users can view suggested blog posts at the bottom of a blog post page and can click through to view the previous or next blog post.
Admin / Content Editor Updates
Show “Add Content” in Admin Menu
Made the “Add Content” menu item available by default for site administrators.
Ability to quickly clone a node or entity
Gives site admins the ability to clone a node or entity so they can create new content quickly without having to create each node from scratch.
Batch Upload of Media Files
Content editors can now upload multiple images and PDFs in a single step to streamline their workflows.
Update to Admin menu items
Renamed OpenY admin menu to YMCA Website Services.
Bug Fixes
Unpublished Branches show “Restricted Access” in “Blog Posts Listing” Block
Resolves an issue where unpublished branches were displaying as “Restricted Access” in the blog post listing locations filter.
Status page is partially empty
Fixed an issue where the Status Report page was missing information.
Membership Builder - The button label isn’t changed to the “Selected” on the membership page
Resolved a UX issue where buttons were missing indicators (“selected” text or button color changes) that a membership type had been selected.
Reduce z-index of fixed header
Prevents unwanted side effects in layout builder.
Openy_custom fixes/changes minor release
Resolved ‘failed to open stream error’ on Drupal backend
Renamed admin menu to YMCA Website Services
Updated home branch module learn more help text
Made home branch popup configurable
Enabled translation of form buttons with extra submit check
Alerts updates & bug fixes
Ensured <front> or / work for setting homepage Alert visibility
Cleaned up help text for Alert visibility section
Resolved PHP 8 deprecation warnings
Handled edge case for missing alert_location field