Cloudinary picker

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

New Features

3D Model Support

• Added a dedicated content type for 3D models picked from the Cloudinary Media Library (GLB, glTF, USDZ, FBX, OBJ, 3DS, PLY, U3MA)
• 3D models no longer show up as broken images, and never appear in image pickers
• Two views are available to render a 3D model:
  • Default view: the Cloudinary Product Gallery, with rotation, zoom and augmented reality on mobile
  • Viewer view: a standalone viewer, for Cloudinary plans that do not include the Product Gallery
• 3D models get a rendered thumbnail in jContent and the Content Editor

Bug Fixes

Thumbnails in jContent

• Fixed Cloudinary asset thumbnails, which were not displayed in jContent 3.4.1 and later
• Raw documents (zip, xls and other non-media files) now keep their file-type icon instead of a blank square

3D Model Selection

• Fixed selecting a 3D model, which failed to load the asset

Known Limitations

• jContent 3.4.1 or later is required for thumbnails
• CKEditor 5 is not supported yet: a Cloudinary image inserted into a CKEditor 5 rich text field does not display. Use CKEditor 4 for rich text fields that need Cloudinary images

Technical Details

Cloudinary stores 3D models under the image resource type, so they were previously mapped to the image content type, and their missing width/height made the asset import fail. 3D models are now detected by format and mapped to `cloudynt:model3d`; their thumbnails are rendered through Cloudinary's camera effect, trimmed and padded to a square. jContent 3.4.1 asks for thumbnails with `checkIfExists`, which the module now answers: an image, a video, a PDF or a 3D model has a thumbnail, while a raw document does not, so jContent falls back to its file-type icon.

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)