This is an old revision of the document!
Table of Contents
simplenavi Plugin
Compatible with DokuWiki
2009-12-25+, 2013-12-08 "Binky", 2014-05-05 "Ponder Stibbons", 2014-09-29 "Hrun", 2015-08-10 "Detritus", 2016-06-26 "Elenor Of Tsort", Frusterick Manners, Greebo
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to indexmenu, navi, simpleindex
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 that has one (tested on Arctic Template). It looks similar to the Page Index but namespaces link directly to their respective start pages, and start pages it self are hidden from the index.
The plugin honors ACL, hidepages1) and useheading settings.
Download and Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Syntax and Usage
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}}
Configuration
Use DokuWiki configuration manager to change the sort order of the entries in the list:
If useheading is set in global configuration, the list shows the title of the startpages of the namespaces found, instead of the namespace-names itself.
Using the plugins sort-order configuration item, one can choose if they are not ordered (=“naturally”) or ordered by namespaces names (=“ascii”).
Development
A public git repository is available at https://github.com/cosmocode/simplenavi
Changelog
- Version upped (2023-11-13 23:51)
- code cleanup (2023-11-13 13:02)
- increase minimum php version to 7.3 (2023-11-13 12:57)
- avoid arrow function for php 7.2 compatibility (2023-11-13 12:52)
- added default workflows (2023-11-13 12:48)
- added home parameter (2023-11-13 12:44)
- Version upped (2023-08-28 23:51)
- abort early if no items found (2023-08-28 13:50)
Bugs and feature request
Please report issues in the bug tracker at https://github.com/cosmocode/simplenavi/issues