It's better when it's simple

User Tools

Site Tools


Page Navigation Plugin

Compatible with DokuWiki

  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" unknown
  • 2018-04-22 "Greebo" yes

plugin Displays links to the next or previous alphabetically ordered page

Last updated on

Similar to docnavigation

Tagged with browse, menu, namespace, navigation

This plugin inserts a next/previous page navigation to let your users easily navigate through all pages in a namespace. The namespace's start page will be skipped on browsing. The page order is determined alphabetically.

Download and Installation

A CosmoCode Plugin

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


Syntax and Usage

The simplest usage is this:


It will include a navigation bar to browse through all pages in a namespace, displaying all buttons as shown above.

To control which buttons are shown, you can place a number inside the angle brackets:


The following numbers are recognized:

number shown buttons
2 previous, next
4 first, last
6 first, previous, next, last
8 start
10 previous, start, next
12 first, start, last

If you want to restrict browsing on pages matching a certain regular expression you can give the expression separated by a space inside the square brackets. E.g. to browse only pages starting with a you could use this:

[<> ^a.*]


The navigation is cached with the page. When new pages are added to the namespace, the navigation might be wrong until the cache expires. Read caching on how to update the cache manually.

You can now use this plugin inside a sidebar (for templates that have one). To make it work in a sidebar you have to disable caching for that sidebar completely using the ~~NOCACHE~~ macro in the sidebar page. You should also make sure the sidebar is set up to be hidden through the hidepages option.

Using this plugin together with namespace templates might be useful.

plugin/pagenav.txt · Last modified: 2023-10-30 23:43 by Klap-in

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki