[Intum](https://intum.fr/aide.md) / [Baza Wiedzy](https://intum.fr/aide/baza-wiedzy.md)

# [Changelog](https://intum.fr/aide/baza-wiedzy/changelog.md) | [API](#api)

## Czym jest Changelog?

Changelog to widget powiadomień o zmianach w produkcie. Wyświetla się jako ikonka dzwonka na stronie — po kliknięciu pokazuje listę najnowszych wpisów z datą i statusem (nowość, poprawka, ulepszenie).

Klienci widzą ile nowych zmian pojawiło się od ich ostatniej wizyty dzięki licznikowi na ikonie.

## Jak uruchomić changelog?

1. Przejdź do **Baza wiedzy → Ustawienia → Changelog**
2. Utwórz kategorię, w której będą wpisy changelogu (np. "Changelog")
3. Skopiuj snippet kodu HTML
4. Wklej go na swoją stronę przed tagiem `</body>`

## Konfiguracja widgetu

Snippet HTML zawiera konfigurację:

- **`kb_token`** — token bazy wiedzy (automatycznie uzupełniony)
- **`category_id`** — ID kategorii z wpisami changelogu
- **`product`** — nazwa produktu (`intum` lub `sugester`)
- **`title`** — tytuł wyświetlany w nagłówku widgetu
- **`category_url`** — link do publicznej strony z pełną listą zmian
- **`category_label`** — tekst linku w stopce widgetu
- **`reload_cooldown`** — czas w sekundach między automatycznym odświeżaniem danych

## Jak to działa?

- Widget ładuje się z CDN i **nie wysyła żadnych requestów** do serwera, dopóki użytkownik go nie otworzy
- Po otwarciu pobiera wpisy z kategorii changelogu przez API
- Zapamiętuje w `localStorage` które wpisy użytkownik już widział
- Nowe (nieprzeczytane) wpisy są wyróżnione, a ich liczba wyświetla się na ikonie dzwonka
- Kliknięcie wpisu otwiera go w nowej karcie w bazie wiedzy

## Tworzenie wpisów changelogu

Wpisy changelogu to zwykłe wpisy w bazie wiedzy — tworzysz je w wybranej kategorii. Każdy wpis powinien mieć:

- **Tytuł** — krótki opis zmiany (np. "Nowy edytor Markdown")
- **Treść** — szczegóły zmiany
- **Status** — np. Nowość, Poprawka, Ulepszenie (wyświetlany jako kolorowa etykieta w widgecie)

## Personalizacja

Widget automatycznie dopasowuje się do kontekstu:

- Stopka może linkować do publicznej kategorii changelogu z pełną historią zmian
- Tytuł widgetu jest konfigurowalny
- Kolory statusów ustawiasz w bazie wiedzy przy konfiguracji statusów

---

## 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**