Page tree
Skip to end of metadata
Go to start of metadata

DEPRECATED

This workbench definition has been deprecated since Magnolia 6.0. It is part of the Magnolia 5 UI framework.

For the updated implementation, see Workbench definition for Magnolia 6 UI instead.

Workbench is a view that displays content items in a workspace. It is part of the content app framework, typically defined in the browser subapp. The workbench contains a list of content views. Common view types are tree, list and thumbnail.

Workbench definition

Here is an example workbench definition from the Contacts app. This workbench operates on the contacts workspace and displays contacts and folders.

workbench:
  dropConstraintClass: info.magnolia.ui.workbench.tree.drop.AlwaysTrueDropConstraint
  editable: false
  contentViews:
  contentTools:

Node nameValue

 browser


 workbench


 contentViews


 thumbnail


 search


 dropConstraintClass

info.magnolia.contacts.app.main.tree.ContactDropConstraint

 editable

false

 contentTools


Properties:

contentViews

required

Defines how users can view content in the workbench. The parent node for the specific content view definitions. It must contain at least one content view, see Content view definition.

dragAndDrop

optional, default is true

Set to false to disable drag and drop operations in the workbench.

dropConstraintClass

optional, default is AlwaysTrueDropConstraint

A drag-and-drop constraint class. By restricting the nodes that a user can move you can enforce a certain node hierarchy. For example, you might want to allow content to be moved under folders but not folders under content. If the class is not defined, the  AlwaysTrueDropConstraint is set as default. When you write your own class, implement the   DropConstraint  interface.

editable

optional

Makes the workbench editable inline. You can double-click a cell to edit its value. Works only for columns which are also configured as editable.

Inline editing is available only in the tree view, not in list, thumbnail or search views.

Definining a default action will override inline editing. Double-clicking the cell with trigger the default action instead of inline edit mode.

contentTools

optional

A list of configured content tools. (A content tool must be configured with ContentToolDefinition .)
WorkbenchPresenter is implemented in a way that it automatically configures a "search box" if you have both list and search view defined.