[Intum](https://intum.pl/pomoc.md)

# [Helplinki - kontekstowa pomoc w Twojej aplikacji](https://intum.pl/pomoc/helplinki-kontekstowa-pomoc-w-twojej-aplikacji.md) | [API](#api)

Helplinki to kontekstowa pomoc w Twojej aplikacji: mała ikonka **?** obok pola czy przycisku, która po kliknięciu pokazuje dymek z podpowiedzią i linkiem do bazy wiedzy.

## Jak włączyć helplinki w aplikacji

1. Przejdź do **Baza wiedzy → Helplinki** i otwórz wybrany helplink.
2. Skopiuj **Skrypt wspólny** i wklej go raz, w layoucie swojej aplikacji (najlepiej przed `</body>`).
3. Skopiuj **Skrypt helplinka** i wklej go w kodzie HTML dokładnie tam, gdzie ma się pojawić ikonka pomocy:

```html
<span data-helplink="twoj-klucz"></span>
```

Ikonka sama dopasowuje kolor do tła (jasna na ciemnym menu, ciemna na jasnym).

## Ciemne dymki (dark theme)

Dymki mogą mieć ciemne tło i jasną czcionkę - np. w mobilnej wersji aplikacji.

**Dla wszystkich helplinków** - w skrypcie wspólnym dodaj wewnątrz `var HelplinksWidget` linię:

```js
tooltip_theme: "dark",
```

**Dla pojedynczego helplinka** - dodaj atrybut do tagu:

```html
<span data-helplink="twoj-klucz" data-helplink-tooltip="dark"></span>
```

## Własne kolory (zaawansowane)

Wygląd widgetu można dostroić w CSS swojej aplikacji przez zmienne:

```css
.moj-kontener {
  --intum-hl-color: #64748b;         /* kolor ikonki */
  --intum-hl-hover-color: #1d4ed8;   /* kolor ikonki po najechaniu */
  --intum-hl-tooltip-bg: #1f2937;    /* tło dymka */
  --intum-hl-tooltip-color: #f3f4f6; /* kolor tekstu w dymku */
}
```

## Wskazówki

- Treść helplinka z osadzonym filmem (iframe, np. YouTube) automatycznie dostaje szerszy dymek.
- Nieaktywne helplinki widzą tylko administratorzy (pomarańczowa ikonka) - mogą je od razu uzupełnić.

---

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