Magnolia 5.6 reached end of life on June 25, 2020. This branch is no longer supported, see End-of-life policy.
The External DAM app module provides an app that allows you to display content from an external asset provider.
<dependency> <groupId>info.magnolia.dam</groupId> <artifactId>magnolia-dam-external-app</artifactId> <version>2.3.2</version> </dependency>
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 |
The view icons open different views of the assets stored in the DAM:
AssetProvider
has to support AssetProviderCapability#hierarchical
capability.AssetProvider
supports AssetProviderCapability#query
and AssetProviderCapability#queryWithSorting
.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 |