Cloudinary picker

What's New in v4.1 (vs v4.0)

Bug Fixes

Dynamic Folder Mode Support

• Fixed asset import compatibility with Cloudinary's Dynamic Folder mode
• The deserializer now correctly handles both folder configuration modes:
  • Static mode: uses folder property
  • Dynamic mode: uses asset_folder property
• Asset title now uses display_name when available (Dynamic mode), falling back to filename (Static mode)
• This resolves import failures when Cloudinary accounts are configured with Dynamic Folder structure

Technical Details

Previously, the module only supported Cloudinary's Static Folder mode. Accounts configured with Dynamic Folder mode returned a different JSON structure (`asset_folder` instead of `folder`, additional `display_name` field), causing asset import failures. The deserializer has been updated to detect and handle both modes automatically.

Version 4.0 modernizes the Cloudinary Picker module with a Jahia 8.2+ baseline, typed OSGi configuration, and enhanced image transformation handling. Editors can now select cropped or resized variants directly from the Cloudinary Media Library and store them as weak references.

---

What's New in v4.0 (vs v3.0)

Key Improvements

Image Transformations in Weak References (NEW)

• Contributors can now crop/resize images in the Cloudinary picker and import them as weak references
• Stores transformation parameters (cloudy:derivedTransformation) for consistent replay
• No binary duplication: Assets remain in Cloudinary, only references are stored in Jahia
• Cache-friendly delivery: Transformations encoded in base36 for predictable CDN URLs

Multi-Value Support (NEW)

• Multiple property fields now preserve existing selections
• Previous behavior: new picks replaced entire selection
• New behavior: new picks are added to existing selection

Multi-Transformation Support

• Enhanced parameter handling: width, height, crop, gravity
• Short format support: w:, h:, c:, g:
• Intelligent fallback: derived transformations → dynamic parameters → original asset

UI Enhancements

• Standard Jahia thumbnails (200px default, 1024×768px poster)
• Better asset preview in content forms with c_limit mode
• Visual cropping in picker for exact variant selection

Typed OSGi Configuration

• Structured configuration with validation (PID: org.jahia.se.modules.dam.cloudinary.provider.config)
• Required fields: cloudName, apiKey, apiSecret, edpMountPath
• Optional tuning: Cache TTL/TTI, HTTP timeouts, picker availability

Platform Modernization

• Jahia 8.2+ baseline required
• Updated toolchain: React 18, Webpack 5

Stability Improvements

• Centralized URL building eliminates code duplication
• Better type differentiation for image/video/raw file handling
• Enhanced error handling with graceful fallbacks
• Comprehensive JavaDoc for transformation priority

Known Limitations

Compatibility Requirements

• jContent 3.5.0+ required for thumbnail display (release pending)
• CKEditor 5 support coming in v1.1.0 (currently CKEditor 4 only)
• JavaScript Modules Library 1.1.0+ required for React/JSX (release pending)

Functional Constraints

• "Open in new tab" unavailable (external assets not browsable in jContent)
• No direct asset editing (transformations applied during selection only)
• Cache delay for updates (default: 8h TTL) - manual flush available
• Advanced transformations (overlays, effects) require Cloudinary upload presets

Note: Full compatibility requires jContent 3.5.0+ and JavaScript Modules Library 1.1.0+ (releases pending).

---

Developer Notes

Transformation Priority

1. Derived transformations (from picker: cloudy:derivedTransformation)
2. Dynamic parameters (from template: width:, height:, etc.)
3. No transformations (original asset URL)

• Bug fixes
• Register Dam Selector configuration
• Enable Edit/Delete Actions