Navigation Menu Wiki Macro (Deprecated)

Last modified by Thomas Mortagne on 2026/08/05 18:22

cogThis wiki macro allows you to create a horizontal or vertical navigation menu without modifying the current skin
TypeXAR
Category
Developed by

Flavius Olaru, xwiki:XWiki.cmarcoin, Nicolas Lemoine, Raluca Stavro, Ecaterina Moraru (Valica), Florian Véron

Rating
0 Votes
LicenseGNU Lesser General Public License 2.1
Compatibility

3.1

Description

This is a custom navigation menu wiki macro that allows you to add a navigation bar on header, left panels or right panels.

Information

Starting with XWiki 5.1 the menu wiki macro is provided by the Menu Application.

Warning

This extension is experimental and not supported by the XWiki Development Team. It was written during the XWiki Seminar Hackathon 2011. It is compatible with the Colibri Skin but not the Flamingo Skin.

Vertical menu example

{{menu type="vertical" position="right" id="panelmenu"}}
* [[Main>>Main.WebHome]]
* [[Sandbox>>Sandbox.WebHome]]
** [[Sandbox.TestPage1]]
** [[Sandbox.TestPage2]]
** [[Sandbox.TestPage3]]
* [[Blog>>Blog.WebHome]]
{{/menu}}

Horizontal menu example

{{menu type="horizontal" id="horizontalmenu"}}
* [[Home>>Main.WebHome]]
* [[Sandbox>>Sandbox.WebHome]]
** [[Sandbox.TestPage1]]
** [[Sandbox.TestPage2]]
* [[Blog>>Blog.WebHome]]
** [[Blog Archive>>Blog.Archive]]
** [[Blog Categories>>Blog.Categories]]
{{/menu}}

It can be inserted in a xwiki document or in a panel. In a xwiki document it will show only when viewing that document, while if you define the panel in a wiki it will show in all wiki.

{{menu type="" id="" position=""}}
xwiki syntax 2.0
{{/menu}}

Parameters:

  • type: horizontal or vertical
  • id: the id of the navigation menu, used to add more than on navigation menu
  • position: left or right, used for to specify if for left panels or right panels.

Screenshots

Horizontal menu

menu-top-left.png

Vertical left menu

menu-left.png

Vertical right menu

menu-right.png

Branches

A modified version of this macro was used on www.xwiki.org, see XWikiOrgCode.MenuMacro-branch-xwikiorg.1.xar. The code was optimized for the horizontal menu layout and favored JavaScript to a CSS only code.

xwikiorgmenu.png

Prerequisites & Installation Instructions

Install xar.

Get Connected