This documentation is still in progress. We are working hard to update all our screenshots to the new Magnolia 6 style. Please bear with us.
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 field in some other dialog. Configure the choose dialog under the app that manages the items.
Choosing items from content apps
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. ContentApp creates a
ChooseDialogDefinition programmatically. A WorkbenchFieldDefinition and a ContentConnectorDefinition are instantiated In the
ContentApp#openChooseDialog method. Values for the definition classes are cloned from the first subapp of the app.
Configuring a choose dialog
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.
|<fully-qualified class name of your ContentConnectorDefinition>|
|<fully-qualified class name of your FieldDefinition>|
|<fully-qualified class name of your ChooseDialogDefinition>|
Choose dialog node.
Content connector node.
Content connector definition class implementing
A field used to choose the item, typically a workbench. The value must be a subclass of
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
Configuring a workbench
If you want to configure a custom workbench, use
info.magnolia.ui.contentapp.field.WorkbenchFieldDefinition as field.
Choose dialog node.
Extend an existing workbench definition or use any properties from the workbench definition.
Path to extended definition.
Image provider definition.