Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,075 of 9,075 pages
About the help in other languages
All help pages

uiswitch.ini [UISwitch_design]

The settings of [UISwitch_design] in uiswitch.ini: Class, Enabled, AllowedValues, DesignChain, DesignLabel, RememberPreference

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/ini-settings/uiswitch/UISwitch_design.md

On this page

uiswitch.ini [UISwitch_design]

The block [UISwitch_design] of settings/uiswitch.ini, with 6 setting(s).

Never edit settings/uiswitch.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

  • settings/override/uiswitch.ini.append.php for every siteaccess,
  • settings/siteaccess/<siteaccess>/uiswitch.ini.append.php for one siteaccess,
  • extension/<extension>/settings/uiswitch.ini.append.php in an extension (read when the extension is active).

Class

The design of the administration interface: site.ini [DesignSettings] SiteDesign and
AdditionalSiteDesignList[] for this user's requests. Policy: uiswitch/design.

Default: expUISwitchDesignProvider.

<?php /* #?ini charset="utf-8"?
# settings/override/uiswitch.ini.append.php
[UISwitch_design]
Class=expUISwitchDesignProvider
*/ ?>

Enabled

Default: true.

<?php /* #?ini charset="utf-8"?
# settings/override/uiswitch.ini.append.php
[UISwitch_design]
Enabled=true
*/ ?>

AllowedValues

The designs a user may choose, in toolbar order. A design is offered only when it has a
DesignChain[] entry below and the design exists (design/<design>, or design/<design> of an active
design extension); the siteaccess's own SiteDesign is always offered and choosing it clears the
switch. adminui needs the exp_adminui extension active on the siteaccess (its design is then a
design extension), admin_classic the sevenx_themes_admin_classic extension. Every design offered
must render the right toolbar (toolbar/full/admin_ui_switch.tpl),
or a user who chose it cannot choose again. The current designs come first, the older ones
(AdminUI and the classic designs, labelled "(older)") last.

Default: a list of 6: admin4l, admin4, admin3, adminui, admin, admin_classic.

<?php /* #?ini charset="utf-8"?
# settings/override/uiswitch.ini.append.php
[UISwitch_design]
# an empty "AllowedValues[]" first replaces the shipped list; without it the items are added
AllowedValues[]
AllowedValues[]=admin4l
AllowedValues[]=admin4
AllowedValues[]=admin3
AllowedValues[]=adminui
AllowedValues[]=admin
AllowedValues[]=admin_classic
*/ ?>

DesignChain

The fallback designs each choice runs with (AdditionalSiteDesignList[]), separated by ";",
most specific first. Empty: the design and the standard design only.

Default: a hash of 6: admin4l=admin4;admin3;admin2;admin, admin4=admin3;admin2;admin, adminui=admin4l;admin4;admin3;admin2;admin, admin3=admin2;admin, admin=, admin_classic=admin.

<?php /* #?ini charset="utf-8"?
# settings/override/uiswitch.ini.append.php
[UISwitch_design]
# an empty "DesignChain[]" first replaces the shipped list; without it the items are added
DesignChain[]
DesignChain[admin4l]=admin4;admin3;admin2;admin
DesignChain[admin4]=admin3;admin2;admin
DesignChain[adminui]=admin4l;admin4;admin3;admin2;admin
DesignChain[admin3]=admin2;admin
DesignChain[admin]=
DesignChain[admin_classic]=admin
*/ ?>

DesignLabel

The names shown in the toolbar (translated in the context kernel/uiswitch).

Default: a hash of 6: admin4l=Admin 4 (layouts), admin4=Admin 4, adminui=AdminUI (older), admin3=Admin 3, admin=Classic (older), admin_classic=Classic, server-rendered (older).

<?php /* #?ini charset="utf-8"?
# settings/override/uiswitch.ini.append.php
[UISwitch_design]
# an empty "DesignLabel[]" first replaces the shipped list; without it the items are added
DesignLabel[]
DesignLabel[admin4l]=Admin 4 (layouts)
DesignLabel[admin4]=Admin 4
DesignLabel[adminui]=AdminUI (older)
DesignLabel[admin3]=Admin 3
DesignLabel[admin]=Classic (older)
DesignLabel[admin_classic]=Classic, server-rendered (older)
*/ ?>

RememberPreference

enabled: the choice is also kept in the user's preferences and comes back at the next sign-in.
disabled (default): it ends with the session, at logout.

Default: disabled.

<?php /* #?ini charset="utf-8"?
# settings/override/uiswitch.ini.append.php
[UISwitch_design]
RememberPreference=disabled
*/ ?>

Generated by ./console exp:help:examples from settings/uiswitch.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x