Configure the Console for different environments - BloomReach Experience - Open Source CMS
06-12-2019

Configure the Console for different environments

It is recommended to configure the Console application to create a visual cue for users so they are aware of the environment they are working in (test, acceptance, production), in order to prevent mistakes from happening when a user has multiple consoles open in different environments.

For this purpose, it is possible to configure the page title, the favicon, and the style of the menu bar. 

Adjust the page title

Specify the following properties on  /hippo:configuration/hippo:frontend/console/console/root:

  • page.title ( String) to differ from the default "Bloomreach Experience Manager console"
  • page.title.showservername ( Boolean) to add the ServerName from the HttpServletRequest to the title after a separator
  • page.title.separator ( String) to differ from the default @

Adjust the color of the menu bar

Specify the following properties to  /hippo:configuration/hippo:frontend/console/console/top:

  • bar.styles ( String, multiple)
  • bar.style.urlparts ( String, multiple)

Both properties must have the same number of values. The URL parts will be compared to the current URL of the request. The first one that matches will be chosen. A match is found when the url contains the urlpart given. The corresponding bar.style will be applied to the div that is the background to the buttons. An example could be "background: orange;" to give that bar an orange color. This way you can apply a strong visual cue to help the user be aware of the environment he is working in.

Suppose your application runs on test.myapp.com, acct.myapp.com, www.myapp.com/cms. Then you can add these three values in  bar.style.urlparts. Giving distinguishing parts will also work.

Adjust the favicon

Specify the following properties on /hippo:configuration/hippo:frontend/console/console/root

  • favicon.path

Possible values are:

  • console-red.png (the default)
  • console-green.png
  • console-yellow.png
  • console-blue.png
  • console-orange.png
  • console-purple.png

You can create an icon of your own. Place that in you CMS module in a folder  src/main/resources/org/hippoecm/frontend/plugins/console. Use the name of your icon (i.e. my-console-fav.png) as the favicon.path property.

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?