Quickstart: open an admin screen in the workbench
The shortest way from “the plugin is installed” to “an existing administration screen runs in the workbench shell, with activity bar, sidebar and status bar”. Two steps, about five minutes — without a line of code.
Prerequisites
wkfluentuiis installed and enabled in the Extension Manager.- You are signed in as superuser.
- No template required. The workbench belongs to this plugin, not to the template; everything here works under the template DokuWiki ships with. That is the point you verify in step 2.
Step 1: open one screen on both surfaces
Take any existing administration screen, the configuration manager say, and open it twice:
/doku.php?do=admin&page=config
/doku.php?do=admin&page=config&mode=fluentui
The first is DokuWiki's own administration and must stay exactly that. The second is already framed by the shell — you configured nothing for it.
Step 2: switch back, and come back
mode=fluentui is remembered per user. After the first call the parameter is optional; /doku.php?do=admin&page=config now opens in the workbench too.
The documented way back:
/doku.php?do=admin&page=config&mode=classic
The switch is a display preference, never an authorization. What somebody may see and do is decided, unchanged, by the DokuWiki ACL and by the permission check of the administration plugin itself. A stray ?mode=fluentui on an ordinary wiki page therefore does nothing and remembers nothing.
Check the result
- On the workbench surface the same screen sits in a shell: activity bar, sidebar, content region, status bar. The content is unchanged.
- Under
mode=classicthe same screen renders as ordinary DokuWiki administration again. No button is missing. If one is, it belongs to the screen's content and was wrongly placed in a shell region. - Counter-check on template independence: switch the wiki to the shipped
dokuwikitemplate under Admin → Configuration →templateand reload. Workbench, regions and tokens are still there. A template supplies appearance, not structure.
Next step
- Tutorial: build your first admin surface with FluentUI (German) — give your own screen regions, widgets and a badge.
- wkfluentui (German) — the package page.
- Styles contract (German) — the
--wk-*token contract: who defines them and who only reads them.