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 hippostd:xpagefolder hippo:document myproject: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/myproject/news |
last.visited.enabled | Boolean | Single | Enables to remember and open the last opened folder for the session in the picker dialog. True by default. |
true false |
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 by default, however the above last.visited.enabled takes precendence so has to be set to false. |
true false |
last.visited.key | String | Single |
If specified, the last visited folder is stored separately for this key. This allows managing multiple "last visited folders", for example, one for each document type. If not specified, the last visited folder is "shared" with all other link fields that have not specified a last.visitied.key. |
lastnewsfolder authorlinklastvisited |
last.visited.nodetypes | String | Multiple | By default, only hippostd:folder type nodes are regarded as "last visited folders" mentioned above. If you have any custom node types representing folder other than hippostd:folder, then you can specify other node types. | myproject:customfoldertype |
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 listed in the table above.
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 hippostd:xpagefolder hippo:document myproject:newsarticle |
The nodetype hippostd:xpagefolder is available since Bloomreach Experience Manager 14.3.0
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_
Configure Link Picker 'Type' Column
The link picker's listing contains a Type column showing the content items' content types. In some Bloomreach Experience Manager installations, this column may have been disabled.
To enable or disable to Type column in the link picker, use the Console to navigate to /hippo:configuration/hippo:frontend/cms/cms-pickers/documents/navigator/browser.options and set the document.type.show property to true (to enable) or false (to disable):
/hippo:configuration/hippo:frontend/cms/cms-pickers/documents/navigator/browser.options: document.type.show: true
Configure Link Picker Pagination
See Configure the CMS Folder Listing Page Size.