This is the documentation for FishEye 3.2. View the latest version of

Unknown macro: {spacejump}

or visit the latest FishEye documentation home page.


FishEye has a "watch" notification system that sends email notifications to users when commits are detected. Users can opt in for these notifications by "watching" a particular repository/activity stream.

Email notifications in FishEye can be customised to change their formatting, by editing template files. This page contains instructions for this process.

Editing FishEye email templates

Template files for FishEye are stored in the FISHEYE_HOME/templates/ folder.

There are sets of templates for both HTML and plain-text emails, as listed in the table below. Note that these templates do not support embedding full diffs into notifications. They are only for changing the appearance and order of certain content inside the messages.

You can edit templates in any text editor.

After an edit, the change to the email template will take place immediately. No restart is required.

If you edit the templates of an operational FishEye instance, you may disrupt notifications that are being sent at that time. To avoid this, shut FishEye down during template editing.

Try and avoid editing the live template file, as FishEye may try to use it while you are editing. This could have unpredictable results. Instead, back up the template file (it's wise to keep original versions of all these files), edit a copy you have made, then overwrite the 'live' template once you have finished.

Advanced editing of FishEye email templates

The email notification templates use the Freemarker format. Freemarker is a general templating engine enabling automated content.

If you are familiar with Freemarker, more advanced customisations can be made to the email notification templates. However, you make such adjustments at your own risk.

FishEye email template file list

The following template files for FishEye notifications are stored in the FISHEYE_HOME/template/fisheye/ folder.
 

 

LocationTemplate filename

Purpose

CommonFISHEYE_HOME/template/fisheye/html/changeset-mail-subject.ftlSubject template
 FISHEYE_HOME/template/shared/html/changeset-header.ftl 
 FISHEYE_HOME/template/shared/util.ftl 
HTMLFISHEYE_HOME/template/fisheye/html/changeset-mail.ftlHTML email template
  fisheye-layout.ftl 
  password-reset.ftl 
  plugin-notification.ftl 
  verify-password-reset.ftl 
Plain textFISHEYE_HOME/template/fisheye/plain/changeset-mail.ftlPlain text email template
  fisheye-layout.ftl 
  fisheye-support-request.ftl 
  password-reset.ftl 
  plugin-notification.ftl 
  verify-password-reset.ftl 

See also Customising Crucible Email Notifications.

  • No labels