1 Design
2 How it works
- 2.1 From the search page
- 2.2 From the board page
- 2.3 Asset selection
3 Advanced Configuration

Design

Asset thumbnails from Search Page

Asset thumbnails from a board

How it works

From the search page

The search results are displayed as thumbnails.

The user can rollover a thumbnail to display :

3 action icons :
The name of the asset display (troncated with suspensions points if there is not enough space for the entire name)
A select option (in the right corner)

From the board page

From the board page, users can roll over each Thumbnail in order to display :

3 action icons :
- Preview
- Download
- Add to a board (existing or new)
- Detach from board (only for board’s owner)
The name of the asset display (troncated with supensions points if there is not enough space for the entire name)
A select option (in the right corner)

Asset selection

From a board, or the search page, user can select multiple assets. Several actions are available for assets selection. Refer to the dedicated documentation :Actions on Assets Selection

Advanced Configuration

Assets status

By default, statuses are displayed on media thumbnails in the DAM, as well as in tables and portals, whenever a user has permission to manage the workflow for at least one asset library. Users without workflow management permissions do not see the status indicators. It is also possible to completely hide the display of statuses in the DAM, tables, and portals.

Show/Hide status on asset thumbnails by setting $.dam.explore.showAssetsStatus to trueor False.

List of available action

damBoard : add asset to a board
damDownload : download the asset
damPreview : open preview pop-in
boardDetachAsset : remove asset from board

Configuring Actions

An action's definition is placed under $common.namedActions, you can modify its display by modifying some of its attributes. In the most common cases you’ll want to modify i18n value to change the value of the tooltip, the icon value to change the displayed icon, the onlyIfAllFeaturesActive value (which is an array) to condition the display of the action to the availability of some features or the onlyForRootNatures to display the action depending on the nature of the asset.

For more in depth configuration for a given action, please refer to the documentation page of this specific action.

Modifying the actions list

Actions are placed under $dam.explore.items.actions as an array of actions. Removing or adding a value will remove or add an action.

Actions can have two different formats :

// simple form

actions : [...]

// advance form

actions: {
  maxDisplayedActions: Int,
  actions: [...]
}

Configuring the number of actions displayed

The default value for $dam.explore.items.actions.maxDisplayedActions is 3.

Configuring indicators : Displaying icons on asset thumbnails

Indicators are configurable on dam & board domain. The configuration points are located under their explore folder, and indicators.json must be an array of objects.

dam/explore/indicators.json / board/explore/indicators.json example of content :

[
  {
    "tooltipPath": "visibility.name",
    "icon": "fas fa-lock-alt",
    "rule": {
      "operator": "eq",
      "path": "visibility.id",
      "skip": true,
      "value": [
        2
      ],
      "priority": 10
    }
  }, // ===> "raw config " indicator
  "righttypeExternalIndicatorRule", // ==> "named config" indicator
  "righttypeInternalIndicatorRule"
]

More details on the configuration of indicators can be found here : https://crossmedia.atlassian.net/wiki/x/AYDcgw

As shown above, the array can be populated with both "named configs" and "raw configs." Named configs should be added to the common/named-indicators directory. While their content is identical to raw config indicators, using named configs allows us to reuse them across both board indicator configurations and DAM indicator configurations, eliminating the need to rewrite them for each domain.

Please note that :

For the rules to be evaluated, your data must be retrieved in the front-end application. Below are some tips to help you properly configure your project to retrieve the evaluated data

DAM	BOARD

DAM

BOARD

Add properties in

dam/explore/additionalFieldsForProps.json

On boards domain, there is actually 2 ways :

Add properties in board/explore/additionalFieldsForProps.json
The evaluated properties must wear wxmcart tag on your asset structure

additionalFieldsForProps is an array of strings representing the technical names of the props

wxmcart tag can be customized on the WXM_CART2 settings page. If it has been customized, please use "your" customized wxmcart tag.

Wedia Product Documentation

Assets thumbnail and associated actions