4.5.4. Creating a Project-Specific UI Theme

You can create specific UI themes for different projects and then point a particular UI instance to use a defined theme on startup. To create a complete custom theme, follow these steps:

  1. Shut down the OpenIDM instance, if it is running. In the Felix administration console, type:

    shutdown
    ->
  2. Clear the felix-cache directory.

    $ rm -rf felix-cache
  3. Copy the entire default UI theme to an accessible location. For example:

    $ cd /path/to/openidm/ui
    $ cp -r default ../new-project-theme
  4. In the copied theme, modify the required elements, as described in the previous sections. Note that nothing is copied to the extension folder in this case - changes are made in the copied theme.

  5. In the openidm/conf/boot/boot.properties file, add the following line, specifying the location of the new theme. The path is relative to the installation root of the OpenIDM instance.

    openidm.ui.fileinstall.dir=new-project-theme
  6. Restart OpenIDM.

    $ cd /path/to/openidm
    $ ./startup.sh
  7. Relaunch the UI in your browser. The UI is displayed with the new custom theme.