Link Picker Configuration - BloomReach Experience - Open Source CMS

This article covers a Hippo CMS version 10. There's an updated version available that covers our most recent release.

26-11-2015

Link Picker Configuration

Documents can contain links to other content items. Such links are normally created using either a dedicated Link field or the link button inside a Rich Text Editor field. In both cases a Link Picker dialog lets authors browse and select either a document, image or asset from the repository. The Link Picker dialog can be configured for each individual field it is used by.

Link Picker Configuration for a Link Field

The Link Picker dialog for a Link field can be configured using the Document Type Editor. Open the document type that you want to edit and select the link field. In its properties panel you find the following properties that control the Link Picker dialog:

Property Name Property Type Single or Multiple Valued Description Examples
nodetypes String Multiple

One or more JCR node types specifying the content types that can be selected. The Link Picker dialog's 'OK' button will be enabled if a content item of a selectable type is selected, or disabled otherwise. Node types that extend a selectable node type are selectable too.

hippostd:folder

hippo:document

myhippoproject:newsarticle

base.uuid String Single UUID of the default folder to show when the Link Picker dialog opens. f7bdc6a4-d35f-4fb9-8dd9-674b440a8b5f
base.path String Single The path of the default folder to show when the Link Picker dialog opens. If the base.uuid is specified, it takes precedence over base.path /content/documents/myhippoproject/news
language.context.aware Boolean Single If true the Link Picker dialog by default opens the root content folder for the current document's language.

true

false

Alternatively, the link picker can be configured using the  Hippo Console by adding or modifying a number of properties on the field's JCR node. In the Hippo Console browse to the relevant node under  hippo:namespaces:

/hippo:namespaces/[your_namespace]/[your_doctype]/editor:templates/_default_/[your_link_field]/cluster.options

On the  cluster.options node you can add the same properties as seen in the previous table.

Link Picker Configuration for a Rich Text Editor Field

The Link Picker for a Rich Text Editor field can be configured analogous to a Link field either through the Document Type Editor or the Console. However, it uses slightly different property names:

Property Name Property Type Single or Multiple Valued Description Examples
linkpicker.nodetypes String Multiple

One or more JCR node types specifying the content types that can be selected. The Link Picker dialog's 'OK' button will be enabled if a content item of a selectable type is selected, or disabled otherwise. Node types that extend a selectable node type are selectable too.

hippostd:folder

hippo:document

myhippoproject:newsarticle

Note that the linkpicker.base.uuid and linkpicker.language.context.aware properties cannot be used for a Rich Text Editor field. See also  CMS7-9238.

The  linkpicker.nodetypes property can be configured globally for all Rich Text Editor fields in all document types by adding it to the following JCR node:

/hippo:namespaces/hippostd/html/editor:templates/_default_
Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?