FluentUI: Konfigurationsreferenz

Diese Seite beschreibt alle 17 Einstellungen des Pakets wkfluentui: Schlüssel, Typ, Vorgabewert, Wirkung und — wo es darauf ankommt — was bei einem ungültigen Wert geschieht.

Die Beschriftung im Konfigurationsmanager ist eine Zeile. Sie kann sagen, was ein Feld tut, aber nicht, was bei einem Tippfehler passiert, welche anderen Einstellungen mitwirken und in welcher Reihenfolge. Genau das steht hier.

Verwaltung → Konfiguration → Abschnitt Plugin, dort der Block wkfluentui. Die Werte landen in conf/local.php; von Hand geschrieben wird diese Datei nicht, das übernimmt der Konfigurationsmanager.

Eine Einstellung dieses Pakets gilt wikiweit. Drei davon sind ausdrücklich nur ein Startwert: die eigene Wahl eines angemeldeten Benutzers sticht sie. Welche das sind, steht unten unter Rangfolge der Vorgaben.

Typ Zahl, Untergrenze 1 · Vorgabe 20

Höchstzahl gleichzeitig geöffneter Registerkarten je Benutzer in der Leiste über dem Inhalt der Verwaltungsbildschirme.

Die Obergrenze existiert, weil sich Registerkarten von selbst öffnen: Jedes Verwaltungsmodul, das ein Benutzer besucht, meldet eine an. Ohne Grenze hinterlässt eine lange Sitzung eine Leiste, die breiter ist als das Fenster und in der niemand mehr etwas findet.

Die Untergrenze ist 1 und nicht 0. Null hieße „keine Registerkarte darf je öffnen„ — das ist keine Einstellung der Leiste, sondern ihre Entfernung, und der Weg dorthin ist, die Werkbank-Oberfläche zu verlassen.

Typ mehrzeiliges Textfeld, Inhalt JSON · Vorgabe leer

Start-Anordnung des Arbeitsplatzes für Benutzer, die noch keine eigene haben: welche Dokumente offen sind, in welcher Reihenfolge, welches Modul daneben sitzt, wo eine Ansicht liegt.

Wer nie etwas verschiebt, bekommt diese — und die eigene Anordnung sticht sie immer. Genau das macht eine wikiweite Vorgabe zu einem Ausgangspunkt statt zu einer Vorschrift.

Leer bedeutet „keine Start-Anordnung“; das ist der Zustand einer unangetasteten Installation. Fehlerhaftes JSON wird wie leer behandelt, nicht als Fehler: Der Tippfehler eines Administrators darf nicht jedem Leser die Werkbank zerlegen. Es gibt dafür allerdings auch keine Rückmeldung — wer eine Vorgabe setzt und keine Wirkung sieht, prüft zuerst, ob das JSON gültig ist.

Es ist eine Einstellung und nichts, was das Plugin selbst schreibt. Schreiben hieße, conf/local.php aus Code neu zu erzeugen; das ist hier untersagt, und die Begründungsblöcke in jener Datei überleben es nicht.

Fünf Einstellungen wirken an einer Entscheidung mit. Die Reihenfolge ist dabei die eigentliche Auskunft:

Typ Zeichenkette · Vorgabe start

Die Seiten-ID, die die Einstiegs-Regeln auslöst. Leer schaltet die gesamte Einstiegs-Weiterleitung ab — dieser Schalter ist die Funktion, kein Sonderfall.

Ausgelöst wird nur bei einer exakten Übereinstimmung: entweder genau dieser Kennung oder <sprache>:<kennung> mit einer Sprache aus available_languages. Eine tiefer liegende Seite, die zufällig genauso endet, bleibt unberührt. Das ist keine Feinheit: Das Weiterleitungsziel de:wiki:start endet selbst auf start und würde den Mechanismus sonst erneut auslösen.

Typ Zeichenkette, kommagetrennt · Vorgabe de,en,hr,it,sl

Sprachkürzel, auf die die Einstiegs-Regeln auflösen dürfen. Leerräume um die Einträge werden entfernt, leere Einträge fallen weg.

Die Liste ist zugleich der Filter für die Browser-Sprache. Eine Sprache außerhalb dieser Liste kann einen Besucher deshalb niemals in einen Namensraum schicken, den es nicht gibt.

Typ Zeichenkette · Vorgabe de

Sprache, wenn die Browser-Sprache in der Liste oben nicht vorkommt oder der Browser gar keine mitschickt.

Die Ermittlung wertet Accept-Language mit Qualitätsgewichten aus, nicht bloß den ersten Eintrag: Der Kopf de;q=0.3, it;q=0.9 ergibt Italienisch, sofern it in der Liste steht.

Typ mehrzeiliges Textfeld, Inhalt XML · Vorgabe zwei Regeln (siehe unten)

Die Einstiegs-Regeln. Geprüft wird der Reihe nach; die erste passende Regel gewinnt.

Jede <rule> kennt drei Attribute:

• group — DokuWiki-eigene ACL-Schreibweise (@gruppe, blanker Benutzername, @ALL, kommagetrennt). Fehlt das Attribut oder ist es leer, passt die Regel auf jeden.
• lang — muss der in Schritt 3 ermittelten Sprache entsprechen. Fehlt es, ist die Sprache gleichgültig.
• target — Zielkennung. {{lang}} darin wird durch die ermittelte Sprache ersetzt.

Die Vorgabe:

<routing>
    <rule group="@user" target="{{lang}}:wiki:start"/>
    <rule target="{{lang}}:site"/>
</routing>

Angemeldete Benutzer der Gruppe user landen also im Wiki-Bereich ihrer Sprache, alle übrigen im Seitenbereich.

Fehlerhaftes XML bedeutet „keine Regeln„, nicht Abbruch. Die Seite lädt normal weiter, sie leitet nur nicht mehr um — und zwar ohne jede Meldung. Wer eine Regel ändert und danach keine Weiterleitung mehr sieht, prüft zuerst die Wohlgeformtheit des XML.

Aus Sicherheitsgründen wird XML mit <!DOCTYPE> oder <!ENTITY> rundweg abgewiesen, Netzzugriff ist abgeschaltet und der Lader für externe Entitäten ausgehängt. Diese drei Maßnahmen zusammen schließen die bekannten Angriffe über eingebettete Entitäten aus.

Zeigt das Ziel auf keine Seite, aber auf einen Namensraum, dessen Startseite existiert, wird diese genommen. Ein Ziel, das der Ausgangsseite entspricht, wird verworfen — das verhindert die Weiterleitungsschleife.

Typ Schalter · Vorgabe ein

Leitet den Aufruf eines Namensraums ohne abschließenden Doppelpunkt (de:site) auf dessen Startseite weiter. DokuWiki selbst tut das nur für die Form mit Doppelpunkt (de:site:); diese Einstellung verallgemeinert es.

Diese Weiterleitung nimmt an der Regelkette oben nicht teil. Sie ist ein eigener Haken mit eigenen Bedingungen und greift nur, wenn die Anfrage eine gewöhnliche Anzeige ist, die aufgerufene Kennung keine existierende Seite benennt und darunter eine Startseite liegt.

Eine vorhandene Seite wird nie übergangen. Ein Namensraum ohne Startseite behält DokuWikis eigene Aufforderung, die Seite anzulegen.

Zwei unabhängige, automatische Weiterleitungen greifen ausschließlich bei $ACT === 'show' — beim normalen Seitenaufruf also, nicht beim Bearbeiten, Vergleichen oder Verwalten. Beide müssen Plugin-Code sein: DokuWiki bindet die aktive Vorlage erst ein, nachdem act_dispatch() die Aktion aufgelöst hat; für eine Weiterleitung ist es dann zu spät. Nur ein Action-Plugin auf DOKUWIKI_STARTED kommt früh genug.

Zwei Rollen, die sich leicht verwechseln lassen:

• landing_page ist kein Ziel, sondern der Auslöse-Seitenname: der bloße Seitenname (z. B. start), gegen den die aufgerufene Seiten-ID unverändert, ohne Platzhalter-Ersetzung verglichen wird. Ausgelöst wird bei exakter Übereinstimmung mit landing_page selbst oder mit <Sprache>:landing_page für jede in available_languages gelistete Sprache. Ein Wert wie {{lang}}:site:start funktioniert hier nicht: {{lang}} wird an dieser Stelle nie ersetzt, die Bedingung kann nie zutreffen, und die Weiterleitung greift dann bei keinem Seitenaufruf — lautlos, ohne Fehlermeldung.
• routing_rules definiert die tatsächlichen Ziele, je Regel per target-Attribut — und dort wird {{lang}} durch die aufgelöste Sprache ersetzt.

Ablauf, sobald die Auslöse-Bedingung zutrifft:

1. Sprache bestimmen: trägt die aufgerufene Seite bereits ein Sprachpräfix (de:start), gilt diese Sprache; sonst wird der Browser-Header Accept-Language gegen available_languages abgeglichen (höchste Qualitätsangabe zuerst); ergibt beides nichts, greift default_language.
2. routing_rules (XML) der Reihe nach durchgehen, erste passende Regel gewinnt. Ein <rule> hat drei Attribute: group (leer = passt auf jeden Besucher, sonst DokuWiki-ACL-Syntax wie in conf/acl.auth.php: @gruppe, Benutzername oder @ALL, geprüft über auth_isMember()), lang (leer = jede Sprache) und target (Ziel-Seiten-ID, {{lang}} wird ersetzt).
3. Ist das aufgelöste target selbst keine existierende Seite, aber <target>:<Startseitenname> ($conf['start'], normalerweise start) existiert, wird automatisch dorthin verlängert — ein Namensraum-Ziel wie de:site wird so zu de:site:start, ohne dass die Regel das ausschreiben muss.
4. Ungültiges XML in routing_rules → keine Regeln, keine Weiterleitung, kein Fehler.

Beispiel (Live-Konfiguration dieser Instanz):

landing_page = start
routing_rules = <routing>
    <rule group="@user" target="{{lang}}:wiki:start"/>
    <rule target="{{lang}}:site"/>
</routing>

Aufruf von start oder de:start:

• Mitglied der Gruppe @user (angemeldet) → erste Regel trifft → Ziel de:wiki:start.
• Jeder andere Besucher (zweite Regel hat kein group-Attribut, passt also immer) → Ziel de:site → existiert nicht als Seite → verlängert zu de:site:start.

Das erklärt, warum de:site:start und de:wiki:start zwei völlig verschiedene Seiten sind, obwohl beide über denselben Auslöser erreichbar sind: Regel-Reihenfolge und group-Attribut entscheiden, wer wo landet, nicht der Seitenname.

Bekannter Fehlerfall (behoben 2026-07-09): genau diese Verwechslung — landing_page fälschlich auf ein Ziel statt auf den Auslöse-Namen gesetzt — führte dazu, dass ein Klick auf „Home“ auf der unveränderten Auslöse-Stub-Seite landete statt auf der gewünschten Seite.

Die Namensraum-Index-Weiterleitung verlängert einen Aufruf, der auf einen Namensraum ohne eigene Seite zeigt, auf dessen Startseite. Abschaltbar über namespace_index_redirect — der Ausschalter, ohne den diese Weiterleitung die Hausregel „zuschaltbar, nie zwingend„ nicht besteht.

Vier Achsen und ein Thema. Die Achsen sind voneinander unabhängig: Jede Kombination ist gültig, und keine davon kostet eigene Komponentenregeln — eine Achse ist eine Umbelegung von Gestaltungswerten.

Alle vier werden als template ausgeliefert, und template ist keine Erscheinung. Es bedeutet „was immer die aktive Vorlage für diese Achse anbietet“ — und die eigene Palette des Plugins, wenn sie nichts anbietet oder gar keine Vorlage etwas anzubieten hat. Eine Vorlage ist das, was Aussehen liefert; gibt sie ihre Palette an dieses Plugin ab, muss sie sagen können, welche Haut und welches Schema an ihre Stelle treten.

Einen echten Wert einzutragen nimmt der Vorlage die Achse dauerhaft ab:

Die mittlere Zeile ist der Grund, warum template ein eigenes Wort ist und nicht schlicht „nicht konfiguriert„ heißt: Mit nur zwei Zuständen wären default und „nichts eingetragen“ dieselbe Zeichenkette, und ein Betreiber, der unter einer beitragenden Vorlage die Palette des Plugins will, hätte keinen Weg, danach zu fragen.

template ist bewusst kein Achsenwert. Es würde sonst aus ?skin=template und aus dem <theme>-Tag einer Seite angenommen, wo es nichts benennt, was sich zeichnen ließe.

Wie eine Vorlage antwortet: Sie liefert inc/wk-axes.php mit einer Funktion <verzeichnisname>_wk_axis_defaults(), die Achse ⇒ Wert zurückgibt. Das Plugin bindet diese Datei selbst ein, über einen Pfad aus dem Namen der aktiven Vorlage. Eine Vorlage ohne diese Datei ist der Normalfall und trägt nichts bei.

Typ Auswahl · Werte template, default, wxi, bizway · Vorgabe template

Die wikiweite Vorgabe-Haut. Eine Haut nennt den neutralen Charakter der Oberfläche – warmes Elfenbeinpapier oder kühles Bürograu – und zwar je Helligkeitswelt. Sie nennt weder den Akzent (eigene Achse) noch die Statusfarben oder die Kopfleiste (die gehören der Helligkeitswelt) und niemals ein Maß.

bizway ist die neutrale Familie der Hausvorlage, am 9. August 2026 hier aufgenommen: Sie steht damit als Achsenwert zur Verfügung, statt nur als Übersteuerung auf der Wurzel, durch die keine Haut hindurchzusehen ist. Der Name ist der der Vorlage, aber keine Abhängigkeit von ihr — die Rampe steht für sich und zeichnet auch ohne installierte Vorlage.

wxi-darkness und wxi-clearness sind am 9. August 2026 entfallen: die erste war eine Helligkeitswelt mit Hautnamen und ist jetzt wxi unter dem Schema dark, die zweite nach dem Umzug des Akzents nicht mehr von wxi zu unterscheiden. Gespeicherte Werte werden übersetzt, nicht verworfen, und wxi-darkness nimmt sein Dunkelschema mit.

default ist kein Palettenname, sondern „die eigene Palette des Plugins„ — die Werte des Grundblocks. Die Haut ist eine reine Wiki-Einstellung: Ein Benutzer kann sie nicht für sich übersteuern.

Typ Auswahl · Werte template, default, atlantic, riviera, graphit · Vorgabe template

Die Betonungsfarbe innerhalb der gewählten Haut.

Die drei Familien haben am 5. August 2026 vier Farbnamen ersetzt. Ein Farbname konnte immer nur in einem Schema stimmen: „blau“ hatte einen Hexwert, und der war entweder auf Papier oder auf Beinahe-Schwarz ein lesbarer Verweis, nie auf beidem. Eine Familie nennt einen Farbton, und das Schema bewegt ihn.

default heißt „der Akzent, den die Haut selbst mitbringt„. Deshalb ist es kein Farbname: Wäre hier eine Farbe eingetragen, ließe sich „der Akzent der Haut“ gar nicht mehr ausdrücken. Wie die Haut ist auch der Akzent nicht je Benutzer übersteuerbar.

Typ Auswahl · Werte template, auto, light, heritage, dark · Vorgabe template

Die Helligkeitswelt. Die eigene Wahl eines Benutzers sticht diese Vorgabe.

heritage ist keine Helligkeit zwischen hell und dunkel: Für den Browser ist es eine helle Welt, und das Stilblatt sagt das mit color-scheme. Ein Schema ist es deshalb, weil es Flächen und Schrift umbelegt — das Material der Seite — und sonst nichts.

auto bedeutet „nichts sagen„: Es wird kein Attribut gesetzt, und die Systemeinstellung des Lesers entscheidet. Das ist die einzige ehrliche Antwort, die ein Server auf eine Frage geben kann, deren Antwort er nicht sieht.

Umgekehrt heißt das: Ein benanntes Schema schaltet die Systemeinstellung ab. Die Medienabfrage des Stilblatts greift auf :root:not([data-wk-scheme]) — Gewichtung (0,2,0) und damit stärker als die Wurzel einer Vorlage bei (0,1,0). Am 9. August 2026 auf einer Wiki-Seite mit erzwungener Dunkellesart gemessen: Der Grund blieb weiß, während die Schrift auf rgb(243,242,241) ging — 1,12:1, wo WCAG 2.2 Erfolgskriterium 1.4.3 4,5:1 verlangt; die Lesematte erreichte 1,08:1 und der Kopfstreifen 1,03:1. Ein Leser mit dunkel eingestelltem Betriebssystem bekam das auf jeder Seite, ohne etwas gewählt zu haben.

Typ Auswahl · Werte template, normal, compact · Vorgabe template

Die Dichte der Bedienelemente. Die eigene Wahl eines Benutzers sticht diese Vorgabe.

normal ist die Dichte, die das Stilblatt ohne Attribut zeichnet; ein Stempel darauf würde Auszeichnung erzeugen, die nichts ändert.

Typ Zeichenkette · Vorgabe leer

Name eines im Theme Builder gebauten Themas, das wikiweit angewendet wird. Leer bedeutet die Vorgabewerte des Plugins — das ist, was eine unangetastete Installation zeigt.

Das Feld ist bewusst eine freie Zeichenkette und keine Auswahlliste: Der Konfigurationsmanager baut seine Auswahlmöglichkeiten zum Zeitpunkt der Deklaration, und zu diesem Zeitpunkt ist die Themenliste ein Verzeichnisinhalt, den noch niemand entschieden hat. Der Theme-Builder-Bildschirm bietet die echte Auswahl an; dieses Feld ist der Weg von Hand zum selben Wert.

Ein Name, den es nicht mehr gibt, wird wie leer behandelt, nicht als Fehler: Ein Thema zu löschen darf nicht jede Seite des Wikis zerstören können.

Typ Schalter · Vorgabe ein

Ob die eigenen Bildschirme dieser Suite die Formulare des DokuWiki-Kerns für Anmeldung, Registrierung und Kennwort-Wiederherstellung ersetzen.

Dies ist eine Site-Einstellung und ausdrücklich keine je Benutzer — und darin liegt der ganze Unterschied zur Werkbank, deren Oberflächenmodus je Benutzer gemerkt wird. Ein Besucher vor einem Anmeldebildschirm ist per Definition noch niemand, an den sich dieses Wiki erinnern könnte.

Aus bedeutet: exakt die Formulare des Kerns. Die Verarbeitung der Anfrage übernimmt ohnehin in beiden Fällen der Kern — die Einstellung entscheidet über die Darstellung, nicht über die Anmeldelogik.

Typ Medien-ID · Vorgabe leer

Produktmarke im Kopfband der Anmeldekarte.

Leer heißt nicht „keine Marke“. Es werden vier Kandidaten in dieser Reihenfolge geprüft, und der erste vorhandene gewinnt:

1. der hier eingetragene Wert
2. wk:logo.png
3. wk:banner.png — dort liegt die Marke dieser Suite bereits
4. wiki:logo.png — DokuWikis eigene Konvention

Erst wenn keiner davon existiert, trägt das Band den Wiki-Titel als Schrift. Die beiden Hauskandidaten stehen absichtlich in der Kette: Eine Einstellung, die ausgefüllt sein muss, bevor das richtige Bild erscheint, ist eine Einstellung, die die meisten Installationen nie finden.

Angegeben wird eine Medien-ID, kein Pfad. Die Auflösung läuft über DokuWikis eigene Medienverwaltung, sodass eine ID, die es nicht gibt, zum nächsten Kandidaten weiterreicht, statt ein kaputtes Bild zu zeigen.

Typ Zeichenkette · Vorgabe The White Knight Labs

Herstellername unter der Karte. Leer blendet die Zeile vollständig aus, samt Marke und Verweis.

Typ Medien-ID · Vorgabe leer

Kleine Herstellermarke neben dem Namen.

Leer zeigt nicht den Namen allein, sondern die Hausmarke als eingebettete Vektorgrafik — dieselbe Zeichnung wie im Band darüber, in einer Größe, in der ein Name danebensteht. Sie kostet keine zusätzliche Anfrage. Ein eingetragenes Bild gewinnt: Eine Installation, die nicht unsere ist, hat einen eigenen Hersteller und muss das sagen können. Eine ID ohne zugehörige Datei fällt ebenfalls auf die eingebettete Marke zurück.

Typ URL · Vorgabe leer

Ziel, auf das der Herstellername verweist. Leer stellt den Namen als reinen Text dar, ohne Verweis.

Nicht jede Einstellung dieses Pakets lässt sich von einem Benutzer übersteuern, und der Unterschied ist keine Willkür: Übersteuerbar ist, was Lesekomfort ist; wikiweit bleibt, was Erscheinungsbild ist.

Das Angebot der Vorlage steht ganz unten: Anfrageparameter, gemerkte Wahl des Lesers, Namensraum-Eintrag, <theme>-Tag der Seite und jede Einstellung, die einen echten Wert nennt, sticht es. Es füllt eine Lücke und übergeht nie eine Entscheidung.

Die eigene Wahl eines nicht angemeldeten Lesers wird über den Voreinstellungs-Keks geführt; der Server sieht sie beim Rendern und stempelt sie sofort mit. Deshalb blitzt beim Laden nie kurz die falsche Darstellung auf.

Drei Einstellungen behandeln einen unbrauchbaren Wert bewusst wie einen leeren, statt einen Fehler zu erzeugen. Das ist eine getroffene Entscheidung und keine Nachlässigkeit — aber es heißt auch, dass ein Tippfehler still bleibt:

Die vier Auswahlfelder (default_skin, default_accent, default_scheme, default_density) können einen ungültigen Wert gar nicht erst annehmen — der Konfigurationsmanager bietet nur den Wertevorrat an. Der Code prüft trotzdem erneut, weil eine Einstellung nicht der einzige Weg ist, auf dem ein Wert ankommt.

Für eine Vorlage, die ein Angebot macht, gilt dasselbe in schärferer Form: Ein Angebot mit unbekannter Achse oder unbekanntem Wert wird verworfen, und eine Vorlage, deren Angebot eine Ausnahme wirft, kostet ihr Angebot und sonst nichts. Der Fehler wird protokolliert, nicht angezeigt — eine kaputte Vorlagendatei darf keinen Aufrufabzug auf jede Seite setzen und darf auch nicht aussehen wie eine Vorlage, die schlicht nichts zu sagen hatte.

• Übersicht des Pakets — Rolle, Bereiche, Weiterleitungen im Zusammenhang
• Gestaltungswerte — was eine Haut, ein Akzent und ein Schema tatsächlich umbelegen
• Aufbau der Verwaltungsbildschirme — wo die Registerkartenleiste sitzt, die workspace_tabs_max begrenzt
• Einstieg — der kürzeste Weg zu einem eigenen Bildschirm