HCMS Content Picker is a JavaScript-based widget for selecting media assets.
About Content Picker
HCMS Content Picker is a JavaScript-based widget for selecting media assets. Users can filter assets by various metadata criteria (including full-text) and check image preview and detailed metadata before confirming their selection.
You can integrate Content Picker with any custom web application or existing CMS system. It is based on the HCMS API. On top of this API, Content Picker provides:
-
Schemas: Schemas map standard data and metadata. You can extend these schemas to add project-specific metadata.
-
Frontend: React-based frontend code (JavaScript) to display the selection dialog. This dialog must be invoked from some other JavaScript code. The dialog returns data in the JSON format. The dialog is displayed as a popup window, allowing UI integration with any other web application. Its appearance can be customized by using a theme to fit in the correct branding (for example, colors).
Content Picker is available in English, German, French, Italian, and Spanish.
What to keep in mind before integrating Content Picker
Before the installation, read and consider these basic principles of the Content Picker:
-
Content Picker itself is just a frontend application component that uses another Censhare product, HCMS (Headless CMS).
-
Content Picker is not useful as a standalone application. Embed it in another frontend (JavaScript) application that uses the picked content.
-
Content Picker is purely frontend code (TypeScript compiled to JavaScript) that needs to be served by some HTTP server. This HTTP server is not part of this application. Note: Usually, the embedding application already provides this HTTP server.
Available HCMS documentation
For the full HCMS documentation, see Headless CMS. This article relies on that documentation and does not describe the HCMS installation in detail. Topics such as authorization are also not covered here. An online training is also available for onboarding.
Current release highlights
-
Languages: Italian and Spanish are new. French was already included but switched off; it is now enabled.
-
Office Documents filter: Office Documents is a single filter with the subfilters Text documents, Spreadsheets, Presentations, and "Drawings & diagrams". It includes Word, Excel, and PowerPoint files.
-
PDF and ZIP filters: The PDF filter returns all PDF files. The ZIP filter was removed.
-
Fullscreen preview: Word and Excel files have full previews in fullscreen.
-
Preview fallback: If the requested preview format cannot be delivered, previews fall back to a format that works.
-
Keyboard navigation: Esc closes the fullscreen preview. In fullscreen, the left and right arrow keys move through the selected assets.
-
Metadata: The Metadata tab now lists available metadata or displays No meta data available when none exists.
-
Numeric metadata: Numeric values are displayed as numbers instead of being incorrectly rendered as dates.
-
Picker overlay: Opening the picker a second time no longer leaves a nonfunctional overlay over the page.
-
Selection preview: Deselecting the asset currently displayed no longer leaves a stale preview in the details panel. The panel now switches to another selected asset.
-
File type recognition: RTF files and newer Excel files are recognized as documents instead of videos.
-
File icons: Files without a preview now show an appropriate file icon instead of an indefinitely loading spinner. Office files use the corresponding Word, Excel, or PowerPoint icon.
-
Browser language: When no language is explicitly configured, the picker uses the browser language. For details, see "Language selection" below.
-
Look and feel: The default theme uses the updated Censhare corporate logo and colors.
-
Performance: Startup downloads are reduced by about 1.1 MiB. The video player and the PDF viewer load only when needed.
-
Technology stack: The frontend uses React 18, MobX 6, webpack 5, TypeScript 5, RMWC 14, styled-components 6, and Dart Sass. Node.js 24 is the build platform.
Language selection
Content Picker supports English, German, French, Italian, and Spanish. It selects the language in this order:
-
The language that the embedding page passes with "CsMediaLibrary.create()", if Content Picker supports it.
-
Otherwise, the first supported language from the preferred languages of the browser (navigator.languages). Safari provides only its first preferred language.
-
Otherwise, English.
Content Picker ignores region codes. For example, de-DE, DE, and de_DE select German, and fr-CA selects French. An unsupported language does not force English. Content Picker continues with the preferred languages of the browser. For example, if the integration requests Polish and the browser preferences are Polish and then German, Content Picker uses German.
Content Picker selects the language once when it opens. You cannot change the language while it is open. Before this release, Content Picker always started in English. To keep this behavior, pass en explicitly. For details, see Integration.
Marmind
For Marmind, Content Picker takes the language from the link parameter "?locale=". If it is missing, Content Picker uses the browser language and then English. Marmind currently does not pass "?locale=". Therefore, the picker follows the browser language and not the language setting of the user in Marmind.
Docker setting LANGUAGE
In a self-hosted Docker setup, the LANGUAGE setting sets the default language of the bundled demo page. For details, see Content Picker installation.
The LANGUAGE setting does not affect the Marmind picker. It is written to picker-config.json. The demo page of the Docker image (web/index.html) reads this file. The Marmind page (deploy/marmind/index.html) does not read it.
Known limitations
The texts of Content Picker itself are complete in all five supported languages. Some labels come from the Censhare Server, for example file type names, Name, Created at, Modified at, and EXIF and IPTC labels. In French, Italian, and Spanish, these labels can still appear in English. In German, they are complete.