Magnolia 5.7 reached extended end of life on May 31, 2022. Support for this branch is limited, see End-of-life policy. Please note that to cover the extra maintenance effort, this EEoL period is a paid extension in the life of the branch. Customers who opt for the extended maintenance will need a new license key to run future versions of Magnolia 5.7. If you have any questions or to subscribe to the extended maintenance, please get in touch with your local contact at Magnolia.

Content view definition

A content view must implement  ContentPresenter , its definition class must implement ContentPresenterDefinition . Magnolia provides view implementations for JCR based data to display as list, tree, as thumbnails and one for search results (which is a list too).

The configuration snippet below shows content view definitions for the Magnolia provided implementations for JCR based data for tree, list, thumbnail and search.

Node nameValue

 tree


 class

info.magnolia.ui.workbench.tree.TreePresenterDefinition

 sortable

true

  columns


 list


 class

info.magnolia.ui.workbench.list.ListPresenterDefinition

 columns


 thumbnail


 class

info.magnolia.ui.workbench.thumbnail.ThumbnailPresenterDefinition

 search


 class

info.magnolia.ui.workbench.search.SearchPresenterDefinition

 columns


contentViews:
  - name: tree
    class: info.magnolia.ui.workbench.tree.TreePresenterDefinition
    columns: &myColumns
      - name: jcrName
        editable: true
        sortable: true
        propertyName: jcrName
        class: info.magnolia.ui.workbench.column.definition.PropertyColumnDefinition
      - name: status
        width: 45
        displayInChooseDialog: false
        formatterClass: info.magnolia.ui.workbench.column.StatusColumnFormatter
        class: info.magnolia.ui.workbench.column.definition.StatusColumnDefinition
      - name: moddate
        width: 160
        sortable: true
        displayInChooseDialog: false
        formatterClass: info.magnolia.ui.workbench.column.DateColumnFormatter
        propertyName: mgnl:lastModified
        class: info.magnolia.ui.workbench.column.definition.MetaDataColumnDefinition
  - name: list
    class: info.magnolia.ui.workbench.list.ListPresenterDefinition
    columns: *myColumns
  - name: thumbnail
    class: info.magnolia.ui.workbench.thumbnail.ThumbnailPresenterDefinition
  - name: search
    class: info.magnolia.ui.workbench.search.SearchPresenterDefinition
    columns: *myColumns

The YAML example shows more details compared to the JCR tree definition. Note how the column definition from the tree view has been reused for the list and the search views.


Common content view properties - ContentPresenterDefinition properties

class

required

A presenter definition class extending ContentPresenterDefinition to define the type of the view.

columns

required (not used for thumbnail view)

See Column definitions.

dropConstraintClass

optional , default is no drag-and-drop capability

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 moving of content under folders but not folders under content. If the class is not defined, the view will have no drag and drop capability. 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.

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.

icon

optional

CSS class that identifies an icon used on the view tab. For available names see Icons.

active

optional , default is true

Defines whether the view is active.

TreePresenterDefinition additional properties

sortable

optional, default is false

Enables and disables sorting of items in the view. Click the column header to sort.