Enterprise Theme for Confluence
Space shortcuts
Enterprise Theme for Confluence BVTHEME

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
AddingMenus
AddingMenus

Adding, editing and deleting menus

  1. Choose the cog icon , at top right of the screen, then choose General configuration.
  2. Select Menus under Enterprise Theme in the left-hand panel. This will list the two default menus for the header and the footer as well as other menus that have been configured.

...

  • Add a new menu by clicking the Add Menu button
  • Configure an existing menu
  • Edit the name of a menu
  • Delete a menu (the two global menus can not be deleted)

Configure a menu

  1. Click the Configure link under Operations. This will open the menu structure of that menu.

...

  • Configure a menu structure for each language that is installed in Confluence. Users will see only the menu for the language they have set in their profile. However, users that have set a language for which there is no menu defined will see the default menu instead. The default language, which is marked with
    Status
    colourBlue
    titleDEFAULT
    , is defined by the language that is set as the default language in Confluence. It is advisable to at least configure the menus for the default language as it is the "fall-back" menu.
  • Adding menu items:
    • Click the plus icon on a language section to add a menu item to that specific language menu.
    • Click the plus icon on a menu item to add a sub menu item. Menus can be up to tree levels deep.
    • Click the pencil icon  to edit an existing menu item.
    • Click the trash icon to delete an existing menu item. Be aware that this will delete all child items as well.
  • Reorder the menu by simply dragging the item by the menu icon on the left side. You can even drag menu items from one language section to another one.

Adding or editing a menu item

Clicking on the plus icon to add a new menu item or clicking the pencil icon to edit an existing one will bring up the following dialogue:

...

Anchor
EmbeddingMenus
EmbeddingMenus

Embedding menus in the header and footer

The next step is to make sure the header and footer menus are displayed in the Enterprise Theme layout. To do this you have to configure the Enterprise Theme sections for the header and the footer. By default the header and footer sections already contain the macro Metamenu with the correct parameters set to display the Global Header and Global Footer in the header and footer sections.

...

  1. Choose the cog icon , at top right of the screen, then choose General configuration.
  2. Select Sections under Enterprise Theme in the left-hand panel.
  3. Click on the section for the header or the footer. This will open the editor for that section.
  4. Make sure the Metamenu macro is present in the section by:
    • Click the Use Default button to reset the section. The default header section contains the Metamenu macro.
    • Add the Metamenu macro through the macro browser.
  5. Configure the parameter of the Metamenu macro:
    • Menu: Select the menu to be used.
    • Hide from anonymous user: If this checkbox is checked, anonymous users do not see the menu.
    • Style:
      • flat and menu3: With these two menu styles second level menu items are rendered in drop-downs and third level items are grouped together (see menu item types above as well). These two menus are preferred for header menus.

      • bv-footer: This style renders the every first level item of the menu into a column with the second level items being listed vertically below them. Items of the third level are not being rendered with this style. It is the preferred style for footer menus.

Having a different header and footer in a space

It is possible to have different header and footer menus in different spaces instead of the one defined globally. For this to make sense, at least one additional menu should be configured besides the Global Header and Global Footer. Please refer to the paragraph Adding, editing and deleting menus above.

To define menus in a space:

  1. Go to the space in which you would like to embed the menus.
  2. Navigate to the space administration. Please refer to the page Navigating to the Space Administration if you unsure how to find it.
  3. Select Sections under Enterprise Theme.
  4. Configure the Metamenu macro in the header and footer sections in the same way as you would do for the global sections. Please refer to the paragraph Embedding menus in the header and footer above.

 

For more information about editing sections go to the Sections documentation.

Why is my menu or my footer not being displayed?

This could have a couple of reasons:

  • There is no menu defined for the language of your user profile and the default Confluence language.
    It is recommended to at least define a menu for the default language of Confluence. This way it is ensured that a users who have a language set in their profile for which there is no menu defined see the menu for the default language.
  • The menu is not embedded in the sections of the Enterprise Theme. Please refer to Embedding menus in the header and footer paragraphs above.

Why are certain menu entries not being displayed?

If a menu entry is displayed or not depends on permissions and user profile settings. If certain menu entries are missing, please check (or let a Confluence administrator check):

  • If the menu structure differs in different languages. If for instance you change the language in your user profile you would get a different language structure then.
  • If there are special restrictions on the menu item itself (can be configured on each menu item in the menu configuration, see restrictions on menu items above).
  • In case a space is linked in the menu: If you have permissions for this space and the start page of this space (see page restrictions).
  • In case a page is linked in the menu: Page restrictions which do not allow that you can see this page.

How can I remove the Header (or Footer) menu if I don't want it?

By default the header and footer sections already contain the macro Metamenu to display a menu in the header and footer sections. But this macro can simply be removed:

...

Enterprise Theme for Confluence BVTHEME