Attribute

Description

Possible values

Default

UX modifiers

assetNatures

A list of selectable asset types, in uppercase, comma separated

ALL (tous les types)

ou un ou plusieurs type primaire séparé par une virgule, parmi : IMAGE, VIDEO, 3D, AUDIO, DOCUMENT, PRINT, ZIP

“IMAGE”

min

The minimum number of assets that the picker should return.

For a single pick, set this value to 1, and the max to 1

For multiple set this value up to 100

a number ranging from 1 to 100

1

max

The maximum number of assets that the picker should return.

For a single pick, set this value to 1, and min to 1

For multiple set this value up to 100

a number ranging from 1 to 100

1

lang

The language of the UI

“en” , “fr”, “de”

browser language

showPreview

if we should display the “preview” button, and the preview popin window

true / false

true

showFilters

if we should display the filter bar

true / false

false

showSort

if we should allow asset sorting

true / false

false

showCursors

is we should display the cursor options in the UI. These cursors are set up in the Wedia Portal configuration

true / false

true

showCropper

The user can crop the image to either an expected dimension (expectedWidth

expectedHeight)

true / false

true

showFocus

The user can select the focus points on the image.

true / false

false

showLayout

Show the different layout choices (line, columns, details, square…)

true / false

false

Expected return formats

expectedWidth

expectedHeight

Wedia implements a cropper that will return a virtual cropping of the image.

If expectedWidth and expectedHeight are present in the configuration object, the cropper will show up for single picks.

This will not exclude from the search the images that are too small to comply with these constraints.

the expected width / height in pixels

variation

Wedia implements preset media renditions, called variation :  for example thumbnailReal is the rendering of the image at its original size, in JPEG or PNG, depending on the server configuration.

There are product presets, and project presets : using Java extensions, or Admin back-office, system integrators can defined project defined presets, such as : a watermarked image with a white icon horizontally centered at 10 px from the top…

Read more on how to define a custom variation here.

Videos, 3D, PDFs are returned in a player HTML component, so no variation is needed, and this variation should be left blank.

But If you need to get the actual binary of a video, you can set the variation of the video among “SD”, “MD”, “HD” quality.

If you are allowing the user to pick mixed formats such as VIDEOS and IMAGES, default renditions will be applied to your return set : thumbnailReal for images and a HTML player for videos

The expected variation

“thumbnailScreen” (a 2000 pixel wide web preview) 

additionalVariations

A list with the names of the possible variations. Comma separated

playerId

if a video specific player among those defined at the project level should be selected

a string of the player name as defined in the Wedia Player Manager

“default id”

playerWidth

the specific width of a video player in  pixels

an integer between 150 and 2000, or a percentage

560

playerHeight

the specific width of a video player in  pixels

an integer between 150 and 2000 or a percentage

315

playerAutoStart

for the few browsers that still support it, should the video start automatically

true / false

false

playerShareLinks

enable the social shares in the player

true / false

false

enableImagePlayer

Images can be embedded in a player with a zoom, social sharing. This is not a common use case, but can be enabled. In that case, the “variations” parameter will be ignored 

true / false

false

Search filters

cursor

a cursor is a predefined request that filters assets in order to show a restricted set of assets. The user cannot override this restriction.

Cursors are set up at the Wedia level, they have a name and a query.

For example : productHeroImage : select all product images that have an expiration date set over 4 months from today and that have a width over 1600 pixels

The name of the cursor as defined in the JSON parameter files of the Wedia Portal config

fullText

a preset full text query. The user can remove this query.

the text of the query

Advanced

configPath

If you want to define totally different pickers, this can point to multiple JSON portal config. this is an internal option to be discussed with your Wedia product specialist when you need really different JSON parameters, such as the metadata displayed in the preview popup, cursor names...

the internal path to the JSON portal config.

/res/contentPicker