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

icon.ini [IconSettings]

The settings of [IconSettings] in icon.ini: Repository, Theme, StandardTheme, DesignTheme, Size

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/ini-settings/icon/IconSettings.md

On this page

icon.ini [IconSettings]

The block [IconSettings] of settings/icon.ini, with 5 setting(s).

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

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

Repository

Where to look for icons, relative to Exponential

Default: share/icons.

<?php /* #?ini charset="utf-8"?
# settings/override/icon.ini.append.php
[IconSettings]
Repository=share/icons
*/ ?>

Theme

Which theme to use as current for all icon types
If you wish to have a different theme per type you
can set this variable in the INI group for the type.

Default: crystal.

<?php /* #?ini charset="utf-8"?
# settings/override/icon.ini.append.php
[IconSettings]
Theme=crystal
*/ ?>

StandardTheme

The standard theme. It is used as fallback theme if an icon is not available in the current theme.

Default: crystal.

<?php /* #?ini charset="utf-8"?
# settings/override/icon.ini.append.php
[IconSettings]
StandardTheme=crystal
*/ ?>

DesignTheme

Additional themes to search before falling back to the standard theme.
AdditionalThemeList[]
The icon theme of a design. While the design is the siteaccess's SiteDesign (site.ini [DesignSettings]), its theme
replaces Theme, and Theme is searched right after it, so a key the design's theme does not map keeps the icon it
had. A type's own Theme ([ClassIcons] Theme etc.) still wins. An empty value turns it off for that design, an empty
DesignTheme[] for every design. A design of your own built on admin4 needs its own entry.

Default: a hash of 2: admin4=bootstrap-icons, admin4l=bootstrap-icons.

<?php /* #?ini charset="utf-8"?
# settings/override/icon.ini.append.php
[IconSettings]
# an empty "DesignTheme[]" first replaces the shipped list; without it the items are added
DesignTheme[]
DesignTheme[admin4]=bootstrap-icons
DesignTheme[admin4l]=bootstrap-icons
*/ ?>

Size

Wanted size of icons, the size is not checked and is expected
to be just a string which should be a directory in the theme

Default: normal.

<?php /* #?ini charset="utf-8"?
# settings/override/icon.ini.append.php
[IconSettings]
Size=normal
*/ ?>

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