Setting up quick header links
Setting up quick header links
Header actions function as shortcuts to link to any page or saved view and to create new cards of any type. You can create header actions by creating a page called Special:HeaderActions. These shortcuts display in the top part of your project's header, as in the following image:
- To learn quick steps to create a special header, read our tips and tricks for special headers page.
- There are no buttons or links for creating special header links - you set them up by creating a new 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 pages
URLs for pages are simple - they are always in this format:
/projects/project_identifier/wiki/page_name
- Here page_name should be replaced by the canonicalized name for the page you are linking to, that is with all lowercase and spaces replaced by underscores (e.g. "My page" becomes "my_page").
- and Link Name can be any text you wish to display in the header.
To obtain the URL of a page, navigate to the page and copy the URL from your browser.
-
Pages:
/projects/project_identifier/wiki
This references the root page, which lists all pages in your Mingle project, and is also available in the Project admin tab Pages link.
-
My work:
/projects/project_identifier/wiki/My_Work
This references a user created 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:
/projects/email_application/cards/new?properties[Type]=defect&properties[Status]=new&properties[Release]=R1
This URL would create a card of type defect with a status of "new" in Release "R1". There are further examples below.
-
New bug:
/projects/project_identifier/cards/new?properties[status]=new&properties[type]=bug
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:
/projects/project_identifier/cards/new?properties[status]=new&properties[type]=story
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:
/projects/project_identifier/cards/new?properties[status]=new&properties[type]=risk
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 setup 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 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 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 page.
-
Click the Save link.
Mingle displays the new quick header links at the top of your project page and creates a new 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.