AcMenu Vtičnik

AcMenu izriše meni v obliki harmonike prek imenskih prostorov in strani – z upoštevanjem pravic ACL, z lenim nalaganjem globljih ravni, nastavljivim vrstnim redom in zbirkami strani. Paket je namenjen avtorjem, ki nastavijo 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.

Hitri začetek: meni v stransko vrstico – najkrajša pot do prvega rezultata, v dveh korakih.

Ustvarite stran stranske vrstice → Izberite način → Preverite

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, velja 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 vnaprej naložena na strežniku.

Katera komponenta prevzame kateri korak, je opisano v referenci skladnje, razdelek »Pot izrisa«.

• Skladnja wikija {{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 strežnik obnovi iz piškotka
• Vrstni red menija na imenski prostor prek strani vrstnega reda – urejate jo ročno ali z vlečenjem in spuščanjem (skrbniki)
• 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

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 – sta shranjena 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.

Ta paket nima svojega skrbniškega zaslona – upravljate ga 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 z vlečenjem in spuščanjem

• Namesto menija se pokaže pokvarjena povezava
• Ikona zbirke se po nastavitvi označevalca ne pokaže
• Vnosov menija ni mogoče premikati z vlečenjem
• Meni po spremembah CSS/JS kaže staro stanje
• Vsi simptomi z vzrokom in rešitvijo

• 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 razcep (fork) vtičnika AcMenu (Torpedo), nameščen je v lib/plugins/wkacmenu/ in je izdan pod licenco GPL 2.

• Nastavitev menija imenskega prostora – nastavitev menija imenskega prostora
• Kako: določiti vrstni red menija – določitev vrstnega reda menija
• Kako: urediti 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