Themes

Owned by Ryan Clifton
Last updated: Apr 06, 2023
3 min read

Summary

Themes define the styling of the template contents. This uses Velocity Macros and CSS. The Built-in system themes and imported themes are read-only. However editable copies can be made.

Creating a new Theme

  1. Go to Notifications > Theme > Create

  2. Select the theme, e.g. JIRA (System), as your source of templates and then select the Issue Template Sets required (CTRL + left mouse click).

  3. Submit. This will copy the JIRA theme, 3 Template Sets and it will take you to the new theme edit screen.

You will now be able to modify the theme Macros and Styles.

 

Macros

Macros are reusable ‘methods’ that can be defined and called from templates to reduce the complexity of those templates. Macros defined here can only be used by templates that use this theme.

You can only test the Macros once you have selected a preview template set and a preview context

$jemhUtils.setFieldRendered() and $jemhUtils.setCommentRendered() mark the template as not empty. If you are adding a custom field to your template, remember to write $jemhUtils.setFieldRendered() otherwise you may see a 'email has not been sent as no useful information was set' warning.

Styles

This is the Css content that is to style the different elements of Template.

You can only test the Styles once you have selected a preview template set and a preview context

Previewing the Theme

JEMHCloud provides a preview tool that allows you to see the review your template against read event data. 

  1. Go to Notifications > Preview. Select the new Issue Created Template set named Issue Created: Issue Created Jira Support (User)

  2. Then select a Template Set, Template Type And Preview Context to use when previewing the notification

  3. Press Preview to test the Theme