Enabling, Configuring, and Creating New Customizations for FogBugz


Follow

Overview

The customization feature in FogBugz allows you to add client-side JavaScript and CSS to the application. You can use code and stylesheets to tweak the UI and support workflows as needed. This feature was inspired by the GreaseMonkey browser extension and operates similarly. 

This article focuses on configuring, enabling, and creating new customizations for FogBugz account.

Please also read Writing Customizations and using Templates and Samples codes for Customizations.


Solution

Disclaimer! The FogBugz user interface, including global JavaScript objects and DOM elements, can and does change without warning. If you experience issues with FogBugz after applying a customization, or your customization does not work following a new release, please confirm that your customization is working as expected.

This guide is intended for FogBugz On Demand and FogBugz On Premises. If you are running FogBugz For Your Server, please review this article on Customizing FogBugz For Your Server with BugMonkey.

Enabling Customizations

To use Customizations you need to have the Customizations option enabled:

Back to the top


Configuring Customizations

Accessing the Customizations Page

To access the available customizations, do the following:

  1. Log in to your FogBugz account.

  2. From the Avatar menu, choose Customizations.

    mceclip0__2_.png

    The main view shows a list of all customizations currently active.

    mceclip1.png

  3. From here, you can click on the title of a script to edit it, click ON or OFF in the Enabled column to enable or disable the customization or click Edit Rules to set the rules that are making it available for other users.

    Note: You may choose to make the customization available for other users (under Rules). For example, you can enable if it defaults to ON or OFF for other users and if it is required.

 

Adding a New Customization

From the Customizations section, do the following:

  1. Click New Customization to create a new script. 

    mceclip1__1_.png

  2. In the new screen, give it a namedescription, author, version and fill in the JavaScript and CSS sections with your code.

    mceclip2.png

    Site admins are offered a Site Configuration button on the page to allow them to set which users or groups are permitted to create customizations.

     mceclip5.png

  3. Save it and enable it for your user by setting the Enabled for you under the script box to Yes.

  4. Edit the Rules for customizations, if you would like to make it available for other users, too.

    Note: You can also enable scripts that others have shared in your FogBugz instance under the Your Available Customization list. Site admins are offered a Site Configuration button on that page to allow them to set which users or groups are permitted to create customizations.

Back to the top


Related Articles

 

Back to top