View a document in a channel
The document editor contains a 'View' menu that lists the names of all channels that document can be viewed in. Clicking on a channel name shows the document in that channel in the Channels Perspective.
The list of channels for the document is fetched from HST through a REST call. The CMS contains a 'REST proxy' service that uses a CXF JAX-RS client to create a proxy from classes that represent a REST service. These classes are provided by the HST in the ' hst-rest-api' module.
REST proxy service
The REST proxy service to use for the HST can be configured at:
rest.uri the URI at which the CMS can access the 'CMS REST service' run by the site. Default value: ' http://127.0.0.1/site/_cmsrest'
The default host name (' 127.0.0.1') and mount (' _cmsrest') are set via Spring configuration in HST, and can be overridden if needed.
By default (if not explicitly specified) the port of the rest.uri is automatically derived to use the current request (local) port serving the CMS.
This allows running multiple CMS cluster instances on the same host, using different ports.
Should be ' org.hippoecm.frontend.service.restproxy.RestProxyServicePlugin'
CMS service ID to use in the plugin framework.
Default value: ' hst.rest.proxy.service'
HST will automatically add a mount for the CMS REST service to the HST hosts configuration at runtime.
If everything is configured correctly, the following URL (using example port 8080 configured for the Tomcat container) should return all channels for the UUID of a hippo:handle of a document:
The 'View' menu itself is rendered by the 'channel actions' plugin. Its configuration is located at:
The channel actions plugin recognizes the following properties:
Service ID of the CMS REST proxy service to use.
CMS plugin class that renders the menu.
Removing the 'View' menu for channels
The view menu for channels can be removed by removing the plugin configuration at /hippo:configuration/hippo:workflows/default/handle/frontend:renderer/channelactions.