Nuxeo Server

How to Make JSF UI the Default UI

Updated: March 18, 2024

In case both nuxeo-jsf-ui and nuxeo-web-ui addons are installed, the new Web UI is set to be the default UI. If you want to make the JSF UI the default UI there are several changes to apply.

Login Page Redirection

To make the login page redirect to the JSF UI instead of the new Web UI you need to add the following XML contribution:

<extension target="org.nuxeo.ecm.platform.ui.web.auth.service.PluggableAuthenticationService" point="loginScreen">
  <loginScreenConfig>
    <startupPages>
      <startupPage id="jsf" priority="1000" />
    </startupPages>
  </loginScreenConfig>
</extension>

Note that the default priority values are:

  • Web UI (id="web"): 100
  • JSF UI ( id="jsf" ): 10

The highest priority wins.

To make the document permalinks generated by the server (and used in email notifications typically) point to the JSF UI instead of the Web UI you need to add the following XML contribution:

<extension target="org.nuxeo.ecm.platform.url.service.DocumentViewCodecService" point="codecs">
  <documentViewCodec class="org.nuxeo.web.ui.url.codec.WebNotificationDocumentIdCodec"
                     enabled="true"
                     name="notificationDocId"
                     prefix="doc"
                     priority="1000" />
</extension>

Nuxeo Drive Global Configuration

To make Nuxeo Drive handle proper links to the Nuxeo server UI you need to change the ui setting of the Nuxeo Drive global configuration from web to jsf.