WvdS.DokuWiki.AcMenu Plugin

Plugin: wvdsacmenu
Versione: 1.3.0
Namespace: lib/plugins/wvdsacmenu/
Base: AcMenu di Torpedo
Estensioni: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenza: GPL 2

Il plugin wvdsacmenu mostra un menu ad accordion per namespace e pagine. Estende l'AcMenu originale con sintassi wiki, rilevamento namespace dinamico, lazy loading, navigazione ACL-aware e supporto multilingue.

La navigazione standard DokuWiki e l'AcMenu originale hanno diverse limitazioni in ambienti enterprise:

• Cecità ACL: Quando sneaky_index=1 è attivo, le cartelle protette sono completamente nascoste - anche se contenuti pubblici esistono più in profondità
• Nessun lazy loading: Con grandi strutture documentali (100+ pagine) la sidebar diventa lenta e confusa
• Isolamento linguistico: I wiki multilingue richiedono configurazione manuale per namespace
• Nessuna integrazione template: La selezione sidebar è statica e non conosce la gerarchia namespace

Configurazione ACL:
  de:int:*                @ALL  0   (bloccato)
  de:int:vsce:fpc:p:*     @ALL  1   (pubblico)

Risultato AcMenu standard:
  📂 de
     📁 pub          ← visibile
     (vsce manca!)   ← PROBLEMA: intero percorso nascosto

Risultato wvdsacmenu:
  📂 de
     📁 pub
     📂 int
        📂 vsce      ← partial (nessun link)
           📂 fpc    ← partial (nessun link)
              📁 p   ← visibile e navigabile

L'utente vede il percorso verso contenuti pubblici, anche se le cartelle intermedie non sono direttamente leggibili.

wvdsacmenu è stato sviluppato per strutture documentali complesse con permessi di accesso differenziati:

1. Minima divulgazione: Mostra solo ciò che l'utente può vedere, ma mostra il percorso per arrivarci
2. Caricamento progressivo: Carica poco inizialmente, espandi su richiesta
3. Ripristino stateless: Lo stato cookie viene ripristinato lato server (nessun flicker)
4. Integrazione profonda: Il plugin lavora strettamente con template e sistema ACL

• Navigazione namespace - Menu automatico per struttura documentazione
• Wiki multilingue - Menu separati per namespace linguistico
• Documentazione progetti - Navigazione gerarchica in sotto-namespace
• Integrazione sidebar - Navigazione compatta nella barra laterale
• Ottimizzazione performance - Lazy loading per grandi strutture menu
• Navigazione ACL-aware - Mostra cartelle anche quando solo parti sono leggibili

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

{{wvds:title>Titolo della mia pagina}}

Definisce un titolo per la pagina mostrato nel menu, senza apparire visibile sulla pagina. Utile per pagine con hero section o layout speciali.

Valori parametro ns:

Mostra un namespace specifico indipendentemente dalla pagina corrente:

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

Controlla quanti livelli vengono caricati inizialmente. Livelli più profondi vengono caricati via AJAX:

Importante: Il namespace viene sempre calcolato relativamente alla posizione sidebar, non alla pagina corrente.

Simile a Total Commander: Mostra solo il namespace corrente con link „Vai su“:

{{wvds:acmenu startns="current"}}
{{wvds:acmenu startns="current" dynamic="2"}}

Vantaggi:

• Più chiaro con grandi strutture
• Focus sull'area corrente
• Link „Vai su“ per navigazione

Attiva icone visive per cartelle e file:

{{wvds:acmenu icons="fa"}}
{{wvds:acmenu startns="current" icons="fa"}}

Prerequisito: FontAwesome deve essere caricato nel template (già incluso nel template flat).

La modalità auto combina navigazione focalizzata con rilevamento fratelli ACL-aware:

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

Funzionamento:

1. Vista focalizzata: Inizia dal namespace corrente (come startns=„current“)
2. „Vai su“ ACL-aware: Link al namespace home dell'utente basato su regole ACL
3. Fratelli con contenuto parziale: Mostra altri namespace a livello lingua che hanno contenuto leggibile
4. Combinabile con dynamic per lazy loading

Differenza da startns=„current“:

Caso d'uso: Una sola sidebar1.txt per tutti i namespace di una lingua:

# it/sidebar1.txt (funziona per it:pub:*, it:int:*, ecc.)
~~NOCACHE~~
{{wvds:acmenu ns="auto" icons="fa" dynamic="1"}}

Esempio 1: Utente anonimo su it:pub:start

ACL: it:int:vsce:fpc:p:* è pubblico, resto di it:int:* è bloccato

↑ ..                    ← Vai su (omesso se già a home)
📂 pub                  ← namespace corrente (focalizzato)
   📄 start
   📁 services
📂 int                  ← fratello con contenuto parziale
   📂 vsce              ← partial (cliccabile per espandere)
      📂 fpc            ← partial
         📁 p           ← leggibile

Esempio 2: Utente anonimo su it:int:vsce:fpc:p:start

↑ ..                    ← Vai su a it:pub:start (home per @ALL)
📁 p                    ← namespace corrente (focalizzato)
   📄 start
   📄 download

Esempio 3: @user su it:int:dwe:start

↑ ..                    ← Vai su a it:int:start (home per @user)
📁 dwe                  ← namespace corrente (focalizzato)
   📄 start
   📁 wvdsacmenu
   📁 wvdssnippet
📁 vsce                 ← fratello (completamente leggibile)
📁 pqcrypt              ← fratello (completamente leggibile)

Perché Smart Auto?

1. Al caricamento pagina vengono renderizzati solo i primi N livelli (dynamic)
2. Cartelle al limite di profondità ricevono classe CSS lazy
3. Al click su cartella lazy il contenuto viene caricato via AJAX
4. Lo stato di caricamento viene indicato dalla classe loading

Le cartelle aperte vengono salvate nel cookie. Al prossimo caricamento pagina queste cartelle vengono precaricate lato server, anche se sono più profonde di dynamic. Questo impedisce „flicker“ al caricamento.

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

Risposta:

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

Il plugin riconosce i confini namespace tramite file sidebar*:

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

1. Senza parametro
   └── Cerca verso l'alto file sidebar*
   └── Avvia menu da quel namespace

2. Con ns="..."
   └── Usa il namespace specificato direttamente

3. Con dynamic="N"
   └── Trova namespace sidebar
   └── Carica N livelli in anticipo, resto via AJAX

Il plugin considera le regole ACL DokuWiki e mostra le cartelle in modo intelligente, anche se non tutti i contenuti sono leggibili per l'utente.

Quando sneaky_index è attivato e una cartella non è direttamente leggibile (es. it:int:vsce:start per utenti anonimi), ma contenuti leggibili esistono più in profondità nell'albero (es. it:int:vsce:fpc:p:*), la cartella viene comunque mostrata:

📂 vsce          ← partial (nessun link, solo etichetta)
   📂 fpc        ← partial (nessun link, solo etichetta)
      📁 p       ← normale (link a p:start)
         📄 start
         📄 download

Comportamento:

• Cartelle con classe partial mostrano solo un'etichetta (nessun link alla pagina start)
• Cliccabile: Un click sulla cartella espande/comprime i figli
• La cartella è inizialmente aperta per mostrare i figli leggibili
• Lo styling può essere personalizzato via CSS

Con startns=„current“ il link „Vai su“ non salta semplicemente al namespace parent, ma al namespace home dell'utente basato su regole ACL:

Priorità:

1. Wildcard namespace (es. it:pub:*) hanno precedenza
2. ACL singole pagine (es. it:int:start) sono secondari
3. Viene preferito il namespace più corto (più alto)

Esempio: Un utente anonimo su it:int:vsce:fpc:p:start vede il link „Vai su“ a it:pub:start, non a it:int:start.

Il template flat carica le pagine sidebar specifiche per namespace.

Il template cerca il file sidebar (es. sidebar1.txt) partendo dal namespace corrente verso l'alto:

Pagina: it:int:vsce:fpc:p:start

Ricerca sidebar1.txt:
1. it:int:vsce:fpc:p:sidebar1 → non trovato
2. it:int:vsce:fpc:sidebar1   → non trovato
3. it:int:vsce:sidebar1       → non trovato
4. it:int:sidebar1            → TROVATO ✓

Risultato: Per pagine it:int:* viene caricato it:int:sidebar1.txt, per pagine it:pub:* viene caricato it:sidebar1.txt.

Esempio voci ACL:

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

Per pagine senza titolo visibile (es. landing page con hero section) può essere definito un titolo per il menu:

~~NOTOC~~
{{wvds:title>Verifica conformità NIS2}}

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

Il titolo viene:

• Mostrato nel menu
• Salvato nei metadati
• Non renderizzato sulla pagina

Il menu usa titoli nel seguente ordine:

1. {{wvds:title>...}} (Titolo invisibile)
2. Primo heading della pagina (se useheading attivato)
3. ID pagina come fallback

sidebar1.txt:

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

Un solo file sidebar per tutti i namespace di una lingua:

it/sidebar1.txt:

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

Questa configurazione:

• Focalizzata: Mostra principalmente il namespace corrente
• „Vai su“ smart: Link al namespace home basato su ACL
• Rilevamento fratelli: Mostra altri namespace con contenuto leggibile
• Partial namespace: Percorsi verso aree pubbliche in zone protette
• Usa icone FontAwesome
• Carica solo 1 livello inizialmente, resto via AJAX

it/sidebar1.txt:

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

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

Per grandi strutture - mostra solo l'area corrente con link „Vai su“:

{{wvds:acmenu startns="current" icons="fa"}}

Risultato (per pagina it:crypto:openssl:start):

↑ ..
📂 openssl
   📄 start
   📁 commands
   📄 examples

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

/* Partial namespace - cliccabile per espandere */
div.acmenu li.partial > div.li {
    cursor: pointer;
}
 
div.acmenu li.partial > div.li .ns-label {
    color: #666;
    font-style: italic;
}
 
/* Colore icona per cartelle partial */
div.acmenu.acmenu-icons li.partial > div.li .fa {
    color: #999;
}

/* Indicatore caricamento */
div.acmenu li.loading > div.li:after {
    content: " ⟳";
    animation: spin 1s linear infinite;
}
 
@keyframes spin {
    from { transform: rotate(0deg); }
    to { transform: rotate(360deg); }
}
 
/* Marcatura visiva cartelle lazy */
div.acmenu li.lazy > div.li {
    cursor: pointer;
}

Le cartelle aperte vengono salvate nel cookie plugin_wvdsacmenu_open_items.

// Nome cookie
plugin_wvdsacmenu_open_items
 
// Valore (Array JSON)
["it:crypto:start","it:docs:api:start"]

Durante il rendering il plugin legge il cookie e precarica tutte le cartelle salvate - anche se sono più profonde di dynamic. Questo ripristina lo stato menu senza flicker JavaScript.

• WvdS.DokuWiki.Snippet Plugin - Blocchi HTML
• WvdS.DokuWiki.I18n Plugin - Testi multilingue
• WvdS.DokuWiki.Flat Template - Template con sidebar

File: lib/plugins/wvdsacmenu/syntax.php

File: lib/tpl/flat/lang_helper.php

Cerca un file sidebar partendo dal namespace corrente verso l'alto.

File: lib/plugins/wvdsacmenu/action.php

File: lib/plugins/wvdsacmenu/script.js