Ini settings in the administration
Setup > Ini settings (section System) shows and changes the settings of any siteaccess without a terminal. It
is the administration's counterpart of ./console exp:ini.
Contents
Pick a file
Choose the INI file and the Siteaccess, then Show settings. The address becomes
/settings/view/<siteaccess>/<file>, so the page can be bookmarked.
The page says how settings work: Every INI file is read in layers: settings/<file>.ini first, then the ActiveAccessExtensions, then the siteaccess (extensions first, settings/siteaccess last), then the ActiveExtensions, then settings/override. A later file wins: it replaces a plain value, and adds to an array unless it empties the array first. Secrets (passwords, keys, tokens) are never shown. So a setting in an active extension beats the same setting in settings/siteaccess/<siteaccess>; only settings/override beats the extension.
Read the layers
Each setting shows its value in effect and, under Set in N files, every file that sets it, in reading order. A file whose values are dropped is marked overridden, the one in effect elements in effect.
Badges: no default (the kernel's settings/<file>.ini does not set it), list of 6 (an array with six
elements). The page can also search a file, list the settings changed from the default and compare with another
siteaccess.
Edit a setting
Edit on a row opens /settings/edit/<siteaccess>/<file>/<Block>/<Setting>/<placement>: the chain again, then
New value with Type (Array, True/False, Enabled/Disabled, String, Numeric) and Value.
Arrays and the reset line
The page's own help: One element per line: =value adds an element, [key]=value sets a key. Leave the first line empty to empty the array before these elements; without it they are added to what the earlier files give.
Where the change is saved
Save it in offers:
| Choice | File |
|---|---|
| Siteaccess site only | settings/siteaccess/site/<file>.ini.append.php |
| Every siteaccess (global override) | settings/override/<file>.ini.append.php |
| In an extension | extension/<name>/settings/... |
Saving writes only that file, clears the INI caches and returns to the file's settings with a Saved: ... message. A value used in templates also needs Template & content cleared (Caches after a change).
Related pages
- Header menu in the administration
- exp:ini for site builders
- Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.
Become an Exponential Partner
Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.