Navigation Menu Wiki Macro (Deprecated)
Last modified by Thomas Mortagne on 2026/08/05 18:22
| This wiki macro allows you to create a horizontal or vertical navigation menu without modifying the current skin |
| Type | XAR |
| Category | |
| Developed by | Flavius Olaru, xwiki:XWiki.cmarcoin, Nicolas Lemoine, Raluca Stavro, Ecaterina Moraru (Valica), Florian Véron |
| Rating | |
| License | GNU Lesser General Public License 2.1 |
| Compatibility | 3.1 |
Table of contents
Description
This is a custom navigation menu wiki macro that allows you to add a navigation bar on header, left panels or right panels.
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

Vertical left menu

Vertical right menu

Branches
A modified version of this macro was used on www.xwiki.org, see . The code was optimized for the horizontal menu layout and favored JavaScript to a CSS only code.

Prerequisites & Installation Instructions
Install xar.