Global settings

1 Where are you?
2 Introduction
3 Global JavaScript/CSS
- 3.1 CSS
4 Edit footer content
5 Files
- 5.1 Delegated project admin

Where are you?

Introduction

The global system settings can be accessed from the Help Center page or from a specific portal

The link structure will normally be:

Helpcenter: http://mybaseurl.com/servicedesk/customer/portals

Portal: http://mybaseurl.com/servicedesk/servicedesk/customer/portal/1

Global JavaScript/CSS

The app allows you to insert javascript and CSS.

JS will be evaluated when a page is loaded. CSS is injected automatically.

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:

(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()
  })
})()

CSS

Start by going to configuration options on the service desk and select Global JavaScript/CSS from the administration top bar. You will be met with a dialog with 2 tabs. Go to the CSS tab

Here we can add custom CSS. An example for the front page could be that we wanted to change the color and font of the “cv-help-center-page-title”. (The title that customers are met with on /jira/servicedesk/customer/portals).

You can use your web browsers inspector (Usually found by clicking f12) to inspect elements and find their html id or class. See how CSS selectors work and more here: https://www.w3schools.com/css/css_selectors.asp

In the custom css dialog we decide that we would like to try a different font and color for the title, so we add the following css:

#cv-help-center-page-title {
  font-family: "Comic Sans MS", "Comic Sans", cursive;
  font-weight: bold;
  color: #ff4211;
}

When we refresh the page, we should be met with this:

Edit footer content

The App allows you to insert custom text or HTML to the footer.

Files

The app allows you to upload files to use in HTML modules. Go to Ultimate menu → Files. Upload and administer files here.

Delegated project admin

Go to permissions, and enable it. When enabled, project admins can edit portal pages that belong to the project.