Adding New Themes

Themes determine the colors of the title bar and gadget windows in Openspace. From the Themes Selector in Openspace, users can select different themes for some or all of their gadgets, depending on their requirements.

Selecting different themes for different gadgets is a useful way of distinguishing between them. See "Selecting Themes" in the TIBCO Openspace User's Guide for more information

By default, four themes are available in the Themes Selector when you first log into Openspace. However, you are allowed six themes in Openspace in total. In other words, you could have six themes in your Themes Selector, if required. You can use the theme properties in the config.properties file to determine which themes are available in the Themes Selector. You can also add new themes and make them available in the same way.

The four available themes are:
  • theme.a=tibco
  • theme.b=default
  • theme.c=black
  • theme.d=red

There can only be a maximum of six themes available in the Themes Selector. Themes must be numbered sequentially and there can be no gaps in the numbering.

You can make all four themes available, add new themes or restrict the number of themes available by commenting out the ones you do not require.

Warning: As themes must be numbered sequentially with no gaps in the numbering, this means you cannot comment out theme.a and enable theme.e. You must enable theme.a, then theme.b, then theme.c and so on.

If no themes are enabled then, theme.b=default is used.

To add a new theme, create your new .css file, and save it, along with any images, to the themesArchive folder. For example, C:\ProgramData\amx-bpm\tibco\data\tibcohost\Admin-AMX BPM-AMX BPM Server\data_3.2.x\host\plugins\com.tibco.openspace.login_1.6.0.013\resources\themesArchive\newTheme.
Note:
  • You could use the default.css as a template and amend it accordingly.
  • There are 6 themes available in the themesArchive folder. However, silver and purple are deprecated themes. You must not base your custom themes on these as they are not maintained.
  • There must be no spaces in your theme name.
  • Create a new theme_icon.gif as a thumbnail to distinguish the new theme from the other themes.

Once you have created your new theme, amend the next available theme property in your list in the config.properties file. For example, if theme.a and theme.b are enabled, the next theme property is theme.c=newTheme. As only six themes can be available in the Themes Selector at any time, make sure you have the correct number of themes commented out. In other words, if you have six themes currently available for selection and you want to add a new one, you must uncomment one of the existing themes before your new theme can be available in the Themes Selector.

See Openspace Configuration Overview for information about the config.properties file.

Prerequisites

  • Make sure you have created your new .css file, and saved it, along with any images, to the themesArchive folder.
  • TIBCO recommends you take a back up of the config.properties file before amending it.

Procedure

  1. Open the config.properties file in a text editor.
  2. (Optional) If you have created a new theme, amend the next available theme property in your list. For example, theme.e=newTheme
    If all six themes are enabled, amend one of the existing theme properties.
  3. Save and close the config.properties file.
  4. Log out and log back into TIBCO Openspace for the changes to take effect.