Magnolia:connect

Magnolia:connect is a Magnolia extension which allows you to embed assets from CELUM DAM directly into your Magnolia CMS pages.

1. Installation

CELUM

  • Make sure the REST API (CORA) is installed and activated
    • For v2 of the module at least v2.3 of CORA is required
  • Create a new REST authentication profile for Magnolia in CELUM CMA
  • Install and configure DirectDownload

    Magnolia

  • Add the brix external Maven Repository to your Magnolia Maven project:
    <repository>
    <id>brix.external</id>
    <name>brix external repository</name>
    <url>https://maven.brix.ch</url>
    </repository>
  • Add your credentials for the brix external Maven Repository (delivered by brix cross media) to the server section of your Maven settings.xml:
    <servers>
    ...
    <server>
        <id>brix.external</id>
        <username>your-username</username>
        <password>your-password</password>
    </server>
    ...
    </servers>
  • Add the celum-dam-connector module as a dependency in your Magnolia Maven project:
    <dependency>
    <groupId>ch.brix.magnolia</groupId>
    <artifactId>celum-dam-connector</artifactId>
    <version>2.1.1-5.6</version>
    </dependency>
  • Build your Magnolia webapp with Maven and deploy it

2. Configuration

Configure the following properties in Magnolia:

/modules/celum-dam-connector/config/license/licenseKey

Your license key for the module (provided by brix)

/modules/celum-dam-connector/config/apiKey

The API key of the CORA authentication profile

/modules/celum-dam-connector/config/nodeTypeId

The Node Type ID you want to use with Magnolia:Connect

/modules/celum-dam-connector/config/nodeLocale

The code of the locale to use for the node hierarchy

3. Usage

Note: The provided component celum-simple-image is only an example, it is strongly recommended to implement your own custom component.

  • Add a new component somewhere on your page
  • Choose CELUM simple image as component type magnolia:connect-add-component
  • Click Select new...
  • Browse the tree, select the desired asset and click Choose magnolia:connect-select-asset
  • Confirm your selection by clicking on Save changes magnolia:connect-save-selection

Release Notes

1.2

  • Added button to clear the asset selection

2.0

  • Implemented full text search

2.1

  • The module now requires a license
  • Added tracking (notifies CELUM when a asset is selected)