Dodatak: wvdsacmenu
Verzija: 1.3.0
Namespace: lib/plugins/wvdsacmenu/
Osnova: AcMenu od Torpedo
Proširenja: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenca: GPL 2

Dodatak wvdsacmenu prikazuje harmonika izbornik za namespaceove i stranice. Proširuje izvorni AcMenu wiki sintaksom, dinamičkim prepoznavanjem namespacea, lazy učitavanjem, ACL-aware navigacijom i višejezičnom podrškom.

DokuWiki standardna navigacija i izvorni AcMenu imaju nekoliko ograničenja u poslovnim okruženjima:

• ACL sljepoća: Kad je sneaky_index=1 aktivan, zaštićene mape su potpuno skrivene - čak i ako dublje postoje javni sadržaji
• Nema lazy učitavanja: Kod velikih dokumentacijskih struktura (100+ stranica) bočna traka postaje spora i nepregledna
• Jezična izolacija: Višejezični wikiji zahtijevaju ručnu konfiguraciju po namespaceu
• Nema integracije s predloškom: Odabir bočne trake je statičan i ne poznaje hijerarhiju namespacea

ACL konfiguracija:
  de:int:*                @ALL  0   (zaključano)
  de:int:vsce:fpc:p:*     @ALL  1   (javno)

Rezultat standardnog AcMenu:
  📂 de
     📁 pub          ← vidljivo
     (vsce nedostaje!)   ← PROBLEM: cijela putanja je skrivena

Rezultat wvdsacmenu:
  📂 de
     📁 pub
     📂 int
        📂 vsce      ← partial (bez linka)
           📂 fpc    ← partial (bez linka)
              📁 p   ← vidljivo i navigabilno

Korisnik vidi putanju do javnih sadržaja, čak i ako mape u sredini nisu izravno čitljive.

wvdsacmenu je razvijen za složene dokumentacijske strukture s diferenciranim pravima pristupa:

1. Minimalno otkrivanje: Prikaži samo ono što korisnik smije vidjeti, ali prikaži putanju do toga
2. Progresivno učitavanje: Učitaj malo na početku, proširi po potrebi
3. Obnova bez stanja: Stanje cookieja se obnavlja na serveru (bez treperenja)
4. Duboka integracija: Dodatak tijesno surađuje s predloškom i ACL sustavom

• Navigacija namespacea - Automatski izbornik za strukturu dokumentacije
• Višejezični wikiji - Odvojeni izbornici po jezičnom namespaceu
• Projektna dokumentacija - Hijerarhijska navigacija u pod-namespaceovima
• Integracija s bočnom trakom - Kompaktna navigacija u sidebar-u
• Optimizacija performansi - Lazy učitavanje za velike strukture izbornika
• ACL-aware navigacija - Prikazuje mape čak i kad su samo dijelovi čitljivi

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

{{wvds:title>Naslov moje stranice}}

Definira naslov za stranicu koji se prikazuje u izborniku, bez da je vidljiv na samoj stranici. Korisno za stranice s hero sekcijama ili posebnim layoutima.

Vrijednosti ns parametra:

Prikazuje određeni namespace neovisno o trenutnoj stranici:

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

Kontrolira koliko razina se inicijalno učitava. Dublje razine se naknadno učitavaju putem AJAX-a:

Važno: Namespace se uvijek računa relativno prema poziciji bočne trake, ne prema trenutnoj stranici.

Slično Total Commanderu: Prikazuje samo trenutni namespace s linkom „Idi gore“:

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

Prednosti:

• Preglednije kod velikih struktura
• Fokus na trenutno područje
• Link „Idi gore“ za navigaciju

Aktivira vizualne ikone za mape i datoteke:

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

Preduvjet: FontAwesome mora biti učitan u predlošku (u flat predlošku već je uključen).

Način auto kombinira fokusiranu navigaciju s ACL-aware prepoznavanjem susjednih:

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

Način rada:

1. Fokusirani prikaz: Počinje s trenutnim namespaceom (kao startns=„current“)
2. ACL-aware „Idi gore“: Link na home namespace korisnika temeljen na ACL pravilima
3. Susjedni s Partial sadržajem: Prikazuje druge namespaceove na razini jezika koji imaju čitljiv sadržaj
4. Može se kombinirati s dynamic za lazy učitavanje

Razlika prema startns=„current“:

Slučaj korištenja: Jedna sidebar1.txt za sve namespaceove jednog jezika:

# hr/sidebar1.txt (radi za hr:pub:*, hr:int:*, itd.)
~~NOCACHE~~
{{wvds:acmenu ns="auto" icons="fa" dynamic="1"}}

Primjer 1: Anonimni korisnik na hr:pub:start

ACL: hr:int:vsce:fpc:p:* je javno, ostatak hr:int:* je zaključan

↑ ..                    ← Idi gore (izostavlja se ako je već na home)
📂 pub                  ← trenutni namespace (fokusirano)
   📄 start
   📁 services
📂 int                  ← susjedni s Partial sadržajem
   📂 vsce              ← partial (klikljivo za proširenje)
      📂 fpc            ← partial
         📁 p           ← čitljivo

Primjer 2: Anonimni korisnik na hr:int:vsce:fpc:p:start

↑ ..                    ← Idi gore na hr:pub:start (home za @ALL)
📁 p                    ← trenutni namespace (fokusirano)
   📄 start
   📄 download

Primjer 3: @user na hr:int:dwe:start

↑ ..                    ← Idi gore na hr:int:start (home za @user)
📁 dwe                  ← trenutni namespace (fokusirano)
   📄 start
   📁 wvdsacmenu
   📁 wvdssnippet
📁 vsce                 ← susjedni (potpuno čitljivo)
📁 pqcrypt              ← susjedni (potpuno čitljivo)

Zašto pametni Auto?

1. Pri učitavanju stranice renderira se samo prvih N razina (dynamic)
2. Mape na granici dubine dobivaju CSS klasu lazy
3. Klikom na lazy mapu sadržaj se učitava putem AJAX-a
4. Stanje učitavanja se prikazuje klasom loading

Otvorene mape se spremaju u cookie. Pri sljedećem učitavanju stranice te mape se serverski prethodno učitavaju, čak i ako su dublje od dynamic. To sprječava „treperenje“ pri učitavanju.

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

Odgovor:

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

Dodatak prepoznaje granice namespacea putem sidebar* datoteka:

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

1. Bez parametra
   └── Traži uzlazno sidebar* datoteku
   └── Pokreće izbornik od tog namespacea

2. S ns="..."
   └── Koristi navedeni namespace izravno

3. S dynamic="N"
   └── Pronalazi namespace bočne trake
   └── Učitava N razina unaprijed, ostatak putem AJAX-a

Dodatak uzima u obzir DokuWiki ACL pravila i inteligentno prikazuje mape, čak i ako nisu svi sadržaji čitljivi za korisnika.

Kad je sneaky_index aktiviran i mapa nije izravno čitljiva (npr. hr:int:vsce:start za anonimne korisnike), ali čitljivi sadržaji postoje dublje u stablu (npr. hr:int:vsce:fpc:p:*), mapa se ipak prikazuje:

📂 vsce          ← partial (bez linka, samo oznaka)
   📂 fpc        ← partial (bez linka, samo oznaka)
      📁 p       ← normalno (link na p:start)
         📄 start
         📄 download

Ponašanje:

• Mape s klasom partial prikazuju samo oznaku (bez linka na start stranicu)
• Klikljivo: Klik na mapu proširuje/skuplja djecu
• Mapa je inicijalno otvorena kako bi se prikazala čitljiva djeca
• Stiliziranje se može prilagoditi putem CSS-a

Kod startns=„current“ link „Idi gore“ ne skače jednostavno na parent namespace, nego na home namespace korisnika temeljen na ACL pravilima:

Prioritet:

1. Namespace wildcardovi (npr. hr:pub:*) imaju prednost
2. Pojedinačni ACL-ovi stranica (npr. hr:int:start) su sekundarni
3. Preferira se najkraći (najviši) namespace

Primjer: Anonimni korisnik na hr:int:vsce:fpc:p:start vidi link „Idi gore“ na hr:pub:start, ne na hr:int:start.

Predložak flat učitava stranice bočne trake specifično za namespace.

Predložak traži datoteku bočne trake (npr. sidebar1.txt) počevši od trenutnog namespacea prema gore:

Stranica: hr:int:vsce:fpc:p:start

Potraga za sidebar1.txt:
1. hr:int:vsce:fpc:p:sidebar1 → nije pronađeno
2. hr:int:vsce:fpc:sidebar1   → nije pronađeno
3. hr:int:vsce:sidebar1       → nije pronađeno
4. hr:int:sidebar1            → PRONAĐENO ✓

Rezultat: Za hr:int:* stranice učitava se hr:int:sidebar1.txt, za hr:pub:* stranice učitava se hr:sidebar1.txt.

Primjer ACL unosa:

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

Za stranice bez vidljivog naslova (npr. landing stranice s hero sekcijom) može se definirati naslov za izbornik:

~~NOTOC~~
{{wvds:title>NIS2 Provjera usklađenosti}}

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

Naslov se:

• Prikazuje u izborniku
• Sprema u metapodatke
• Ne renderira na stranici

Izbornik koristi naslove sljedećim redoslijedom:

1. {{wvds:title>...}} (Nevidljivi naslov)
2. Prva zaglavlje stranice (ako je useheading aktiviran)
3. ID stranice kao fallback

sidebar1.txt:

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

Jedna datoteka bočne trake za sve namespaceove jednog jezika:

hr/sidebar1.txt:

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

Ova konfiguracija:

• Fokusirano: Prikazuje primarno trenutni namespace
• Pametni „Idi gore“: Link na home namespace temeljen na ACL-u
• Prepoznavanje susjednih: Prikazuje druge namespaceove s čitljivim sadržajem
• Partial namespaceovi: Putanje do javnih područja u zaštićenim zonama
• Koristi FontAwesome ikone
• Učitava samo 1 razinu inicijalno, ostatak putem AJAX-a

hr/sidebar1.txt:

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

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

Za velike strukture - prikazuje samo trenutno područje s linkom „Idi gore“:

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

Rezultat (za stranicu hr:crypto:openssl:start):

↑ ..
📂 openssl
   📄 start
   📁 commands
   📄 examples

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

/* Partial namespaceovi - klikljivo za proširenje */
div.acmenu li.partial > div.li {
    cursor: pointer;
}
 
div.acmenu li.partial > div.li .ns-label {
    color: #666;
    font-style: italic;
}
 
/* Boja ikone za partial mape */
div.acmenu.acmenu-icons li.partial > div.li .fa {
    color: #999;
}

/* Indikator učitavanja */
div.acmenu li.loading > div.li:after {
    content: " ⟳";
    animation: spin 1s linear infinite;
}
 
@keyframes spin {
    from { transform: rotate(0deg); }
    to { transform: rotate(360deg); }
}
 
/* Vizualno označavanje lazy mapa */
div.acmenu li.lazy > div.li {
    cursor: pointer;
}

Otvorene mape se spremaju u cookie plugin_wvdsacmenu_open_items.

// Naziv cookieja
plugin_wvdsacmenu_open_items
 
// Vrijednost (JSON polje)
["hr:crypto:start","hr:docs:api:start"]

Pri renderiranju dodatak čita cookie i prethodno učitava sve tamo spremljene mape - čak i ako su dublje od dynamic. To obnavlja stanje izbornika bez JavaScript treperenja.

• WvdS.DokuWiki.Snippet Dodatak - HTML blokovi
• WvdS.DokuWiki.i18n Dodatak - Višejezični tekstovi
• WvdS.DokuWiki.Flat Predložak - Predložak s bočnom trakom

Datoteka: lib/plugins/wvdsacmenu/syntax.php

Datoteka: lib/tpl/flat/lang_helper.php

Traži datoteku bočne trake počevši od trenutnog namespacea prema gore.

Datoteka: lib/plugins/wvdsacmenu/action.php

Datoteka: lib/plugins/wvdsacmenu/script.js