Setting up quick header links

In Mingle, you can create header actions which act as shortcuts to any page, saved view, or to create a new card by creating a wiki page called Special:HeaderActions. These shortcuts display in the top part of your project's header, as in the example below.

You can use these shortcuts to create quick links to Mingle's wiki pages, a 'my work' page, and to create new cards (of different types). Since Mingle uses static URLs for most functions and views, you can link to just about anything. Add the

accesskey="x"

command to set up a quick access key. Mingle displays this access key with an underline in the quick header link. You can see this in the example above for +Bug, and in the equivalent URL in the example below. The key combination to activate the access key depends on the user's browser, for Firefox it is Alt+Shift.

There are no buttons or links for creating special header links - you set them up by creating a new wiki page.

Obtaining URLs for quick header links

You do not have to type in the URLs for header actions from scratch, instead you can navigate to the content you want to link to and copy the URL from your browser. How to do this is explained in the sections below:

URLs for wiki pages

URLs for wiki pages are simple - they are always in this format:

<a href="/projects/{{ project }}/wiki/wiki_page_name">Link Name</a>

Here wiki_page_name should be replaced by the canonicalized name for the wiki page you are linking to. This is lowercase with spaces replaced by underscores e.g. "My Wiki page" becomes "my_wiki_page".
and Link Name can be any text you wish to display in the header.

To obtain the URL of a wiki page, navigate to the wiki page and copy the URL from your browser. There are further examples below.

In the following examples, the macro substitution

{{ project }}

is used to insert your project identifier into the URL. This is preferable to hard-coding the project identifier into the URLs, as it means these links will not break should you alter the project identifier or use this project as a template for a new project.

Wiki pages:
```
<a href="/projects/{{ project }}/wiki">Wiki Pages</a>
```
This references the root wiki page, which lists all wiki pages page, also available in the Project admin tab Wiki pages link.
My work:
```
<a href="/projects/{{ project }}/wiki/My_Work">My Work</a>
```
This references a user created wiki page called 'My Work'. In this case the page could hold a table which uses the special value (current user) to present cards which are assigned to the currently logged in user.

URLs for new cards

URLs for new cards are more complicated. The URLs to create a new card need to be in the following format:

<a href="/projects/email_application/cards/new?properties[Type]=defect&properties[Status]=new&properties[Release]=R1" accesskey="d">+Defect</a>

This URL would create a card of type defect with a status of "new" in Release "R1". There are further examples below.

In the following examples, the macro substitution

{{ project }}

New bug:
```
<a href="/projects/{{ project }}/cards/new?properties[status]=new&properties[type]=bug" accesskey="b">+Bug</a>
```
This action will create a new instance of a bug card, with the status property set to 'new' and open it for editing. The access key combination in Firefox would be Alt+Shift+b
New story:
```
<a href="/projects/{{ project }}/cards/new?properties[status]=new&properties[type]=story" accesskey="s">+Story</a>
```
This action will create a new instance of a story card, with the status property set to 'new' and open it for editing. The access key combination in Firefox would be Alt+Shift+s
New risk:
```
<a href="/projects/{{ project }}/cards/new?properties[status]=new&properties[type]=risk" accesskey="r">+Risk</a>
```
This action will create a new instance of a risk card, with the status property set to 'new' and open it for editing. The access key combination in Firefox would be Alt+Shift+r

How to set up a quick header link

Identify which quick header links you'd like to create and take a note of their URLs.
Sign in to Mingle and open the project for which to add quick header links (if you're not already working in this project).

You don't need to sign in as a project or Mingle administrator.
Navigate to the Special:HeaderActions wiki page. In your browser's address bar, type http://your_domain/projects/your_project_name/wiki/Special:HeaderActions and press [Enter]. Where your_domain is the location of Mingle in your organization and your_project_name is your project's name (i.e. the name Mingle assigns your project when first creating the project). If you currently have Mingle open you should be able to see this information in your browser's address bar.

Mingle displays a new blank wiki page, (unless you've already created the Special:HeaderActions page previously, in which case you will need to hit the Edit link to edit the existing page)
Type or paste the URLs for your quick links into this wiki page.
Click the Save link.

Mingle displays the new quick header links at the top of your project page and creates a new wiki page called Special:HeaderActions.
Test whether your new quick header links work as intended. If not, double-check the URLs and repeat.

If you want to see quick steps to create a special header, please take a look tips and tricks for special headers page.