[Intum Pomoc](https://intum.pl/pomoc.md) / [API](https://intum.pl/pomoc/toolkit/api.md)

# [Ustawienia Toolkit](https://intum.pl/pomoc/toolkit/api/toolkit-ustawienia.md)

Strona `/toolkit/ui/settings` (Toolkit → UI → Ustawienia) ma dwie części:

- **Twoje ustawienia** - każdy user zmienia je dla siebie (`target: "user_setting"`),
- **Ustawienia konta** - tylko z uprawnieniem do ustawień konta (`:account`): wartości domyślne
  paska górnego dla wszystkich - awatar w `target: "toolkit_setting"` (rekord `Toolkit::Setting`),
  pozostałe w `target: "organize_setting"`.

Obie części mają ten sam zestaw pól "Pasek górny".

| Klucz | Target | Typ | Domyślnie | Co robi |
|-------|--------|-----|-----------|---------|
| `toolkit.settings.navbar_avatar` | `user_setting` / `toolkit_setting` | boolean | `false` | Na komputerze: `true` - profil i wylogowanie w menu pod awatarem w prawym górnym rogu (tuż przed przyciskiem menu modułów), `false` - na dole panelu modułów (przycisk z czterema kwadratami). Nie zmienia przeglądarki na telefonie ani aplikacji mobilnej - tam menu osoby jest zawsze w menu modułów |
| `organize.navbar.changelog` | `user_setting` / `organize_setting` | boolean | `true` | Widget z nowościami i komunikatami w górnym pasku |
| `organize.workinfo.start_stop` | `user_setting` / `organize_setting` | boolean | `true` | Przycisk Play (Start/Stop rejestracji czasu pracy) w górnym pasku (przycisk na zadaniu to ustawienie konta `organize.workinfo.task_play`, zob. prompt `workinfo_api`). Ma sens tylko z modułem Organizacja i gdy konto używa czasu pracy (część modułu `organize.workinfo`, `/account/modules/organize`). Wartość konta (`organize_setting`) jest też w `/organize/settings`, sekcja Ustawienia WorkInfo. Wartość usera wygrywa z wartością konta; ukryty przycisk i tak pojawia się w trakcie pracy (np. Play na zadaniu) i znika po Stopie |
| `organize.navbar.search_expanded` | `user_setting` / `organize_setting` | boolean | `true` | Pole wyszukiwania w górnym pasku zawsze rozwinięte |

Każdy klucz czytany jest łańcuchem: ustawienie usera → ustawienie konta (`toolkit_setting` dla
awatara, `organize_setting` dla `organize.*`) → wartość domyślna z tabeli. Zmiana w ustawieniu
konta nie nadpisuje wyborów, które user zapisał sam.

## Odczyt

```
GET /toolkit/ui/settings.json
```

Wymaga `:account` (bez niego 403). Zwraca rekord `Toolkit::Setting`; wartości są
w `fields.toolkit.settings`. Brak klucza = wartość domyślna z tabeli.

## Zapis

Domyślna wartość paska górnego dla całego konta (wymaga `:account`):

```
POST /account/set_field.json
{"target": "toolkit_setting", "key": "toolkit.settings.navbar_avatar", "value": "true"}
```

```
POST /account/set_field.json
{"target": "organize_setting", "key": "organize.workinfo.start_stop", "value": "false"}
```

Własny wybór usera (dla zalogowanego, bez dodatkowych uprawnień):

```
POST /account/set_field.json
{"target": "user_setting", "key": "organize.navbar.search_expanded", "value": "true"}
```

```
POST /account/set_field.json
{"target": "user_setting", "key": "toolkit.settings.navbar_avatar", "value": "true", "skip_cleanup": "true"}
```

Przy `user_setting` wysyłaj `"skip_cleanup": "true"` - bez tego zapis wartości równej domyślnej
usuwa klucz i obowiązuje ustawienie konta, a nie wybór usera. Powrót do ustawienia konta:
`"value": "default"`.

Odpowiedź `{"status": "ok"}`. Ustawienie wartości domyślnej usuwa klucz z `fields` - to normalne,
odczyt i tak zwróci wartość domyślną.

## Formatki - pola obowiązkowe

Strona `/toolkit/ui/forms?form=organize_task` (Toolkit → UI → Formatki, tylko z `:account`)
- pola formatki, które trzeba wypełnić przy dodawaniu i edycji, dla całego konta. Na razie jest
jedna formatka: `organize_task` (zadanie). Klucze w `target: "toolkit_setting"`, boolean,
domyślnie `false`: `toolkit.form_organize_task.required_<pole>`, gdzie `<pole>` to jedno z:
`status_id`, `responsible_id`, `event_start`, `deadline`, `estimated_hours`, `team_id`,
`department_id`, `project_id`, `tasklist_ids`, `ticket_ids`, `client_id`, `deal_id`, `owner_id`,
`tag_names`. `ticket_ids` (powiązane zgłoszenia) działa tylko na koncie z modułem `helpdesk`,
a `team_id`, `project_id` i `tasklist_ids` - tylko z włączoną częścią modułu (`organize.teams`,
`organize.projects`, `organize.tasklists`). Bez nich pola nie ma w `fields` i wymóg nie obowiązuje.

```
GET /toolkit/ui/forms.json?form=organize_task
# {"form": "organize_task", "fields": [{"code": "responsible_id", "required": true}, ...]}
```

```
POST /account/set_field.json
{"target": "toolkit_setting", "key": "toolkit.form_organize_task.required_project_id", "value": "true"}
```

Wymóg działa przy `POST /organize/tasks` i `PATCH /organize/tasks/:id` (formatka i API): brak
pola daje `422` z błędem przy tym polu. Zadania tworzone automatycznie (reguły automatyzacji,
zadania cykliczne) i szybkie akcje (zamknięcie, odłożenie, przeniesienie, odpięcie
od zgłoszenia) zapisują się bez wymogu.
Akcje masowe (`change_bulk_option`, `change_bulk_option_multiple`) sprawdzają tylko zmieniane pole:
nie wyczyszczą wymaganego (wartość `none` zostaje odrzucona), ale zmienią je na inną wartość.

## Powiadomienia

Przełączniki dzwonka są na `/toolkit/notifications/settings` (dawniej `/toolkit/notifications`
i `/account/menu?type=notification`) - po API opisuje je prompt `notification_settings_api`.
Lista powiadomień to `/toolkit/notifications` (dawniej `/account/notifications` - stary adres HTML
przekierowuje); po API lista jest pod `GET /account/notifications.json` albo
`GET /toolkit/notifications.json` (ta sama odpowiedź). Lista zwraca powiadomienia zalogowanego
użytkownika; `?all=1` (wszystkie na koncie) działa tylko dla administratora konta (uprawnienie
Konto) - innym zwraca nadal tylko ich własne. Cudze powiadomienie po id (`GET`/`DELETE
/account/notifications/:id`) też widzi i usuwa tylko administrator konta, reszta dostaje 404.