This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

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

    1. Content > Add Content > Landing Page (Layout Builder)
    2. Add title and click Save and edit layout
    3. Add sections and blocks using Add Section button
    4. Click Save layout when done
    5. Switch to Edit tab, check Published, and Save

    Add a Banner Block

    1. In Layout Builder, click Add Block in any section
    2. Choose Create custom block > Banner
    3. Configure:
      • Title (required)
      • Image (upload from media library)
      • Description text
      • CTA button text and link
    4. Click Add block

    Upload an Image

    1. Content > Media > Add media > Image
    2. Upload image file (recommended: JPG for photos, PNG for graphics)
    3. Add alt text (required for accessibility)
    4. Save

    Create an Article or Event

    1. Content > Add Content > Article (LB) or Event (LB)
    2. Fill in:
      • Title
      • Date (for events)
      • Category/Tags
      • Featured image
    3. Use Layout Builder to design the page layout
    4. 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

    1. Content > Add Content > Branch
    2. Fill in:
      • Branch name
      • Address
      • Phone number
      • Hours of operation
      • Amenities
    3. Add featured image and description
    4. Save and Publish

    Configure Main Menu

    1. Structure > Menus > Main navigation
    2. Add link or drag to reorder existing links
    3. Click Save

    Set Up Activity Finder (for Daxko/ActiveNet)

    1. Install Activity Finder module: drush en openy_activity_finder -y
    2. Configure: /admin/openy/integrations/activity-finder
    3. Enter API credentials from your CRM provider
    4. Map program categories
    5. Create an Activity Finder page using Layout Builder
    6. Add Activity Finder block to the page

    Manage Alerts

    1. Content > Add Content > Alert
    2. Choose alert type (Info, Warning, Emergency)
    3. Set:
      • Alert message
      • Placement (Global, specific pages, specific branches)
      • Start/End dates
    4. Save and Publish

    Configure Homepage

    1. Navigate to homepage node
    2. Click Layout tab
    3. Add/edit sections and blocks:
      • Hero banner
      • Latest news
      • Program highlights
      • Branch locations
    4. Save layout and Publish

    Common Drush Commands

    TaskCommand
    Clear cachedrush cr
    Update databasedrush updb -y
    Export configdrush cex -y
    Import configdrush cim -y
    Enable moduledrush en module_name -y
    Disable moduledrush pmu module_name -y
    One-time logindrush uli
    Check statusdrush status
    View logsdrush watchdog:tail
    Run crondrush 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

    PageURL
    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 TypeRecommended SizeMax SizeFormat
    Hero banner1920x800px2MBJPG
    Blog featured image1200x630px1MBJPG
    Staff photo600x600px500KBJPG
    Logo400x200px200KBPNG
    Icon128x128px50KBPNG/SVG
    Video thumbnail1280x720px1MBJPG

    Need More Help?