tyler.durden/icingaweb2
1
0
Fork 0
mirror of https://github.com/Icinga/icingaweb2.git synced 2025-07-29 08:44:10 +02:00
Code Issues Packages Projects Releases Wiki Activity

User preferences: Doc fixes

Browse Source 
refs #4069
This commit is contained in:
Marius Hein 2013-08-05 10:57:51 +02:00
parent cc9b18376d
commit 944c9c13e9
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/preferences.md
View File

@ -3,7 +3,7 @@
Preferences are user based configuration for Icinga 2 Web. For example max page Preferences are user based configuration for Icinga 2 Web. For example max page
items, languages or date time settings can controlled by users. items, languages or date time settings can controlled by users.
# Architecture behind # Architecture
Preferences are initially loaded from a provider (ini files or database) and Preferences are initially loaded from a provider (ini files or database) and
stored into session at login time. After this step preferences are only stored into session at login time. After this step preferences are only
@ -11,13 +11,14 @@ persisted to the configured backend, but never reloaded from them.
# Configuration # Configuration
Preferences can be configured in config.ini in section, default settings are this: Preferences can be configured in config.ini in **preferences** section, default
settings are this:
[preferences] [preferences]
type=ini type=ini
The ini provider uses the directory **config/preferences** to create one ini The ini provider uses the directory **config/preferences** to create one ini
file per user and persists the data into this file. If your want to drop your file per user and persists the data into a single file. If your want to drop your
preferences just drop the file from disk and you'll start with a new profile. preferences just drop the file from disk and you'll start with a new profile.
## Database provider ## Database provider
@ -88,9 +89,11 @@ if you have gathered the user object:
$preferences->remove('test.pref3'); $preferences->remove('test.pref3');
$preferemces->commit(); // Stores 3 changes in one operation $preferemces->commit(); // Stores 3 changes in one operation
More information can be found in the api docs.
## Namespaces and behaviour ## Namespaces and behaviour
If you are using this API please obey following rules: If you are using this API please obey the following rules:
* Use dotted notation for preferences * Use dotted notation for preferences
* Namespaces starting with one context identifier * Namespaces starting with one context identifier