Menu Configuration (Structure)
SubSpace Navigation for Confluence allows you to structure your Confluence by defining central navigation so that your users find their way through the wiki.
Structure
On the left, in the Structure section, the current Menu elements are displayed. You can expand or collapse them all with one click, as well as sort the elements alphabetically and backward, and search for a navigation item of the structure.
Image 1: Sort / Expand / Collapse / Search Menu Elements (click to enlarge)
You can either search for any keywords or text, and the results of the search will be categorized based on the item types. Searching feature is case-insensitive. You can clear out your search term under a click!
Image 2: Clear out search term example (click to enlarge)
Add Menu elements
To add a new first-level Menu element, click the “Add item” button and choose the type of element you want to add. To add a new second-level Menu element, hover over the parent element and click the "+" icon. On the right side, you should enter the name/link/space depending on the type of element you have selected.
Image 3: Add and Delete Elements (click to enlarge)
There are five SubSpace Navigation element types: external or internal links, folders, spaces, or CQL queries. You can find a description of each type and the corresponding configuration options in the table below.
Type | Description | Options |
|---|---|---|
Internal Link | Link to Confluence page or blog post |
|
External link | Link to external web page |
|
Folder | Folders allow you to group navigation elements. They can hold navigation elements of any type, including other folders. |
|
Space | Link to a Confluence space |
|
CQL | Show up to 10 results of a CQL query (please refer to the documentation of the Confluence Query Language). This allows you to dynamically display pages and blog posts that fit the search criteria. Additional links: CQL Function Reference |
|
Using the CQL option in the navigation, powerful individualizations are possible.
Example 1: List recently created pages for the current user:
contributor = currentuser() AND IN type ( "page", "blog post") order by created desc
For this navigation entry, each user will see a list of up to ten recently edited pages and blog posts. The list will be different for each user based on their recent activity.
Example 2: List the favourite pages and blog posts of the currently logged-in user:
favourite = currentUser()
Confirm your changes with "Save".
Adding Space Icons
Activating the Space logo toggle on a space item, displays the respective space logo or icon on the left of the space.
Configuration is applied to the live preview and the Menu.
Image 4: Activated space logo toggle (click to enlarge)
Delete Menu elements
To delete an element, move your mouse over the target element and click on the trash icon next to it (see Image 5).
To make sure that you don't do any action unintentionally, we have added a confirmation dialogue when you try to delete an item. You can hit the "Delete" button or press Enter to confirm the deletion, or you can hit Cancel and avoid unintentional deletion.
Image 5: Delete Confirmation Dialogue (click to enlarge)
Edit Menu elements
Menu elements can be edited as follows:
Click on the Menu element you want to edit.
Make your changes on the right (see image 4).
Confirm your changes with "Save".
Elements can be moved by simple drag-and-drop. They can be moved within the same hierarchy level as well as to a higher or lower level in the Menu hierarchy.
You can also sort the child elements of a Menu element alphabetically by clicking the sort symbol.
Image 6: Sort Child Elements Alphabetically (click to enlarge)
Confirm your changes with "Save".
Multiple Top-level Items
If you configure multiple top-level Menu items which don't fit on one screen, an arrow will appear on the far right side of the Menu and let you navigate through the rest of the items.
Image 7: Right arrow display (click to enlarge)
Once you click on the arrow, you will see the rest of the remaining items which were not visible on the first screen. Additionally, a left arrow will be shown to allow you to go back to the previous screen.
Image 8: Left arrow display (click to enlarge)
Cancel Your Changes
Once you have made any changes to the Menu structure, you might hit the Cancel button unintentionally. We have added a confirmation dialogue that appears if the Menu structure has changed. You can click "Save" and submit all changes made to the Navigation Menu in your Confluence instance, or click "Discard" and undo/lose all the changes since you last opened the configuration dialogue.
Image 9: Cancel confirmation dialog (click to enlarge)