Pickers

Hippo CMS contains so called 'pickers' to allow users to 'pick' a value from a certain source and place it in the editor. Examples of values that might be picked using a picker are link targets and image locations.

Resource Picker

The common picker to pick documents, assets, etc.

URL: /explorer/resource-picker/content/

Parameters:

• mode=[resource|asset|html|datasource]
  • resource: default document picker, double click to select document or open folder
  • asset: default asset picker, displays thumbnails. Double click to select asset or open folder
  • html: same as document picker, used with form based editor
  • datasource: this one can select documents as well as folders (the 'select resource' link)
• type=foo
• selectedResource=/some/uri: to preselect a resource

Picker Wrapper The form based editor does not directly use the Resource Picker's URL, but uses a so called wrapper HTML page, which loads the actual picker URL in a frame. This is a workaround for Mozilla's specific Javascript behaviour. URL: /explorer/picker-wrapper.html Parameters: rootNode URI prefix "content" for documents or "binaries" for assets targetNode URI postfix selectedResource to preselect a resource The picker wrapper translates this to /explorer/resource-picker/{rootNode}/{targetNode}?mode=html&selectedResouce={selectedResource}

Create Resource Picker

Same functionality as the resource picker, with the added ability to create a new document in the picker.

URL: /explorer/create-resource-picker/content/

Parameters:

• type: document type of the newly created document

Folder picker

Lets users pick a folder from a collapsible tree.

URL: /explorer/folderpicker/content/

Thesaurus Picker

If the Thesaurus is a nodelist with a (nested) key-value pair, use this picker definition in the business logic:

<picker id="taxonomy" class="GenericPicker">
    <arg><![CDATA['/editing/dialogs/listpicker/key-value-pairs?editor=cforms&single-item=false&select-nodes=all&source=/content/path/to/taxonomy.xml']]></arg>
</picker>

For the lookup, use this in the sources element of the business logic:

<source id="taxonomy" type="nodetree">repository://content/path/to/taxonomy.xml</source>

List Picker

See the following documentation:
List item preview widget