Themes

Themes allow a user to quickly stylize reports or elements of reports such as maps and charts. This article covers Chart, ExpressView, CrossTab, GeoChart and Express Report Themes. For styling the entire user interface, refer to the Application Themes article. Any further references to Themes throughout this article refers specifically to the aforementioned visualization and report types.

Note

This article references <WebApp>/, as a placeholder for the Web Application install location. The default install location is C:Program FilesExagoExagoWeb on Windows or /opt/Exago/ on Linux. These directories can be changed during installation.

Exago comes with several themes pre-installed. Pre-installed themes are saved in the <WebApp>Themes folder of Exago.

Chart Themes

A user can quickly select colors for Charts by applying a chart theme.

There are two way to create a chart theme:

• Manually
  1. In folder specified in the Admin Console > General > Main Settings > Report Path create a text file containing a comma separated list of the hexadecimal values of the desired colors.
  2. Save the file with the theme name.
  3. Change the extension to .wrth.
• With the Exago Theme Maker
  1. Launch the Exago Theme Maker, and follow the instructions in the Exago Theme Maker article.
  2. Download the theme created with the Theme Maker.
  3. In folder specified in the Admin Console > General > Main Settings > Report Path, save the .wrth  file.

Note

The file name will be displayed to the end user. To translate the name of a custom theme, see Multi-Language Support for Theme Names below.

Example

The theme file below implements the built-in theme Autumnal Sunset.

#FFAA5C,#DA727E,#AC6C82,#685C79,#455C7B

ExpressView Themes

A user can quickly style ExpressViews by applying a theme. Custom theme creation is covered below:

• Create a Custom ExpressView Theme (v2021.1+)
• Create a Custom ExpressView Theme (v2017.1–v2021.1)

CrossTab Themes

A user can quickly style CrossTabs by applying a theme. CrossTab themes can specify background color, foreground color, section shading, borders, fonts and text size.

To create custom CrossTab themes:

1. Create a CrossTab with several Tabulation Data cells, Row Headers, Column Headers as well as sub-totals and grand totals. We recommend CrossTab Themes have at least five Row Headers, Column Headers, Tabulation Data, sub-total rows, and sub-total columns as well as a grand total row and a grand total column.
   

   Note

   If a user adds more Tabulation Data, Row Headers or Column Headers than existed on the theme they will appear without styling.

2. In the Report Designer stylize each cell as desired.
3. Hover the mouse over the CrossTab. Notice the CrossTab Design Menu  icon appears in the bottom left corner.
4. Hold Ctrl + Alt + Shift and click on the CrossTab Design Menu  icon
   

   

5. Click  Save as Theme.
6. Enter a name for the theme. This name will be displayed to the end-users.
   

   

GeoChart Themes

A user can quickly select colors for GeoCharts by applying a theme.

There are two ways to create GeoChart themes:

• Manually
  1. In folder specified in the Admin Console > General > Main Settings > Report Path create a text file containing a comma separated list of the hexadecimal values of the desired colors.
  2. Save the file with the theme name.
  3. Change the extension to .wrtm.
• With the Exago Theme Maker
  1. Launch the Exago Theme Maker, and follow the instructions in the Exago Theme Maker article.
  2. Download the theme created with the Theme Maker.
  3. In folder specified in the Admin Console > General > Main Settings > Report Path, save the .wrtm  file.

Note

The file name will be displayed to the end user. To translate the name of a custom theme, see Multi-Language Support for Theme Names below.

Express Report Themes

A user can quickly style Express Reports by applying a theme. Express report themes can specify background color, foreground color, section shading, borders, fonts and text size.

To create a custom Express Report theme:

1. Create an Express Report with Headers, Footers and a Page Header/Footer and a Grand Total. We recommend Express Report Themes utilize many Columns, Headers and Footers.
   

   Note

   If a user adds more Columns, Headers, or Footers than existed on the theme they will appear without styling.

2. In the Layout tab stylize the report as desired.
3. Hold Ctrl + Alt + Shift and click on the Save  icon.
4. Enter a name for the theme. This name will be displayed to the end-users.
   

   

Multi-Language Support for Theme Names

To support multi-language functionality, if the theme name concatenated with ‘_wrThemeId’ matches the id of any element in the language files then the string of that language element will be displayed to the user instead of the theme name.

For example, in the Basic theme that is installed with Exago, there exists a language id ‘Basic_wrThemeId’. The string associated with this id is displayed. For more information see Multi-Language Support.