Manual for Menu Editor 1.1.4 and below.
This installation manual guides you through the process of installing the Menu Editor add-on in Atlassian Confluence 5.x.
Step 1: Add Menu Editor To Your Theme
This part of the manual only works for the Confluence Default Theme. For other themes, like the Documentation Theme as well as custom themes, the Menu Editor must be added in the files of the respective theme. If you need help customizing your theme accordingly, we're here to help. Just contact us via email at team-atlassian@seibert-media.net.
- In the Admin menu, choose "Layouts" in the "Look and Feel" section
- Click "Create Custom" in the "Site Layouts" > "Main Layout" section
Look for the following line:
#parse("/decorators/includes/common-header.vm")
And paste the following line of code below it:
$helper.renderConfluenceMacro("{display-menu:containerId=main-nav}")
Your Main Layout code should look like this. The area of interest is marked red:
- Finally, click "Save".
- Finally, click "Save".
Step 2: Configure Languages
Now we need to create our menus. In the Admin area click on the "Menu Editor" menu item in the "Look and Feel" section. You will only see one entry field. You need to enter a language-location-keys and click on "Create".
You will now see an empty menu structure; you can now begin adding category, menu and separator items; move them around and delete them.
To move the items you can use Drag&Drop or use the buttons in the "Position" column.
A menu will only be shown if the Confluence language pack for the respective language-location-key is installed.
Step 3: Choose Fallback Language
Finally, you need to choose a fallback language, even if you have only created one menu for one language-location-keys. Simply choose the desired fallback language from the dropdown menu and click "Set as default".
To choose a fallback key you need to create a menu for that key first.
Step 4: Create More Menus In Different Languages (Optional)
Repeat step 2 as often as you like to create the menus you want. Make sure you install the corresponding Confluence language packs, otherwise your menus will not be displayed to your users.