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
  • 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>1.1.4</version>
    </dependency>
  • Build your Magnolia webapp with Maven and deploy it

2. Configuration

Configure the following properties in Magnolia:

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

The API key of the CORA authentication profile

/modules/celum-dam-connector/config/rootNodeId

The Root Node ID of the hierarchy you want to use with Magnolia:Connect

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

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

/modules/celum-dam-connector/rest-client/celumCora/baseUrl

The base URL for CORA on your CELUM server, e.g. https://dam-demo.brix.ch/cora

/modules/dam/config/providers/celumCoraProvider/directDownloadBaseUrl

The base URL for DirectDownload on your CELUM server, e.g. https://dam-demo.brix.ch/direct/download

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