Magnolia 5.7 reached extended end of life on May 31, 2022. Support for this branch is limited, see End-of-life policy. Please note that to cover the extra maintenance effort, this EEoL period is a paid extension in the life of the branch. Customers who opt for the extended maintenance will need a new license key to run future versions of Magnolia 5.7. If you have any questions or to subscribe to the extended maintenance, please get in touch with your local contact at Magnolia.
This module is deprecated. See Deprecations.
The External DAM app module provides an app that allows you to display content from an external asset provider.
Installing
Maven is the easiest way to install the module. Add the following to your bundle:
<dependency> <groupId>info.magnolia.dam</groupId> <artifactId>magnolia-dam-external-app</artifactId> <version>2.4.3</version> </dependency>
Pre-built JARs are also available for download. See Installing a module for help.
Configuration
The app is based on the content app framework so its configuration is typical of any content app.
It's configuration can be found at /modules/dam-external-app/apps/dam-external-app.
The app is based on Content Connector which retrieves the content through AssetProvider. See the documentation for more information on registering new asset providers.
The asset provider can be specified with its provider id at /modules/dam-external-app/apps/dam-external-app/subApps/browser/contentConnector@assetProviderId :
| Node name | Value |
|---|---|
modules | |
external-dam-app | |
apps | |
external-dam-app | |
subApps | |
browser | |
contentConnector | |
assetProviderId | jcr |
class | info.magnolia.dam.external.app.contentconnector.AssetContentConnectorDefinition |
Views
The view icons open different views of the assets stored in the DAM:
- Tree view: Displays a hierarchical tree, including the folder structure. The underlying
AssetProviderhas to supportAssetProviderCapability#hierarchicalcapability.
- List view: Displays the items individually. You can sort them alphanumerically by clicking the column headings, if the
AssetProvidersupportsAssetProviderCapability#queryandAssetProviderCapability#queryWithSorting.
- Thumbnail view: Displays thumbnail images of the assets. There is a zoom control at the top for resizing.
- Detail: Display details of the asset. The Metadata field displays all registered metadata classes supported by the asset.
Use in dialogs
The AssetLinkField has to be used instead of LinkField.
It is configured the same way as regular LinkField:
| Node name | Value |
|---|---|
assetImage | |
identifierToPathConverter | |
class | info.magnolia.dam.external.app.field.AssetCompositeIdKeyTranslator |
appName | your-app |
class | info.magnolia.dam.external.app.field.definition.AssetLinkFieldDefinition |
Overview
Content Tools