This article explains how the Asset Picker* is embedded in other systems and used.
* This feature is not included in all packages.
The Asset Picker lets you select files from the Media Hub directly in other systems, e.g. in a CMS or in WordPress. The picker runs embedded in the page of the respective system (opened directly, it cannot pass on a selection).
Allow the embedding page
Under Organization settings > Asset Picker, click Add host, enter a Label and the Origin of the embedding page and click Register. The origin consists of the scheme, host and port if applicable, without a path and without wildcards (e.g. https://cms.example.com). The key shown afterwards is stored in the embedding page, in the WordPress plugin under Host key. The approval only applies to accounts of your own organisation.
Sign in
Clicking Sign in opens a separate window for logging in to the Media Hub, with single sign-on if set up. On first sign-in, the Asset Picker's access to the account is confirmed. If the session expires, the picker asks you to sign in again.
Select files
The albums and folders the account has access to are then available, together with search (including metadata), filters and sorting. Tick the file you want and confirm the selection. Depending on the integration, multiple selection is also possible or only certain file types are offered. The embedding system receives the file together with title, copyright, alt text and licences. Cancel or Esc closes the picker without a selection.
Define the image crop
If the embedding system specifies crop variants (e.g. teaser or banner), selecting a single image is followed by a step for defining the image crop. For each variant, drag the frame to the desired section and confirm. Variants that are not needed can be skipped. If an image is too small for a variant, the picker points this out.
Upload files
In folders with upload permission, new files can be added via Upload or by drag and drop. They are then selected straight away. Entire folders cannot be uploaded here.