How to configure custom project quicklaunch - Puzzlepart/prosjektportalen GitHub Wiki

Introduction

In order to configure a custom project quicklaunch, you need to create an extension file. You can use any editor you want as long the file extension is .txt.

Creating the extension file

Open Notepad or similiar. We now need to write some JSON.

TIP: You can use http://jsoneditoronline.org/

You can use this as starting point:

{
  "Navigation": {
    "QuickLaunch": [
      {
        "Url": "SitePages/ProjectHome.aspx",
        "Title": "Hjem",
        "IgnoreExisting": true
      },
      {
        "Url": "SitePages/ProjectStatus.aspx",
        "Title": "Prosjektstatus"
      },
      {
        "Url": "Lists/Oppgaver/AllItems.aspx",
        "Title": "Oppgaver",
        "Children": [
          {
            "Url": "SitePages/Assigned.aspx",
            "Title": "Mine prosjektelementer"
          }
        ]
      },
      {
        "Url": "Delte%20dokumenter/Forms/AllItems.aspx",
        "Title": "Dokumenter"
      },
      {
        "Url": "Lists/Usikkerhet/AllItems.aspx",
        "Title": "Usikkerhet"
      },
      {
        "Url": "Lists/Prosjektleveranser/AllItems.aspx",
        "Title": "Prosjektleveranser"
      },
      {
        "Url": "SitePages/GainsOverview.aspx",
        "Title": "Gevinstoversikt",
        "Children": [
          {
            "Url": "Lists/Endringsanalyse/AllItems.aspx",
            "Title": "Endringsanalyse"
          },
          {
            "Url": "Lists/Gevinstanalyse og gevinstrealiseringsplan/AllItems.aspx",
            "Title": "Gevinstanalyse og gevinstrealiseringsplan"
          },
          {
            "Url": "Lists/Gevinstsoppflging/AllItems.aspx",
            "Title": "Gevinstsoppfølging"
          }
        ]
      },
      {
        "Url": "_layouts/15/viewlsts.aspx",
        "Title": "Områdeinnhold",
        "IgnoreExisting": true
      }
    ]
  }
}

As you can see, a navigation link consists of three properties or attributes.

1. Url
2. Title
3. IgnoreExisting
4. Children

1 and 2 are required, while 3 and 4 is optional.

Url

URL relative to the project web

Title

Title of the link

IgnoreExisting

If set to true, an existing link with the same title will be ignored, and the new Url will be used.

Children

A collection of child links

When you're done adding your desired links, save the file with extension .txt.

Upload the extension file

Find the library

1. Go to Site Settings
2. Under Look and Feel / Utseende og funksjonalitet you'll find Project Portal - Extensions / Prosjektportalen - Utvidelser
3. This link will take you to the extension library where you can upload your extension file

Configure the extension item

After upload your .txt file, it's time to look at the extension item.

Open the edit form of the extension file.

The edit form should look something like this:

1. Rekkefølge

Order of execution. Important in some advanced cases where you have multiple extensions dependent on each other.

2. Aktivert

Is the extension activated, meaning should it be executed when creating new projects.

3. Vis i skjema

Should the extension be visible and selectable in the new project form.

4. Navn

Filename (not important)

5. Tittel

Add a descriptive title

6. Kommentarer

Add comments (optional)