Magnolia 5.5 reached end of life on November 15, 2019. This branch is no longer supported, see End-of-life policy.
A choose dialog allows you to select an item from an app, typically from a content app. Below is a choose dialog for choosing a page. The dialog displays the workbench from the Pages app. You typically open a choose dialog by clicking a link field in some other dialog. Configure the choose dialog under the app that manages the items.
A content app already has a suitable view for choosing items: the workbench of the first subapp. You don't need to configure a choose dialog explicitly.
ChooseDialogDefinition programmatically. A ContentApp#openChooseDialog method. Values for the definition classes are cloned from the first subapp of the app.You don't need to configure a choose dialog when choosing items from a content app. The workbench of the first subapp works as an item chooser automatically.
You can configure a choose dialog explicitly if required. Create a chooseDialog node under the app configuration.
| Node name | Value |
|---|---|
| <fully-qualified class name of your ContentConnectorDefinition> | |
| <fully-qualified class name of your FieldDefinition> | |
| <fully-qualified class name of your ChooseDialogDefinition> |
Properties:
chooseDialog | optional Choose dialog node. |
| required Content connector node. |
| required Content connector definition class implementing |
| required Field node. |
| required A field used to choose the item, typically a workbench. The value must be a subclass of $webResourceManager.requireResource("info.magnolia.sys.confluence.artifact-info-plugin:javadoc-resource-macro-resources")
SelectFieldDefinition
or a more complex custom field. |
| required A choose dialog definition class implementing |
Note that ChooseDialogDefinition extends DialogDefinition. This means you can also configure actions (Select and Cancel by default) and an actionArea (optional).
If you want to configure a custom workbench, use info.magnolia.ui.contentapp.field.WorkbenchFieldDefinition as field.
| Node name | Value |
|---|---|
| ../../../subApps/browser/workbench | |
| info.magnolia.ui.contentapp.field.WorkbenchFieldDefinition |
Properties:
chooseDialog | optional Choose dialog node. |
| required Field node. |
| optional Extend an existing workbench definition or use any properties from the workbench definition. |
| optional Path to extended definition. |
optional Image provider definition. |