Avvio rapido: aprire una schermata di amministrazione nel workbench

Il percorso più breve da «il plugin è installato» a «una schermata di amministrazione esistente gira nella shell del workbench, con barra delle attività, barra laterale e barra di stato». Due passi, circa cinque minuti — senza una riga di codice.

• wkfluentui è installato e attivato nel gestore delle estensioni.
• Siete autenticati come superuser.
• Nessun template necessario. Il workbench appartiene a questo plugin, non al template; tutto quanto segue funziona anche con il template fornito da DokuWiki. È il punto che verificate nel passo 2.

Prendere una qualsiasi schermata di amministrazione esistente, per esempio il gestore della configurazione, e aprirla due volte:

/doku.php?do=admin&page=config

/doku.php?do=admin&page=config&mode=fluentui

La prima è l'amministrazione propria di DokuWiki e tale deve restare. La seconda è già inquadrata nella shell — senza che abbiate configurato nulla.

mode=fluentui viene ricordato per utente. Dopo la prima chiamata il parametro è superfluo; anche /doku.php?do=admin&page=config si apre ora nel workbench.

La via di ritorno documentata:

/doku.php?do=admin&page=config&mode=classic

L'interruttore è una preferenza di visualizzazione, mai un'autorizzazione. Che cosa si possa vedere e fare resta deciso dall'ACL di DokuWiki e dal controllo dei permessi del plugin di amministrazione stesso. Un ?mode=fluentui capitato su una normale pagina wiki non fa quindi nulla e non ricorda nulla.

• Sulla superficie del workbench la stessa schermata sta in una shell: barra delle attività, barra laterale, area del contenuto, barra di stato. Il contenuto è invariato.
• Con mode=classic la stessa schermata torna a rendersi come normale amministrazione DokuWiki. Nessun pulsante manca. Se ne manca uno, appartiene al contenuto della schermata ed è stato collocato per errore in una regione della shell.
• Controprova dell'indipendenza dal template: passare al template dokuwiki fornito, in Amministrazione → Configurazione → template, e ricaricare. Workbench, regioni e token sono ancora lì. Un template fornisce l'aspetto, non la struttura.

• Guida: la prima interfaccia di amministrazione con FluentUI (in tedesco) — dotare la propria schermata di regioni, widget e badge.
• wkfluentui (in tedesco) — la pagina del pacchetto.
• Styles-Contract (in tedesco) — il contratto sui token --wk-*.