You are here: start » en » Internal Documentation » DokuWiki extensions (WvdS) » FluentUI (design system library) » Quickstart: open an admin screen in the workbench

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

  • wkfluentui is 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=classic the 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 dokuwiki template under Admin → Configuration → template and reload. Workbench, regions and tokens are still there. A template supplies appearance, not structure.

Next step

en/wiki/dwe/wkfluentui/quickstart.txt · Last modified: by 0.0.0.0