Quick Reference
Fast access to common commands, tasks, and patterns for YMCA Website Services users.
Quick answers to common tasks. Bookmark this page for instant access to frequently-used commands and workflows.
For Content Editors
Create a New Landing Page
- Content > Add Content > Landing Page (Layout Builder)
- Add title and click Save and edit layout
- Add sections and blocks using Add Section button
- Click Save layout when done
- Switch to Edit tab, check Published, and Save
Add a Banner Block
- In Layout Builder, click Add Block in any section
- Choose Create custom block > Banner
- Configure:
- Title (required)
- Image (upload from media library)
- Description text
- CTA button text and link
- Click Add block
Upload an Image
- Content > Media > Add media > Image
- Upload image file (recommended: JPG for photos, PNG for graphics)
- Add alt text (required for accessibility)
- Save
Create an Article or Event
- Content > Add Content > Article (LB) or Event (LB)
- Fill in:
- Title
- Date (for events)
- Category/Tags
- Featured image
- Use Layout Builder to design the page layout
- Save and Publish
For Developers
Update YMCA Website Services
# Update to latest version
composer update ymca/website-services
# Run database updates
drush updb -y
# Clear cache
drush cr
# Export configuration (if needed)
drush cex -y
Run Tests
# Run all tests
./vendor/bin/phpunit
# Run specific test group
./vendor/bin/phpunit --group=ymca
# Run with code coverage
./vendor/bin/phpunit --coverage-html ./coverage
Clear Cache
# Drupal cache clear
drush cr
# Or via admin UI
/admin/config/development/performance > Clear all caches
Enable a Module
# Via Drush
drush en module_name -y
# Via UI
/admin/modules > Check box > Install
Import/Export Configuration
# Export configuration
drush cex -y
# Import configuration
drush cim -y
# View configuration differences
drush config:status
Debugging
# Enable development settings
cp sites/example.settings.local.php sites/default/settings.local.php
# Tail logs
drush watchdog:tail
# Check PHP errors
tail -f /var/log/apache2/error.log
For Site Builders
Install Small Y Template
# Via Drush
drush si openy openy_configure_profile.preset=small_y \
openy_theme_select.theme=openy_carnation \
openy_terms_of_use.agree_openy_terms=1 \
--account-name=admin \
--site-name='YMCA Website Services'
Create a New Branch Location
- Content > Add Content > Branch
- Fill in:
- Branch name
- Address
- Phone number
- Hours of operation
- Amenities
- Add featured image and description
- Save and Publish
Configure Main Menu
- Structure > Menus > Main navigation
- Add link or drag to reorder existing links
- Click Save
Set Up Activity Finder (for Daxko/ActiveNet)
- Install Activity Finder module:
drush en openy_activity_finder -y
- Configure: /admin/openy/integrations/activity-finder
- Enter API credentials from your CRM provider
- Map program categories
- Create an Activity Finder page using Layout Builder
- Add Activity Finder block to the page
Manage Alerts
- Content > Add Content > Alert
- Choose alert type (Info, Warning, Emergency)
- Set:
- Alert message
- Placement (Global, specific pages, specific branches)
- Start/End dates
- Save and Publish
Configure Homepage
- Navigate to homepage node
- Click Layout tab
- Add/edit sections and blocks:
- Hero banner
- Latest news
- Program highlights
- Branch locations
- Save layout and Publish
Common Drush Commands
Task | Command |
---|
Clear cache | drush cr |
Update database | drush updb -y |
Export config | drush cex -y |
Import config | drush cim -y |
Enable module | drush en module_name -y |
Disable module | drush pmu module_name -y |
One-time login | drush uli |
Check status | drush status |
View logs | drush watchdog:tail |
Run cron | drush cron |
Keyboard Shortcuts
Layout Builder
- Shift + A - Add new section
- Shift + B - Add new block
- Shift + S - Save layout
- Esc - Close modal
Content Editor
- Ctrl/Cmd + S - Save content
- Ctrl/Cmd + P - Preview
- Ctrl/Cmd + Shift + P - Preview in new tab
URLs to Bookmark
Page | URL |
---|
Content list | /admin/content |
Add content | /node/add |
Media library | /admin/content/media |
Menus | /admin/structure/menu |
Activity Finder config | /admin/openy/integrations/activity-finder |
Performance (cache) | /admin/config/development/performance |
Reports | /admin/reports |
Module list | /admin/modules |
File Size Recommendations
Media Type | Recommended Size | Max Size | Format |
---|
Hero banner | 1920x800px | 2MB | JPG |
Blog featured image | 1200x630px | 1MB | JPG |
Staff photo | 600x600px | 500KB | JPG |
Logo | 400x200px | 200KB | PNG |
Icon | 128x128px | 50KB | PNG/SVG |
Video thumbnail | 1280x720px | 1MB | JPG |
Need More Help?