Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

With Refined you can add several sites to one Jira instance. Sites are separate landing pages creating different, and separate, areas of your Jira. 

Sites are added and managed in the Site Builder within Refined Administration. This is also where you add, remove and organise Refined sites and categories. 

...

Creating different Refined sites in your Jira instance lets you provide users with custom ITSM, help and support sites – giving everyone the help they need. For example, you can create one IT help desk that includes your Jira projects related to IT, and one HR help desk that includes your HR-related Jira projects.

Site Builder

The Site Builder is the essence of your Refined site. Here, you can:

  • Build a site’s structure and navigation.

  • Create categories.

  • Apply themes.

Access the Site Builder

  1. Go to Jira Administration > Manage apps.

  2. Click Refined ConfigurationClick on > Open Refined Administration.

Or:

...

  1. On the

...

  1. Refined site

...

  1. From the Refined Site, click the settings cog Cogwheel in the top right corner. 

  2. Click on Site Builder. 

...

Global JSM site and additional Refined sites

Refined is set up a bit differently, depending on which Jira solution(s) you have installed.

When you have installed Refined (version 2.0 and newer) on an instance with Jira Service Management, there is always your Help Center from native JSM is replaced by a Global JSM Sitesite. This site is the equivalent to the Help Center of default JSM, which can’t be removed and holds all your JSM projects. It can have the default JSM look and feel, or you can add a theme to it with Refined.

Globally activated Refined JSM site

Having the Global JSD Site themed means that every JSD portal will be activated in Refined. 

...

In this example the two JSD portals will be in a Refined Site. 

Any Jira Service Desk project that exist on the site will show up in the Global JSD Site

An default Global JSD Site

...

In this example the two JSD portals will be in the default JSD theme and site. 

Having Refined not activated globally means that JSD portals in the global site will not be themed, while JSD portals in the other Refined Sites or categories will be themed. 

Refined for Jira Core and Jira Software

When Jira Core and Jira Software are used either independently or together but without Jira Service Desk, there are no Refined Sites when Refined is installed. Any Refined Site will be manually created. 

...

Any Jira Core or Jira Software project that you want to add to a Refined Site will need to be manually added to the site - this means that you hand-pick what projects goes on a Refined Site. 

...

Combining Jira Core, Jira Software and Jira Service Desk

You can add projects of any kind to any site, this is completely up to you. As soon as you have Jira Service Desk the Global JSD Site will be there, and you can add any project type to that site. 

...

In this example there are three categories to further add structure to the Refined Site, and there are two JSD portals and two Jira Software projects in the same Refined Site - in this example the Global JSD Site. 

Additional sites

Any additional site added to the Site Builder will always have the Refined theme activated. 

Creating structure on a Refined Site

Every Refined Site has its individual structure and navigation made by adding categories and Jira items to the site. 

Categories are containers that are added to a site, and can be added in several levels to create sub-categories. 

Adding categories to a site

With version 3.0 you can add custom links, any URL to any place on the internet in your structure. Simply use "Add a link" to add a link to a site or a category.

...

You can also add projects from Jira Core and/or Jira Software by clicking the + (Plus) icon > Include Jira projects.

Aside form the Global JSM site, you can add as many additional sites as you want by clicking the Add site button in the Site Builder. Drag and drop projects away from the Global JSM site into the additional sites, or add them by clicking the + (Plus) icon > Include Jira projects.

When you have installed Refined on an instance with only Jira Core and/or Jira Software, there is no global site. Create one or more Refined sites by clicking the Add site button in the Site Builder, and add projects to them by clicking the sites' + (Plus) icon > Include Jira projects.

Turn off Refined on the Global JSM site

By default, Refined applies to all sites, including the Global JSM site. If you prefer to keep the default JSM look and feel on the Global JSM site instead, go to the Jira Service Management tab and turn off Activate Refined globally.

Create and set up a site

To create a site, go to the Site Builder > click the Add site button.

Setting

Description

Name

Site name.

URL path

Choose your sites’s URL: ../plugins/servlet/desk/site/url-path

Start site for groups

Direct users from specific Jira User Groups to this site when they log in.

Start site for anonymous users

Make this site the default start site for users who are not logged in.

Navigation

Setting

Description

Show site switcher

The Site Switcher is an easy way for users to navigate between your Refined sites.

Main navigation

Determine the style of the category menu.

Permissions

View permissions determine which users can see the site. Note that users with a URL to a portal that they are allowed to see in JSM will show the portal even though the user can't see the site itself.

Administrator permissions determine who can manage the site.

Theme

Click Change theme to apply a specific theme to this site. Alternatively, click Use default theme to apply the global theme.

Edit a site

Change a site’s settings by clicking its Cogwheel > Edit. You can edit the settings that you made when setting up the site (see the table above), as well as the site logo, favicon and app logo.

Add content and structure

Add categories, links, and Jira projects by clicking a site’s + (Plus) icon, or by simply dragging and dropping them from another location in the Site Builder.

Add structure to your sites by organising your Jira projects into categories and subcategories. Since Refined version 3.0, you can also add custom links in the Site Builder.