Addons

HOWTO: Enable Drag and Drop and New Button on a Custom Content View - JSF UI

Updated: December 17, 2024

JSF UI Deprecation
This requires to have the JSF UI addon installed on your server that is deprecated since Nuxeo Platform LTS 2019.
Please refer to the Web UI documentation.

You should follow this how-to if you want to either:

  • Replace the default Content tab of a folderish document type
  • Or add a new tab from which users should be able to create children documents.

To do so, you basically need to create a new tab with some specific properties.

Before You Start

Before you follow the steps below, you should already have configured the items below:

  • In the Settings > Application Definition menu, make sure that the Nuxeo JSF UI addon is in the list of packages to install.
  • A document type with the following properties:
    • Folderish facet
    • Accepts children document types (File or extending file)
  • A content view, obviously.

Setting up Your Custom Tab

To set a content view with Drag&Drop and the New button:

  1. In Studio, go to Listings & Views > Tabs.
  2. Click the New button and enter a name for the Feature ID: ContentViewWithDnDandNewButton. And click Next to validate.
  3. Set a value for Order if you don't want the new tab to be displayed as the first tab.
  4. Drag the widget Drop zone from Featured widgets > Built-in widgets and drop it in the first cell of the tab grid.
  5. In the Widget Layout Editor that pops up, set the properties as follow:

    • Hide label: checked
    • Add surrounding form: unchecked
    • Custom configuration properties: dropContext: ContentView
  6. Click on Save.
  7. Click on the icon  of the Drop zone widget.
  8. In the first line, drop a Generic widget from More widgets > Advanced widgets.
  9. In the Widget Layout Editor, set the properties as follow:

    • Hide label: checked
    • Widget type: documentActionsWithForms
    • Category: Folder Toolbar
    • Actions Display: Buttons
    • Overall display: Horizontal bloc
  10. Click on Save.
  11. In the second line, drop a Content View widget from Featured widgets > Tab widgets.
  12. In the Widget Layout Editor, set the properties as follow:

    • Content View name: Select the content view you want to display.
  13. Click on Save.
  14. Cick on Go back to previous page to go back on the tab definition screen.
  15. Go to your tab's Activation tab and set the conditions (permissions, document types, etc) to make the new tab visible. Save.

Now you just need to hot-reload your Studio project. And a new tab will be visible for the selected document types.