Magnolia Assets subapp

Related topics

Magnolia Assets subapp is a Magnolia-native solution for simple Digital Asset Management (DAM) scenarios. It is installed in the Assets app by the Digital Asset Management module and allows you to manage media assets in Magnolia’s digital asset management system (DAM). You can upload original assets into the system, organize them, perform basic image manipulation operations such as cropping. The assets can be used on the website.

See also our DAM Connector Pack with out-of-the-box DAM connectors for Amazon Simple Storage Service (S3) and Bynder.

In Magnolia 6.2 documentation, the page called Assets app - 5 UI describes the app with artifactId magnolia‑dam‑app-compatibility and configurable using the Configuration app (/modules/dam-app). In documentation for older Magnolia branches, the page’s name is Assets app:

https://documentation.magnolia-cms.com/display/DOCS61/Assets-app
https://documentation.magnolia-cms.com/display/DOCS57/Assets-app

By default, this app is hidden in the UI of Magnolia 6.2.

Configuration

Magnolia Assets subapp is based on the Magnolia 6 UI framework and is configured at /dam-app-jcr/decorations/dam-assets-app/apps/dam.subApps.yaml.

Image manipulation actions such as resizing or cropping are provided by the UI Media Editor module. Configuration of these actions can be found at /modules/ui-mediaeditor/mediaEditors/image, with some of its parts defined in YAML-based decorations under /ui-mediaeditor/decorations/ui-mediaeditor/mediaEditors.

Turning the image thumbnails off in the asset browser

By default, image thumbnails are displayed next to the asset names in the asset browser. This behavior can be changed by setting the thumbnails property to false for the jcrName column (line 15 in the configuration snippet below):

  workbench:
    contentViews:
      - name: tree
        $type: treeView
        dropConstraint:
          $type: jcrDropConstraint
          primaryNodeType: mgnl:asset
        multiSelect: true
        columns:
          jcrName: &name
            class: info.magnolia.dam.app.contentview.column.JcrAssetNameColumnDefinition
            nodeTypeToIcon:
              mgnl:folder: icon-folder
              mgnl:asset: icon-assets-app
            thumbnails: false

A universal icon is then displayed next to the asset names instead of thumbnails:

Workspace

The subapp operates on the JCR dam workspace. The dam workspace stores the uploaded original assets and variations created with image operations such as cropping.

Node types

The DAM module registers a custom mgnl:asset node type. Magnolia Assets subapp operates on nodes of this type and on folders.

Using the app

See Digital asset management for how to use the subapp.

How to handle large amount of assets

The DAM can handle a very large number of assets. However, if you have more than 20.000 assets, you should organize them into folders. Avoid storing too many assets in the same folder. Instead, create subfolders and organize your assets. Storing too many assets within the same folder may lead to performance issues. If you need a large and unstructured flat list of assets, disable the thumbnail and list views.

Feedback