5732fc0c2e
* website/docs: prepare 2023.3 release notes Signed-off-by: Jens Langhammer <jens@goauthentik.io> * Apply suggestions from code review Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com> Signed-off-by: Jens L. <jens@beryju.org> * add better docs for custom css Signed-off-by: Jens Langhammer <jens@goauthentik.io> --------- Signed-off-by: Jens Langhammer <jens@goauthentik.io> Signed-off-by: Jens L. <jens@beryju.org> Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com>
65 lines
1.8 KiB
Plaintext
65 lines
1.8 KiB
Plaintext
# Customization
|
|
|
|
The user interface can be customized through attributes, and will be inherited from a users' groups.
|
|
|
|
## Enabling/disabling features
|
|
|
|
The following features can be enabled/disabled. By default, all of them are enabled:
|
|
|
|
- `settings.enabledFeatures.apiDrawer`
|
|
|
|
API Request drawer in navbar
|
|
|
|
- `settings.enabledFeatures.notificationDrawer`
|
|
|
|
Notification drawer in navbar
|
|
|
|
- `settings.enabledFeatures.settings`
|
|
|
|
Settings link in navbar
|
|
|
|
- `settings.enabledFeatures.applicationEdit`
|
|
|
|
Application edit in library (only shown when user is superuser)
|
|
|
|
- `settings.enabledFeatures.search`
|
|
|
|
Search bar
|
|
|
|
## Other configuration
|
|
|
|
### `settings.navbar.userDisplay`
|
|
|
|
Configure what is shown in the top right corner. Defaults to `username`. Choices: `username`, `name`, `email`
|
|
|
|
### `settings.theme.base`
|
|
|
|
Configure the base color scheme. Defaults to `automatic`, which switches between dark and light mode based on the users' browsers' preference. Choices: `automatic`, `dark`, `light`.
|
|
|
|
### `settings.theme.background`
|
|
|
|
Optional CSS which is applied in the background of the background of the user interface; for example
|
|
|
|
```yaml
|
|
settings:
|
|
theme:
|
|
background: >
|
|
background: url('https://picsum.photos/1920/1080');
|
|
filter: blur(8px);
|
|
background-position: center;
|
|
background-repeat: no-repeat;
|
|
background-size: cover;
|
|
```
|
|
|
|
### `settings.layout.type`
|
|
|
|
Which layout to use for the Library view. Defaults to `row`. Choices: `row`, `2-column`, `3-column`
|
|
|
|
### `settings.locale`
|
|
|
|
The locale which can be configured in the user settings by default. This can be used to preset locales for groups of users, but still let them choose their own preferred locale
|
|
|
|
import Global from "../_global/global.mdx";
|
|
|
|
<Global />
|