Magnolia 5.5 reached end of life on November 15, 2019. 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.2.7</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 DAM API#AssetProvider. See the documentation for more information on registering new asset provider.
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 |