Versions Compared

Key

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

...

...

...

...

...

...

...

...

Table of Contents

Introduction

This is the documentation and help page for the latest version (4.x) of the Ultimate Theming for Jira Service Desk.

...

What changed from version 2 to version 3

  • Added modular approach for building content (with content+sidebars or a customized grid). Removed functionality of themes.

  • Added full sorting of fields in ”Requests”.

  • Added fields to filter on in ”Requests”.

  • Improved fetch of SLA info.

  • Improved the generation of CSV in ”Requests”.

  • Edit ”Sign up” and ”Knowledge base” pages.

  • Added global JavaScript/CSS

  • Global files (can always be linked to from every page)

Installation

Installation in Jira is through Atlassian Marketplace, or by downloading a version and uploading into the Addons section of Jira.

...

Otherwise click Edit, in the right bottom of the request list. Then you will see the options available.

Next, please read here, for a more detailed documentation.

...

For javascript you have some variables available:

  • window.AJS.$ - contains a jQuery selector

  • window.ULTIMATE_SERVICEDESK_LOCATION - this contains info about the current location/page.

If you unfortunately input js/css that make the page not load, then add the following parameter and value to the URL: ?globaljs=false or ?globalcss=false. This will make the js/css not load.

Then correct your js/css and try reloading the page without the parameters.

As a last resort, if page still fails to load because of js/css, then call the following urls to clear the content (js or css):

  • JIRABASEURL/rest/net.koncis.ultimate/latest/admin/globaljsandcss/resetjs

  • JIRABASEURL/rest/net.koncis.ultimate/latest/admin/globaljsandcss/resetcss


A good template for adding JS is this:

Code Block
languagejslinenumberstrue
(function(){
  if(window.CUSTOM_CODE_LOADED == true) {
    return;
  }
  window.CUSTOM_CODE_LOADED = true;

  your_start_code_function_call()

  window.Portal.Api.on("pageLoaded", function(){
    console.log("do stuff on new view, e.g. check if missing to insert text")
    your_code_on_new_view()
  })
})()

...

There are 5 types of portal pages:

  • Main portal page. It has url ./servicedesk/customer/portal/X, where X is the portal ID, e.g. 4.

  • Request create page. Example url: /servicedesk/customer/portal/10/create/87.

  • Request detail page. This page shows a request from the portal/project. Url example: ../servicedesk/customer/portal/10/EF-6. This page is normally accessed through emails, or the requests page.

  • Portal login/signup page. Can be edited by clickling edit login page (when on a portal main page).

The project admin can upload and delete own files. In the Ultimate → Files, there will be two buttons: Global and User files.

...