AcMenu Vtičnik
AcMenu izriše harmonika meni čez imenske prostore in strani — z upoštevanjem pravic ACL, z lenim nalaganjem globljih ravni, nastavljivim vrstnim redom in zbirkami strani. Paket je namenjen avtorjem, ki uredijo stransko vrstico imenskega prostora in njen vrstni red, in bralcem, ki se prek njega gibljejo po zaščitenih in javnih območjih, ne da bi videli zaprte vnose.
Prvi koraki
Pogosta opravila
| Kaj želite | Za koga | Kje to naredite | Navodilo |
|---|---|---|---|
| nastaviti meni imenskega prostora | avtorji | stran stranske vrstice imenskega prostora | Vodnik: nastavitev menija |
| določiti vrstni red menija | avtorji | stran <ip>:order, kot superuporabnik tudi s povleci-in-spusti | Kako: določiti vrstni red |
| imenski prostor voditi kot zbirko strani | avtorji | začetna stran prostora, oznaka ~~COLLECTION~~ | Kako: zbirka strani |
| nastaviti naslov v meniju brez vidnega naslova | avtorji | stran, oznaka {{wk:title>…}} | Kako: naslov v meniju |
| poiskati oznake in njihove parametre | avtorji | – | Referenca skladnje in API |
| ugotoviti vzrok napake | vsi | – | Diagnostika |
Potek na kratko
Meni nastane med izrisom stranske vrstice iz strani osnovnega imenskega prostora: za vsak vnos se preveri bralna pravica, nato se razvrsti — imenski prostori pred stranmi, po abecedi; če obstaja stran vrstnega reda, vodi njeno zaporedje. V osredotočenih načinih se osnova premakne iz zbirk, saj je zbirka dokument in ne mapa. Onkraj globine prednalaganja odjemalec poddrevesa naloži sproti; trenutna pot je vedno prednaložena strežniško.
Katera komponenta prevzame kateri korak, je opisano v referenci skladnje, razdelek »Pot izrisa«.
Ključne zmožnosti
- Wiki skladnja
{{wk:acmenu>...}}z načini za fiksni imenski prostor, osredotočeni pogled in pametno samozaznavo - Navigacija z upoštevanjem ACL: delni imenski prostori (poti do javnih vsebin znotraj zaščitenih območij), „navzgor„ na podlagi ACL
- Leno nalaganje globljih ravni; odprta vozlišča se strežniško obnovijo iz piškotka
- Vrstni red menija na imenski prostor prek strani vrstnega reda — vzdrževano ročno ali s povleci-in-spusti (superuporabniki)
- Zbirke strani: označen imenski prostor se vede kot en dokument s podstranmi
- Nevidni naslovi v meniju na stran, večjezično prek paketa wki18n
- Ikone FontAwesome po izbiri za posamezni meni
Ključni pojmi
Osnovni imenski prostor je izsek strani, ki ga meni pokaže; način oznake odloči, ali je določen fiksno, sledi trenutni strani ali se ugotovi samodejno. Zbirka je imenski prostor, ki se vede kot en dokument s podstranmi in zato nikoli ne postane osnova menija.
Označevalca — oznaka zbirke in nevidni naslov — ležita v trenutnih metapodatkih strani in po odstranitvi izgineta sama od sebe. Izris sam prihaja iz skupne komponente drevesa v paketu wkfluentui; ta paket pridobi podatke.
Upravljanje
Ta paket nima svojega skrbniškega zaslona — vodi se z oznakami v besedilu strani in s stranmi vrstnega reda.
- Nastavitve – globina prednalaganja in preostale vrednosti v upravitelju nastavitev
- Določitev vrstnega reda – pisanje strani vrstnega reda, ročno ali s povleci-in-spusti
Diagnostika
Za razvijalce
- Referenca skladnje in API – oznake, stran vrstnega reda, končni točki AJAX, PHP API, razredi CSS, pot izrisa
- Zgodovina različic – kaj se je kdaj spremenilo in zakaj
- wkfluentui – komponenta drevesa, ki izriše izhod
- Styles Contract – pogodba o žetonih, na kateri sloni izris
Paket je močno razširjen fork vtičnika AcMenu (Torpedo), leži v lib/plugins/wkacmenu/ in je izdan pod licenco GPL 2.
Sorodne teme
- Nastavitev menija imenskega prostora — nastavitev menija imenskega prostora
- Kako: določiti vrstni red menija — določitev vrstnega reda menija
- Kako: voditi imenski prostor kot zbirko strani — imenski prostor kot zbirka strani
- Kako: nastaviti naslov v meniju brez vidnega naslova strani — naslov v meniju brez vidnega naslova strani
- Referenca skladnje in API — referenca skladnje in API
- Diagnostika — diagnostika
- Zgodovina različic — zgodovina različic
<wk:audit stack=„doku“ title=„wkacmenu Plugin“>
<wk:include ref="code:qualitaet" critical="true">[x][x][x][x]</wk:include> <wk:include ref="stacks:dokuwiki-php">[x][x][x][x][x]</wk:include> <wk:include ref="sicherheit:kritis" critical="true">[x][x][x][-][-]</wk:include>
</wk:audit>
DISCUSSION