Learn about DokuWiki
Advanced Use
Corporate Use
Our Community
Follow us on Facebook, Twitter and other social networks.
Learn about DokuWiki
Advanced Use
Corporate Use
Our Community
Follow us on Facebook, Twitter and other social networks.
Compatible with DokuWiki
Tagged with menu, navigation
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, moreover, the sneaky_index and hidepages options that come with your DokuWiki configuration.
Search and install the plugin using the Extension Manager. Refer to Plugin Installation Instructions 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 create a sub-wiki in your main one, independent from it, as follows:
+--sidebar.txt +--start.txt +--products | +--start.txt +--services | +--start.txt +--branch +--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:
:sidebar.txt
<acmenu>
:branch:sidebar.txt
[[..:start| Go Back]] <acmenu>
where the Go Back
link is made according to the namespaces criterion.
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 will reveal their content so that it will be possible to continue the navigation.
If the visitor decides to open the sub-wiki :branch
, the AcMenu plugin shows only its sidebar.
To deny the access to certain namespaces or pages you should set the appropriate rule in the ACL management. In addition, it's possible to conceal those namespaces for which the visitor has no permission setting up the sneaky_index option in your Configuration Manager.
Furthermore it's possible to hide all sidebar.txt
pages using the hidepages option in your Configuration Manager:
(sidebar|other-pages)
The following image is the behaviour of the AcMenu plugin from the perspective of a user registered.
Since this plugin uses cookies to remember the pages visited (they are automatically deleted as soon as the window browser is closed) if the visitor comes back to :start.txt
every namespaces untoggled will remain so.
The order in which the directory tree is presented is the following:
0-9A-Za-z
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.
First, set the appropriate permissions in your ACL management. Then, use the options:
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.
Symptom: AcMenu doesn't keep untoggled any namepsace after have opened any link.
Possible solution: be sure that cookies are enabled in your browser, otherwise AcMenu forgets the namespaces untoggled whenever a page is loaded.
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-21The purpose of this plugin is to provide a menu whose items are shown or hidden at user discretion rather than offer a static menu.
For a menu that always stays open it's better to use plugins that create a list of pages belong to a given namespace.
Also notice that since this plugin i) create the menu in the sidebar, which doesn't offer much space in width-wise, and ii) it uses indentation to render nested namespaces, long menus or long names would be printed in a very ugly way. — Torpedo 2017-06-27 09:37