[SettingsViewSettings]
Available since Exponential 6.0.15 (in development, not in a release yet).
Summary
The group [SettingsViewSettings] of settings/site.ini.
File
settings/site.ini; override it in settings/override/site.ini.append.php, in a siteaccess or in an extension.
Settings
| Setting | Default | Description |
|---|---|---|
| CommonINIFileList[] | site.ini; content.ini; design.ini; override.ini; menu.ini; contentstructuremenu.ini; module.ini; template.ini; image.ini; admininterface.ini; browse.ini; workflow.ini; cronjob.ini; file.ini; i18n.ini | The ini files offered at the top of the drop-down on setup > view settings, above a separator, before the rest in alphabetical order. This installation has just over a hundred ini files, and hunting down one of the dozen that are actually read every day is the whole of the problem. The order is by how much each file is really used here, counted three ways: how many override files exist for it, how often the php reads it, and how often the templates read it. Anything listed that this installation does not have is passed over, so a shortened install shows a shorter list rather than dead entries. Add to it freely: this is a convenience, and nothing depends on it. |
| MaskedNameList[] | password; passwd; passphrase; secret; token; salt; credential; privatekey; apikey; Key; *Key; *_key; *_KEY; *-key; DSN; *Dsn; *DSN | Settings whose values the settings pages (settings/view, settings/edit) never show: only whether they are set or empty. A setting is a secret when its name matches an entry of MaskedNameList[] and none of UnmaskedNameList[], or when it is one exp:ini and the audit log mask (Password, Secret, Token, Salt, ...Key, Credential: these cannot be switched off here). An entry without '*' is found anywhere in the name, ignoring case ("password" matches TransportPassword); a capitalised single word ("Key", "DSN") must be the whole name; an entry with '*' is a pattern for the whole name and keeps case ("*Key" matches LicenseKey, not Monkey). A password inside any value (scheme://user:password@host, password=... in a connection string) is masked as well, and a secret's value is never searched. |
| UnmaskedNameList[] | SortKey; CacheKey; PrimaryKey; ForeignKey; IndexKey; ShortcutKey; HotKey; GroupKey; SectionKey; LanguageKey; IdKey | Names the entries above would match that are not secrets (whole names). |
| MaskRevealLastCharacters | 0 | Show the last characters of a secret (at most 4) so two values can be told apart, and only of a value at least four times that long. 0 shows none. |
| RestartSettingList[] | velocity.ini; site.ini/ExtensionSettings; site.ini/DatabaseSettings; site.ini/FileSettings/VarDir; file.ini/ClusteringSettings | Settings a running Velocity server reads only when it starts: after a change the settings page says to restart it (exp:velocity restart). A file, a file/block or a file/block/setting. Every other setting reaches PHP-FPM and Velocity on their next request, because a write clears the INI cache. |
See also
Generated example: site.ini [SettingsViewSettings]
Added to the reference for Exponential 6.0.15: the 4.x reference had no page for this group. The descriptions are the comment lines of settings/site.ini.
Contributors
- Graham Brookins Updated
Comments
Add a comment