Page tree
Skip to end of metadata
Go to start of metadata


Linchpin Navigation Menus

Always keep the overview: A menu to provide structure and guide you quickly

See the documentation for your Release



Menu Structure


The structure page contains the following parts: header, menu table and footer.


Header

The header section provides the following possibilities:

  • add top-level menu entries, category entries and separators
  • preview the current menu structure (if Linchpin Manager is installed and activated, you can preview the menu using the given filter values)
  • load a menu from the history of saved menus
  • export the most recently saved menu to a file
  • import a previously exported menu from a file
  • open this administration guide

The header is sticky and will always be on top of the page, even if you scroll down.

Preview your navigation structure

To see a preview of your current navigation structure simply click on the preview button in the right panel. You can also use the filter boxes to simulate a Confluence user's profile values to see how your navigation structure would be displayed for this user.


Add menu entries

You have the following options to add top-level menu entries:

  • Category item: Use category items to group sub menu entries together. Category items don't link anywhere.
  • (Main) Menu item: Normal menu entries which will be displayed as list entries with a link to the target page or URL. (See Adding Confluence links and external links)
  • Separator item: To separate groups of different menu items you can use a separator line.

The field for adding links has an auto completion for Confluence spaces and pages. Permission will be respected, so if a user has no permission to view a page, the link won't be shown. If you paste a confluence link by hand, the plugin will resolve this link and build a readable entry as if you added it by auto completion. This only works, if your configured base URL matches the pasted URL. Please be aware, that this is necessary for checking content permissions for the user!

You can also add external links, which will not be checked by the Navigation Menu Editor. So make sure they work and are available from your Confluence. External links will show a small icon for the user to indicate the link leads away from Confluence.

(warning) We differentiate between page and space links. Page links lead to a certain page, space links to the current space homepage. Note that space homepages can be changed and a space link will lead to the space home page, whereas a page link still leads to the old one. You can differentiate page and space link by their icon at the auto completion.



Menu table

Table header

The table header is also sticky.

NameDescription
IDMenu entry numbering. Represents the current level and position of menu entries and will change when the menu structure is changed (no unique ID).
IconAdd an icon to the entry that will be shown before the title.
TitleThe title of the entry. For menu items the title will default to the page or space name if a Confluence page or space is selected in the "Link" field.
LinkOnly for menu items. Start typing a page title or space name and an autocompletion dropdown will appear. You can also enter external URLs or leave the field blank to create a link to the dashboard.
You can configure if a link should be opened in a new browser tab/window by checking the box.
Filter fields
("Branch", "Country", "Department") 
You can assign all menu entries to users with given profile field values, for example their branch, country or department. See Display navigation entries based on user values
PositionMove the menu items by Drag'n'Drop or use the buttons in each row to change the order or level.
ActionsEdit, add or remove sub menu entries. "+ / Add" opens a context menu, where you can select which type of entry you want to add as a sub entry of the current entry.

Footer

The footer is also sticky and will always be at the bottom of the page.

Drafting vs. Publishing

By clicking on "Save changes" a draft version of the menu is saved for further editing or publishing. Drafts are not visible to end users until they are published. By clicking on "Publish menu" the current menu is saved to a new version and is visible to end users. By clicking "Cancel editing" the currently displayed menu structure is not saved and the menu will be reset to the most recently saved version. The buttons are only clickable when they make sense (i.e., after the menu has been changed).

If an unpublished menu draft exists, any other editor opening the menu structure screen will see a warning message that there are unpublished changes. This message also shows the last user who saved the draft and the date and time the version was saved.

All published versions are marked in the history with a (tick) icon.





  • No labels