WvdS.DokuWiki.AcMenu Plugin

Plugin: wvdsacmenu
Version: 1.0.0
Namespace: lib/plugins/wvdsacmenu/
Base: AcMenu by Torpedo
Extensions: Wolfgang van der Stille zeljko.petrusic@outlook.de
License: GPL 2

The wvdsacmenu plugin displays an accordion menu for namespaces and pages. It extends the original AcMenu with wiki syntax, dynamic namespace detection, and multilingual support.

• Namespace Navigation - Automatic menu for documentation structure
• Multilingual Wikis - Separate menus per language namespace
• Project Documentation - Hierarchical navigation in sub-namespaces
• Sidebar Integration - Compact navigation in the sidebar

{{wvds:acmenu}}
{{wvds:acmenu ns="namespace"}}
{{wvds:acmenu dynamic="N"}}

Shows a specific namespace regardless of current page:

{{wvds:acmenu ns="en:crypto"}}
{{wvds:acmenu ns="en:docs:api"}}

Calculates namespace relative to current page:

The plugin detects namespace boundaries through sidebar* files:

• sidebar.txt
• sidebar1.txt
• sidebar2.txt
• sidebar_name.txt

If a namespace contains one of these files, it is treated as a standalone area.

1. Without parameters
   └── Searches upward for sidebar* file
   └── Starts menu from that namespace

2. With ns="..."
   └── Uses the specified namespace directly

3. With dynamic="N"
   └── Calculates: current_namespace - N levels
   └── Shows from that point

Requirement: Menu should automatically show current namespace area.

sidebar1.txt:

~~NOCACHE~~
{{wvds:snippet>go_back}}
{{wvds:acmenu}}

Result:

• Plugin searches upward for sidebar* file
• Starts menu from found namespace
• Shows all sub-namespaces and pages

Requirement: Menu for English documentation area.

en/sidebar1.txt:

~~NOCACHE~~
{{wvds:snippet>go_back}}
{{wvds:acmenu dynamic="2"}}

Result at en:crypto:openssl:start:

• dynamic=„2“ goes 2 levels up
• Starts at en:crypto
• Shows all crypto documentation

Requirement: Always show the same namespace.

{{wvds:acmenu ns="en:api"}}

Result:

• Always shows en:api regardless of current page
• Useful for fixed navigation blocks

Structure:

/
├── sidebar.txt          (Main menu)
├── de/
│   ├── sidebar1.txt     ({{wvds:acmenu dynamic="2"}})
│   ├── crypto/
│   │   ├── sidebar1.txt ({{wvds:acmenu dynamic="1"}})
│   │   └── openssl/
│   └── docs/
├── en/
│   ├── sidebar1.txt
│   └── ...
└── sl/
    ├── sidebar1.txt
    └── ...

~~NOCACHE~~
{{wvds:snippet>main_menu}}

~~NOCACHE~~
{{wvds:snippet>go_back}}
{{wvds:acmenu dynamic="2"}}

~~NOCACHE~~
{{wvds:snippet>go_back}}
{{wvds:acmenu dynamic="1"}}

1. Parameter Evaluation
   ├── ns="" → Use explicit namespace
   ├── dynamic="N" → Calculate namespace
   └── (empty) → Search sidebar* upward

2. Namespace Resolution
   └── Determine start namespace for menu
   └── Check access permissions

3. Tree Building
   └── Read all pages and sub-namespaces
   └── Filter by access permissions
   └── Sort alphabetically

4. HTML Generation
   └── Create nested <ul>/<li> structure
   └── Mark current page (.curid)
   └── Mark open paths (.open)

5. JavaScript Integration
   └── Accordion behavior
   └── Cookie storage for open folders

Via Admin → Configuration → wvdsacmenu:

Open folders are stored in the browser:

• Redirect - HTML chunks for menus
• WvdS.DokuWiki.Lang Plugin - Multilingual menu text
• WvdS.DokuWiki.Flat Template - Template with sidebar support

File: lib/plugins/wvdsacmenu/syntax.php

File: lib/plugins/wvdsacmenu/script.js

• Accordion click handler
• Cookie management
• Smooth scroll to current element