AcMenu provides an accordion menu which lists the content of namespaces in a tree-like format. The tree is built starting from the namespace where the AcMenu's syntax lives till the very end namespace.

This plugin respects the ACL rules and the sneaky_index, hidepages options that come with your DokuWiki configuration.

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

In the sidebar page, use the syntax:

<acmenu>

Just some screenshots to give you an overall idea of the final result.

Suppose you want to split your main wiki in two sub-wiki independent between them, as follows:

+--sidebar.txt
+--start.txt
+--branch-a
|  +--sidebar.txt
|  +--start.txt
|  +--products
|  |  +--start.txt
|  +--services
|  |  +--start.txt
|  +--private
|     +--start.txt
|     +--confidential.txt
+--branch-b
   +--sidebar.txt
   +--start.txt
   +--products
   |  +--start.txt
   +--services
   |  +--start.txt
   +--private
      +--start.txt
      +--confidential.txt

Than you can populate each sidebar.txt in the following manner:

• in :sidebar.txt

  <acmenu>

• in :branch-a:sidebar.txt

  [[..:start| Back to Main]]
  <acmenu>

• in :branch-b:sidebar.txt

  [[..:start| Back to Main]]
  <acmenu>

When a visitor is in :start.txt, the plugin shows the complete namespace tree collapsed except the namespace in which the sidebar.txt with AcMenu's syntax it is. Only if the visitor's browser has JavaScript disabled all namespaces reveal their content so that it's possible to continue the navigation.

If the visitor decides to open a :branch-* or any its sub-namespaces :branch-*:*, the AcMenu shows only the sidebar relative to the current branch.

If the visitor is a guest and he doesn't have the permission to enter in any :branch-*:private area, you should set the appropriate rule in the ACL management. Furthermore you can hide to him the :branch-*:private namespace setting up the sneaky_index option in your Configuration Manager.

If the visitor is a user registered and has the permission to enter in any :branch-*:private area but not to see the :branch-*:confidential.txt page, you should set the appropriate rule in the ACL management.

Furthermore it's possible to hide all sidebar.txt page using the hidepages option in your Configuration Manager:

^:(?:.*sidebar)

Since this plugin uses cookies to remember the page visited (they are automatically deleted as soon as the window browser is closed) if the visitor come back to :start.txt the branch and its sub-namespaces opened will stay open.

The order in which the directory tree is presented is the following:

• first, folders from 0-9A-Za-z
• then, files from 0-9A-Za-z

This means that, if the option useheading is enabled, it's possible to force the order of files using a progressive numeration in the first heading of each file.

The navigation through namespaces and the links to the relative pages work as follows:

• on namespace:
  • one click: shows/hides the relative content;
  • double click: opens the relative start page;
• on page:
  • one click: opens the relative page.

First, set the appropriate permissions in your ACL management. Then, use the options:

• sneaky_index: to hide namespaces.
• hidepages: to hide pages;

Symptom: AcMenu doesn't show/hide namespace's content.

Possible solution: be sure that JavaScript is enabled in your browser, otherwise all namespaces remain open showing their content.

Please, use the relative bug tracker or write here and then I will move there.
— Torpedo 2017-03-09 16:32

Let me know what do you think about this plugin and how can I improve its functionality.
— Torpedo 2017-03-09 16:33

I'd love to have the menu always stay open – any ideas? marwahaha 2017-06-21