Cloudinary Media Widget integration module

Edition

Incubator (services)

Issues

CLOUDINARY

Git

Git

Latest

1.1.8

Compatible with Magnolia 6.2.

The Cloudinary Media Widget Integration module allows users to integrate Cloudinary asset management into their dialogs/apps. With this widget you can select, upload or remove assets directly in the dialog.

This project exposes the cloudinary widget magnolia field. This field can be used as replacement for the cloudinary dam link field to select asset from your Cloudinary account.

This module is at the INCUBATOR level.

Installing with Maven

Maven is the easiest way to install the module. Add the following to your bundle:

<dependency>
  <groupId>info.magnolia.external.dam</groupId>
  <artifactId>cloudinary-media-widget-integration</artifactId>
  <version>1.1.8</version>
</dependency>

Configuration

You must first modify your server url in Admincentral.

Under config/server you have to change the defaultBaseUrl property to point your own instance and contextRoot.

To use this module you need to have an existing Cloudinary account.

From your cloudinary account, you need the following:

  • cloudName

  • apiKey

  • username

  • apiSecret

This information needs to be entered in passwords app, under the /cloudinary/default folder. Please check screenshot below:

cloudinary account admincentral

You can override default account settings by providing user specific settings.

Put user specific account under the magnolia username. Please check the screenshot below:

cloudinary account admincentral override

Usage

You can use a magnolia field in any dialog:

form:
   implementationClass: info.magnolia.ui.javascript.form.FormViewWithChangeListener
   properties:
     image:
        label: Cloudinary Image
        $type: cloudinaryWidgetField

After opening magnolia dialog and clicking on select image button, you should be presented with cloudinary widget select dialog. Please see the screenshot below:

cloudinary image

Additional info

When this module is installed, module will hide Cloudinary Assets Subapp and Cloudinary content in Choose dialog by default.

  • To enable Cloudinary Assets Subapp please set property closable to true for cloudinaryBrowser subapp in dam configuration yaml.

  • To enable Cloudinary content in Assets Choose dialog set property showCloudinaryContentInChooseApp to true for cloudinary-media-widget-integration module configuration yaml.

For the decorations to work consistently, you will need to add the following in your light modules:
<light-module>/module.yaml
<light-module-name>/module.yaml
version: 1.0
dependencies:
  dam-cloudinary:
    version: 1.0/*
  cloudinary-media-widget-integration:
    version: 1.0/*

Changelog

Version Notes

1.1.8

Incorporate as part of Cloudinary release process.

1.0

Initial release of the module.
Feedback