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

site.ini [DesignSettings]

The settings of [DesignSettings] in site.ini: StandardDesign, SiteDesign, AdditionalSiteDesignList, SwitchableDesigns, SwitchableDesignLabel, SwitchableDesignChain, DesignSwitchCookie, DesignLocationCache

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/ini-settings/site/DesignSettings.md

On this page

site.ini [DesignSettings]

The block [DesignSettings] of settings/site.ini, with 8 setting(s).

Set access policy to allowed

Rules[]=access;enable

Special syntax which means any module

This means that for now all modules are enabled

Rules[]=moduleall

Set policy to denied

Rules[]=access;disable

If content/search module use current policy (denied)

Rules[]=module;content/search

If rss module use current policy (denied)

Rules[]=module;rss

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

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

StandardDesign

The standard design, is used as fallback design
if the element is not in the sitedesign

Default: standard.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
StandardDesign=standard
*/ ?>

SiteDesign

The design of the site

Default: admin.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
SiteDesign=admin
*/ ?>

AdditionalSiteDesignList

AdditionalSiteDesignArray contains an array
of sitedesigns. These sitedesigns will be used
if the design was not found in the main
sitedesign. StandardDesign is the fallback design.

Default: an empty list.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
# an empty "AdditionalSiteDesignList[]" first replaces the shipped list; without it the items are added
AdditionalSiteDesignList[]
*/ ?>

SwitchableDesigns

A front siteaccess can let every visitor switch between designs with one
click (doc/eng-us/features/6.0/front-design-switch.md). Off while the list is
empty; never on an administration siteaccess. The siteaccess's SiteDesign is
the default; a link with the view parameter /(design)/<name> chooses another
one and keeps it in a cookie. In the siteaccess's site.ini.append.php:
SwitchableDesigns[]
SwitchableDesigns[]=doc2025
SwitchableDesignLabel[doc]=Modern
SwitchableDesignLabel[doc2025]=Classic
SwitchableDesignChain[doc2025]=standard
SwitchableDesignChain[<design>] is the fallback chain of a design, designs
separated by ";" (without one the siteaccess's AdditionalSiteDesignList[]
stays). fetch( 'uiswitch', 'front_designs' ) gives templates the choices.

Default: an empty list.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
# an empty "SwitchableDesigns[]" first replaces the shipped list; without it the items are added
SwitchableDesigns[]
*/ ?>

SwitchableDesignLabel

Default: an empty list.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
# an empty "SwitchableDesignLabel[]" first replaces the shipped list; without it the items are added
SwitchableDesignLabel[]
*/ ?>

SwitchableDesignChain

Default: an empty list.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
# an empty "SwitchableDesignChain[]" first replaces the shipped list; without it the items are added
SwitchableDesignChain[]
*/ ?>

DesignSwitchCookie

The cookie that keeps the visitor's choice

Default: exp_design.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
DesignSwitchCookie=exp_design
*/ ?>

DesignLocationCache

Whether to cache location of design directories

Default: disabled.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[DesignSettings]
DesignLocationCache=disabled
*/ ?>

Generated by ./console exp:help:examples from settings/site.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