This plugin creates a tree of links based on the wiki's namespace structure and is intended to be used in the sidebar of any template. It looks similar to the Page Index but with namespaces linking directly to their respective start pages. The tree is opened based on the currently opened page.

The plugin honors ACLs and hidepages settings.

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Use the following code to embed the navigation in your sidebar page:

{{simplenavi>}}

You can optionally give a namespace at which the navigation tree should start (e.g. useful for building different navigations for different language namespaces):

{{simplenavi>ns1:ns2}}

Example:

{{simplenavi>animals:insects}}

Additional options can be given separated by spaces.

{{simplenavi>animals:insects filter}}

The filter option will add a text input field which allows for filtering the top level of the tree.

{{simplenavi>animals:insects home}}

The home option will wrap all found content under the start page of the given name space. Useful when composing menus from different simplenavi calls.

Use the DokuWiki configuration manager to change the behavior of the plugin.

• usetitle - Display the page's titles instead of IDs. This behavior is independent of the useheading option.
• sort - Defines how to sort the items. Either by ID or title, optionally with namespaces first
• peek - Usually a namespace will not be shown if the current user has no permission to it's start page. If your setup has deeper nested namespaces that might be visible again, you can set how many levels deep the plugin should search for readable nested namespaces. Keep the number as low as possible for performance reasons.

A public git repository is available at https://github.com/cosmocode/simplenavi

• Version upped (2025-05-23 01:13)
• do not show hidden pages (2025-05-22 15:22)
• Version upped (2025-05-16 01:12)
• Merge pull request #40 from cosmocode/tree (2025-05-15 13:48)
• fix filter option (2025-04-03 11:16)
• fix: Handle empty parent case in isParent method (2025-04-03 10:56)
• refactor: Use data provider for isParent test method (2025-04-03 10:55)
• test: Add test cases for the `isParent` method in SimplenaviTest (2025-04-03 10:54)

Please report issues in the bug tracker at https://github.com/cosmocode/simplenavi/issues