[Intum](https://intum.fr/aide.md) / [Organizacja](https://intum.fr/aide/organizacja.md)

# [Kalendarze](https://intum.fr/aide/kalendarz/kalendarze.md) | [API](#api)

## Kalendarze

Moduł kalendarzy umożliwia zarządzanie wydarzeniami i organizację czasu. Możesz tworzyć wiele kalendarzy, przypisywać im kolory i przeglądać wydarzenia w różnych widokach.

## Widok miesięczny

Domyślny widok kalendarza pokazuje siatkę całego miesiąca. Na każdym dniu wyświetlane są wydarzenia - zarówno jednodniowe (jako kolorowe kropki z godziną), jak i wielodniowe (jako kolorowe paski rozciągające się przez kilka dni). Kliknięcie w dzień otwiera okno szybkiego tworzenia wydarzenia.

Jeśli w danym dniu jest więcej wydarzeń niż miejsce na siatce, wyświetlany jest link "+ więcej" z pełną listą.

## Widok tygodniowy

Widok tygodniowy pokazuje 7 dni z podziałem na godziny (od 00:00 do 23:00). Wydarzenia wyświetlane są jako kolorowe bloki o wysokości proporcjonalnej do czasu trwania. Gdy kilka wydarzeń nachodzi na siebie, są wyświetlane obok siebie w kolumnach.

Wydarzenia całodniowe i wielodniowe wyświetlane są jako paski nad siatką godzinową.

Strzałki pozwalają nawigować do poprzedniego lub następnego tygodnia. Przycisk **Dziś** wraca do bieżącego tygodnia.

## Tworzenie wydarzeń

Wydarzenia można tworzyć na dwa sposoby:

- **Szybkie tworzenie** - kliknij w dowolny dzień na kalendarzu. Otworzy się okno, w którym podajesz nazwę, datę, godzinę rozpoczęcia i zakończenia, kalendarz oraz kolor
- **Pełny formularz** - link "Nowe wydarzenie" otwiera pełny formularz z wszystkimi polami

Wydarzenia mogą być oznaczone jako **całodniowe** - wystarczy zaznaczyć checkbox "Cały dzień".

## Wydarzenia cykliczne

Wydarzenie może się powtarzać automatycznie. W formularzu wydarzenia zaznacz checkbox **Cykliczność** i wybierz typ:

- **Codziennie** - powtarza się każdego dnia
- **Co tydzień** - powtarza się w ten sam dzień tygodnia
- **Co miesiąc** - powtarza się w ten sam dzień miesiąca
- **Co rok** - powtarza się raz w roku

Opcjonalnie możesz ustawić **datę zakończenia** cykliczności. Bez daty wydarzenie powtarza się bez końca.

Cykliczne wydarzenie to jeden rekord w bazie - nie tworzy kopii. Na kalendarzu wyświetla się automatycznie na kolejnych datach. W szczegółach wydarzenia i w popoverze widać informację o typie cykliczności.

## Najbliższe wydarzenia

W panelu bocznym, po kliknięciu w "Wydarzenia", pojawia się link **Najbliższe wydarzenia**. Pokazuje listę nadchodzących wydarzeń (od dziś), posortowanych chronologicznie.

Cykliczne wydarzenia są rozwinięte - jeśli spotkanie powtarza się co tydzień, na liście zobaczysz osobne wpisy z kolejnymi datami.

Możesz wybrać ile wydarzeń chcesz zobaczyć (od 1 do 30).

## Wiele kalendarzy

Możesz tworzyć wiele kalendarzy, np. osobny dla spotkań, urlopów czy ważnych terminów. Każdy kalendarz ma własną nazwę i kolor. Po wybraniu konkretnego kalendarza widzisz tylko jego wydarzenia.

Lista kalendarzy dostępna jest w panelu bocznym.

## Przełączanie widoków

W nagłówku kalendarza znajduje się przełącznik umożliwiający zmianę między widokiem **Miesiąc** a **Tydzień**. Widoki dostępne są zarówno dla głównego dashboardu, jak i dla poszczególnych kalendarzy.

## Szczegóły wydarzenia

Kliknięcie w wydarzenie otwiera popover ze szczegółami: nazwą, godziną, kalendarzem, opisem i informacją o cykliczności. Z popovera można przejść do pełnego widoku lub edycji wydarzenia.

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**