Plugin: wvdsacmenu
Version: 1.4.0
Namespace: lib/plugins/wvdsacmenu/
Basis: AcMenu von Torpedo
Erweiterungen: Wolfgang van der Stille zeljko.petrusic@outlook.de
Lizenz: GPL 2

Das wvdsacmenu Plugin zeigt ein Akkordeon-Menü für Namespaces und Seiten. Es erweitert das Original-AcMenu um Wiki-Syntax, dynamische Namespace-Erkennung, Lazy Loading, ACL-aware Navigation und mehrsprachige Unterstützung.

DokuWiki-Standardnavigation und das Original-AcMenu haben in Enterprise-Umgebungen mehrere Einschränkungen:

• ACL-Blindheit: Wenn sneaky_index=1 aktiv ist, werden geschützte Ordner komplett ausgeblendet - auch wenn tiefer öffentliche Inhalte existieren
• Keine Lazy Loading: Bei großen Dokumentationsstrukturen (100+ Seiten) wird die Sidebar langsam und unübersichtlich
• Sprach-Isolation: Mehrsprachige Wikis benötigen manuelle Konfiguration pro Namespace
• Keine Template-Integration: Die Sidebar-Auswahl ist statisch und kennt keine Namespace-Hierarchie

ACL-Konfiguration:
  de:int:*                @ALL  0   (gesperrt)
  de:int:vsce:fpc:p:*     @ALL  1   (öffentlich)

Standard-AcMenu Ergebnis:
  📂 de
     📁 pub          ← sichtbar
     (vsce fehlt!)   ← PROBLEM: gesamter Pfad ist versteckt

wvdsacmenu Ergebnis:
  📂 de
     📁 pub
     📂 int
        📂 vsce      ← partial (kein Link)
           📂 fpc    ← partial (kein Link)
              📁 p   ← sichtbar und navigierbar

Der Benutzer sieht den Pfad zu öffentlichen Inhalten, auch wenn dazwischenliegende Ordner nicht direkt lesbar sind.

wvdsacmenu wurde für komplexe Dokumentationsstrukturen mit differenzierten Zugriffsrechten entwickelt:

1. Minimal Disclosure: Zeige nur was der Benutzer sehen darf, aber zeige den Pfad dorthin
2. Progressive Loading: Lade initial wenig, erweitere bei Bedarf
3. Stateless Recovery: Cookie-Zustand wird Server-seitig wiederhergestellt (kein Flackern)
4. Deep Integration: Das Plugin arbeitet eng mit Template und ACL-System zusammen

• Namespace-Navigation - Automatisches Menü für Dokumentationsstruktur
• Mehrsprachige Wikis - Separate Menüs pro Sprach-Namespace
• Projektdokumentation - Hierarchische Navigation in Unter-Namespaces
• Sidebar-Integration - Kompakte Navigation in der Seitenleiste
• Performance-Optimierung - Lazy Loading für große Menüstrukturen
• ACL-aware Navigation - Zeigt Ordner auch wenn nur Teile lesbar sind

{{wvds:acmenu>}}
{{wvds:acmenu>ns=namespace}}
{{wvds:acmenu>dynamic=N}}
{{wvds:acmenu>startns=current|icons=fa}}

{{wvds:title>Mein Seitentitel}}

Definiert einen Titel für die Seite, der im Menü angezeigt wird, ohne sichtbar auf der Seite zu erscheinen. Nützlich für Seiten mit Hero-Sections oder speziellen Layouts.

ns-Parameter Werte:

Zeigt einen bestimmten Namespace unabhängig von der aktuellen Seite:

{{wvds:acmenu>ns=de:crypto}}
{{wvds:acmenu>ns=de:docs:api}}

Steuert wie viele Ebenen initial geladen werden. Tiefere Ebenen werden per AJAX nachgeladen:

Wichtig: Der Namespace wird immer relativ zur Sidebar-Position berechnet, nicht zur aktuellen Seite.

Ähnlich wie Total Commander: Zeigt nur den aktuellen Namespace mit einem „Nach oben“-Link:

{{wvds:acmenu>startns=current}}
{{wvds:acmenu>startns=current|dynamic=2}}

Vorteile:

• Übersichtlicher bei großen Strukturen
• Fokus auf den aktuellen Bereich
• „Nach oben“-Link zur Navigation

Aktiviert visuelle Icons für Ordner und Dateien:

{{wvds:acmenu>icons=fa}}
{{wvds:acmenu>startns=current|icons=fa}}

Voraussetzung: FontAwesome muss im Template geladen sein (im flat Template bereits enthalten).

Der auto-Modus kombiniert fokussierte Navigation mit ACL-aware Geschwister-Erkennung:

{{wvds:acmenu>ns=auto|icons=fa|dynamic=1}}

Funktionsweise:

1. Fokussierte Ansicht: Startet beim aktuellen Namespace (wie startns=„current“)
2. ACL-aware „Go Up“: Link zum Home-Namespace des Benutzers basierend auf ACL-Regeln
3. Geschwister mit Partial Content: Zeigt andere Namespaces auf Sprach-Ebene, die lesbaren Inhalt haben
4. Kombinierbar mit dynamic für Lazy Loading

Unterschied zu startns=„current“:

Anwendungsfall: Eine einzige sidebar1.txt für alle Namespaces einer Sprache:

# de/sidebar1.txt (funktioniert für de:pub:*, de:int:*, etc.)
~~NOCACHE~~
{{wvds:acmenu>ns=auto|icons=fa|dynamic=1}}

Beispiel 1: Anonymer Benutzer auf de:pub:start

ACL: de:int:vsce:fpc:p:* ist öffentlich, Rest von de:int:* ist gesperrt

↑ ..                    ← Go Up (entfällt wenn schon am Home)
📂 pub                  ← aktueller Namespace (fokussiert)
   📄 start
   📁 services
📂 int                  ← Geschwister mit Partial Content
   📂 vsce              ← partial (klickbar zum Expandieren)
      📂 fpc            ← partial
         📁 p           ← lesbar

Beispiel 2: Anonymer Benutzer auf de:int:vsce:fpc:p:start

↑ ..                    ← Go Up zu de:pub:start (Home für @ALL)
📁 p                    ← aktueller Namespace (fokussiert)
   📄 start
   📄 download

Beispiel 3: @user auf de:int:dwe:start

↑ ..                    ← Go Up zu de:int:start (Home für @user)
📁 dwe                  ← aktueller Namespace (fokussiert)
   📄 start
   📁 wvdsacmenu
   📁 wvdssnippet
📁 vsce                 ← Geschwister (vollständig lesbar)
📁 pqcrypt              ← Geschwister (vollständig lesbar)

Warum Smart Auto?

1. Beim Laden der Seite werden nur die ersten N Ebenen (dynamic) gerendert
2. Ordner am Tiefenlimit erhalten die CSS-Klasse lazy
3. Beim Klick auf einen lazy-Ordner wird der Inhalt per AJAX geladen
4. Der Ladezustand wird durch die Klasse loading angezeigt

Geöffnete Ordner werden im Cookie gespeichert. Beim nächsten Seitenaufruf werden diese Ordner server-seitig vorgeladen, auch wenn sie tiefer als dynamic liegen. Dies verhindert ein „Flackern“ beim Laden.

GET /lib/exe/ajax.php?call=plugin_wvdsacmenu_load&ns=de:crypto:subfolder

Response:

{
  "success": true,
  "html": "<li>...</li>",
  "ns": "de:crypto:subfolder"
}

Das Plugin erkennt Namespace-Grenzen durch sidebar* Dateien:

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

1. Ohne Parameter
   └── Sucht aufwärts nach sidebar* Datei
   └── Startet Menü ab diesem Namespace

2. Mit ns="..."
   └── Verwendet den angegebenen Namespace direkt

3. Mit dynamic="N"
   └── Findet Sidebar-Namespace
   └── Lädt N Ebenen vor, Rest per AJAX

Das Plugin berücksichtigt DokuWiki-ACL-Regeln und zeigt Ordner intelligent an, auch wenn nicht alle Inhalte für den Benutzer lesbar sind.

Wenn sneaky_index aktiviert ist und ein Ordner nicht direkt lesbar ist (z.B. de:int:vsce:start für anonyme Benutzer), aber lesbare Inhalte tiefer im Baum existieren (z.B. de:int:vsce:fpc:p:*), wird der Ordner trotzdem angezeigt:

📂 vsce          ← partial (kein Link, nur Label)
   📂 fpc        ← partial (kein Link, nur Label)
      📁 p       ← normal (Link zu p:start)
         📄 start
         📄 download

Verhalten:

• Ordner mit partial Klasse zeigen nur ein Label (kein Link zur Start-Seite)
• Klickbar: Ein Klick auf den Ordner expandiert/kollabiert die Kinder
• Der Ordner ist initial geöffnet, um lesbare Kinder zu zeigen
• Styling kann per CSS angepasst werden

Bei startns=„current“ springt der „Nach oben“-Link nicht einfach zum Parent-Namespace, sondern zum Home-Namespace des Benutzers basierend auf ACL-Regeln:

Priorität:

1. Namespace-Wildcards (z.B. de:pub:*) haben Vorrang
2. Einzelne Seiten-ACLs (z.B. de:int:start) sind nachrangig
3. Der kürzeste (höchste) Namespace wird bevorzugt

Beispiel: Ein anonymer Benutzer auf de:int:vsce:fpc:p:start sieht den „Go Up“-Link zu de:pub:start, nicht zu de:int:start.

Das flat Template lädt Sidebar-Seiten namespace-spezifisch.

Das Template sucht die Sidebar-Datei (z.B. sidebar1.txt) ausgehend vom aktuellen Namespace aufwärts:

Seite: de:int:vsce:fpc:p:start

Suche nach sidebar1.txt:
1. de:int:vsce:fpc:p:sidebar1 → nicht gefunden
2. de:int:vsce:fpc:sidebar1   → nicht gefunden
3. de:int:vsce:sidebar1       → nicht gefunden
4. de:int:sidebar1            → GEFUNDEN ✓

Ergebnis: Für de:int:* Seiten wird de:int:sidebar1.txt geladen, für de:pub:* Seiten wird de:sidebar1.txt geladen.

Beispiel ACL-Einträge:

de:int:sidebar         @ALL    1
de:int:sidebar1        @ALL    1
de:int:sidebar2        @ALL    1

Für Seiten ohne sichtbaren Titel (z.B. Landing Pages mit Hero-Section) kann ein Menü-Titel definiert werden:

~~NOTOC~~
{{wvds:title>NIS2 Compliance Check}}

{{wvds:snippet>nis2check_hero}}
{{wvds:snippet>nis2check_content}}

Der Titel wird:

• Im Menü angezeigt
• In den Metadaten gespeichert
• Nicht auf der Seite gerendert

Das Menü verwendet Titel in folgender Reihenfolge:

1. {{wvds:title>...}} (Unsichtbarer Titel)
2. Erste Überschrift der Seite (wenn useheading aktiviert)
3. Seiten-ID als Fallback

sidebar1.txt:

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

Eine einzige Sidebar-Datei für alle Namespaces einer Sprache:

de/sidebar1.txt:

~~NOCACHE~~
{{wvds:acmenu>ns=auto|icons=fa|dynamic=1}}

Diese Konfiguration:

• Fokussiert: Zeigt primär den aktuellen Namespace
• Smart „Go Up“: Link zum ACL-basierten Home-Namespace
• Geschwister-Erkennung: Zeigt andere Namespaces mit lesbarem Content
• Partial Namespaces: Pfade zu öffentlichen Bereichen in geschützten Zonen
• Nutzt FontAwesome Icons
• Lädt nur 1 Ebene initial, Rest per AJAX

de/sidebar1.txt:

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

{{wvds:acmenu>ns=de:api}}

Für große Strukturen - zeigt nur den aktuellen Bereich mit „Nach oben“-Link:

{{wvds:acmenu>startns=current|icons=fa}}

Ergebnis (bei Seite de:crypto:openssl:start):

↑ ..
📂 openssl
   📄 start
   📁 commands
   📄 examples

{{wvds:acmenu>startns=current|dynamic=1|icons=fa}}

/* Partial Namespaces - klickbar zum Expandieren */
div.acmenu li.partial > div.li {
    cursor: pointer;
}
 
div.acmenu li.partial > div.li .ns-label {
    color: #666;
    font-style: italic;
}
 
/* Icon-Farbe für partial Ordner */
div.acmenu.acmenu-icons li.partial > div.li .fa {
    color: #999;
}

/* Lade-Indikator */
div.acmenu li.loading > div.li:after {
    content: " ⟳";
    animation: spin 1s linear infinite;
}
 
@keyframes spin {
    from { transform: rotate(0deg); }
    to { transform: rotate(360deg); }
}
 
/* Lazy-Ordner visuell markieren */
div.acmenu li.lazy > div.li {
    cursor: pointer;
}

Geöffnete Ordner werden im Cookie plugin_wvdsacmenu_open_items gespeichert.

// Cookie-Name
plugin_wvdsacmenu_open_items
 
// Wert (JSON-Array)
["de:crypto:start","de:docs:api:start"]

Beim Rendern liest das Plugin den Cookie und lädt alle dort gespeicherten Ordner vor - auch wenn sie tiefer als dynamic liegen. Dies stellt den Menüzustand ohne JavaScript-Flackern wieder her.

• WvdS.DokuWiki.Snippet Plugin - HTML-Bausteine
• WvdS.DokuWiki.i18n Plugin - Mehrsprachige Texte
• WvdS.DokuWiki.Flat Template - Template mit Sidebar

Datei: lib/plugins/wvdsacmenu/syntax.php

Datei: lib/tpl/flat/lang_helper.php

Sucht eine Sidebar-Datei ausgehend vom aktuellen Namespace aufwärts.

Datei: lib/plugins/wvdsacmenu/action.php

Datei: lib/plugins/wvdsacmenu/script.js