Onboarding
Welcome to YMCA Website Services
Development
Welcome to the development corner of the YMCA Website Services distribution.
For YMCA Associations
For Developers
For QA Engineers
Community Guidelines
Best Practices
Legal
Getting Started with YMCA Website Services Development
Whether you are just getting started with YMCA Website Services or need to test a feature in a stable environment, the YMCA Website Services Core Team maintains a number of Sandboxes that you can use.
Processes & Components
Environment Setup
- Tech Stack
- Open-Y-one-click-install-how-to
- Install-Solr-site-search-for-Open-Y
- Install-SSL-certificate-for-the-OpenY-site
- Switching Drupal Core Versions
Advanced: Multi-Domain Configuration
As of version 10.4.0.0, YMCA Website Services includes support for the Domain Access module, enabling multi-domain and multi-branch site architectures.
Use cases:
- Multiple YMCAs sharing one Drupal installation
- Branch-specific domains (e.g.,
downtown.ymca.org,westside.ymca.org) - White-label YMCA sites
To enable Domain Access:
composer require drupal/domain
drush en domain domain_access -y
Configure domains at Configuration > Domain Access (/admin/config/domain).
For more details, see the 10.4.0.0 release notes and the Domain Access module documentation.
Contributing to YMCA Website Services
Working with Existing Functionality
Adding and Removing Functionality
Dependency Management
Decoupling YMCA Website Services
- Intro to Decoupling YMCA Website Services Components
- List of Decoupled Components
- Managing Drupal Dependencies while Decoupling
- Analytics Decoupling and Opt-out
Ongoing Maintenance
Releases
Update Processes & Notices
- Updating YMCA Website Services
- Drupal 9 to Drupal 10 Upgrade
- Drupal 11 Migration Guide (Beta - stable Q4 2025)
- Important-versions-for-upgrade-path
These documents are for old versions of YMCA Website Services, but may contain useful information for troubleshooting future update issues.
- SA-CORE-2018-004
- SA-CORE-2018-002
- Upgrade from 8.0.x to 8.1.x
- Upgrade-OpenY-8.1.3-to-8.2.2.1
- Upgrade-use-case-from-8.2.2.3-to-8.2.7.3
- openy-9.x-2.11.5 to 10.3 latest distribution
Colorways
What goes into making the selectable colorways in Layout Builder.
Drupal 10 update
The update from Drupal 9 to 10 is easier than some, but still comes with some challenges.
Drupal 11 Migration Guide
Upgrade YMCA Website Services from Drupal 10 to Drupal 11.
Profile custom configuration
The distribution supplements the Drupal install process with a number of custom additions.
Program Event Framework
A robust set of content types and syncer modules that build interactive tools to help members find and book activities.
Sandboxes
YMCA Website Services Sandboxes for Evaluation and QA
Terms and Conditions
These Terms & Conditions must be agreed to upon installing YMCA Website Services