Change record status: 
Project: 
Introduced in branch: 
1.1.x
Introduced in version: 
1.1.7
Description: 

What Changed

The Acquia DAM configuration page has been restructured to separate authentication settings from image style configurations into two distinct forms/tabs.
Before: Single configuration form at /admin/config/media/acquia_dam contained both authentication and image style settings together.
After: Configuration split into:

Authentication tab (/admin/config/media/acquia_dam) - Handles connection credentials and site authentication
Image Styles tab (/admin/config/media/acquia_dam/image-styles) - Manages DAM image style mappings

Key Improvements

1. Separated Authentication from Image Styles

  • Authentication settings (Client ID, Secret, Domain) are now on a dedicated tab
  • Image style configurations moved to a separate tab
  • Updating image styles no longer triggers authentication resave

2. Improved Authentication Flow

  • Simplified buttons: "Authenticate Site" or "Disconnect Site" (based on connection state)
  • Removed redundant "Save DAM configuration" button from authentication page
  • Authentication fields are now disabled when site is connected (must disconnect to change credentials)

3. Conditional Tab Visibility

  • Image Styles tab only appears when site is successfully authenticated
  • Prevents configuration of image styles before DAM connection is established

4. Enhanced Domain Validation

  • URL protocols (http://, https://) are now automatically stripped from domain input
  • Trailing slashes are removed to prevent redirect issues

What Site Administrators Need to Know

  1. Navigation Changes:
    Old:
    /admin/config/media/acquia_dam (everything in one form)
    New:
    - /admin/config/media/acquia_dam (authentication only)
    - /admin/config/media/acquia_dam/image-styles (image style mappings)
  2. To modify authentication settings:
    • Navigate to /admin/config/media/acquia_dam
    • Click "Disconnect Site" if currently connected
    • Update credentials as needed
    • Click "Authenticate Site" to reconnect
  3. To configure image styles:
    • Ensure site is authenticated first
    • Navigate to the "Image Styles" tab
    • Configure your image style mappings
    • Save changes

Benefits

✅ Clearer separation of concerns - Authentication and image style settings are logically separated
✅ Prevents accidental changes - Updating image styles won't resave authentication credentials
✅ Better UX - More focused forms, clearer workflow
✅ Safer credential management - Must explicitly disconnect to modify authentication settings

Backward Compatibility

✅ Fully backward compatible - No configuration migration needed

  • Existing authentication settings remain intact
  • Image style configurations are preserved
  • All functionality continues to work; only the UI organization has changed

This change improves the overall configuration experience and makes the module safer to use by preventing unintentional authentication updates when managing image styles.

Impacts: 
Site builders, administrators, editors