Setting up quick header links

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

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

You can use these shortcuts to create quick links to Mingle's wiki pages, a 'my work' page, and 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 below.

Example URLs: Where you see <your project> below, substitute this with your project name as you can see in your browser's address bar.
Wiki pages: <a href="/projects/<your project>/wiki">Wiki Pages</a> (This is the same as the page under Project admin > Wiki pages.
My work: <a href="/projects/<your project>/wiki/My_Work">My Work</a> (This references a wiki page called 'My Work'. See Example my work macro for details.)
New bug: <a href="/projects/ice/cards/new?properties[status]=new&properties[type]=bug" accesskey="b">+Bug</a>
New story: <a href="/projects/ice/cards/new?properties[status]=new&properties[type]=story" accesskey="s">+Story</a>
New risk: <a href="/projects/ice/cards/new?properties[status]=new&properties[type]=risk" accesskey="r">+Risk</a>

Obtaining URLs for quick header links

URLs for wiki pages are simple - they are always in this format: <a href="/projects/<your project>/wiki/<wiki_page_name">Link Name</a>.

URLs for new cards are more complicated.

How to locate URLs for new cards

1. 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.
2. Click the All tab (or any other tab that displays cards).
   Mingle displays all cards (or those that match the preset filters).
3. In the Filter list by... section, select the card filters according to the criteria you want to establish in the quick link for creating the new card.
   For example, if you want to create a shortcut for a new bug, you might select Release: R1, Status: new, Type: defect.
   
   
   
4. Wait for Mingle to filter the list of cards and then click the Add with detail... button.
   Mingle opens a new card.
5. Copy the URL that displays in the browser address bar.
   It should look something like this: 
   http:/mingle.acompany.com/projects/email_application/cards/new?filter_properties[Type]=defect&filter_properties[Status]=new&filter_properties[Release]=R1
6. Remove everything in red, i.e. the front part of the URL and anything that mentions filters.
7. Add HTML link tags around this URL.
   So the example above becomes the URL below:
   <a href="/projects/email_application/cards/new?properties[Type]=defect&properties[Status]=new&properties[Release]=R1" accesskey="d">+Defect</a>

This is now ready to paste into the Special:HeaderActions wiki page.
See How to Set Up a Quick Header Link below.

How to set up a quick header link

1. Identify which quick header links you'd like to create and take a note of their URLs.
2. Sign in to Mingle.
   You don't need to sign in as a project or Mingle administrator.
3. 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.
   
   
   
4. Type or paste the URLs for your quick links into this wiki page.
5. 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.
6. Test whether your new quick header links work as intended.
   If not, double-check the URLs and repeat.

Back to Setting up Mingle project environment and navigation