[Sugester V2](https://pomoc.sugester2.pl.md) / [Baza Wiedzy](https://pomoc.sugester2.pl/baza-wiedzy-2.md)

# [Helplinki – kontekstowa pomoc przy polach formularzy](https://pomoc.sugester2.pl/helplinki-kontekstowa-pomoc-przy-polach-formularzy-Gv6DkGi6.md)

Helplinki to małe ikony **?** wyświetlane w różnych miejscach systemu — przy polach formularzy, obok przycisków, przy nagłówkach sekcji czy w ustawieniach. Po kliknięciu pojawia się dymek z krótkim objaśnieniem, a strzałka **›››** prowadzi do pełnego artykułu w Bazie Wiedzy.

Helplinki sprawdzają się wszędzie tam, gdzie użytkownik może potrzebować kontekstowej pomocy — wyjaśniają w kilku zdaniach co dane pole lub funkcja robi, bez konieczności opuszczania bieżącej strony.

![Helplink — przykład dymka z podpowiedzią](https://s3-eu-west-1.amazonaws.com/fs.siteor.com/sugester/files/images/pics-pl/helplink1.png)

## Ścieżka dostępu

**Baza Wiedzy → Helplinki**

## Jak to działa?

1. W różnych miejscach systemu widoczna jest ikona **?**
2. Kliknij ją — otworzy się dymek z krótkim objaśnieniem danego elementu
3. Kliknij strzałkę **›››** na dole dymka — przejdziesz do pełnego artykułu w Bazie Wiedzy, od razu do odpowiedniej sekcji

## Zarządzanie helplinkami

### Stany helplinków

Administratorzy widzą helplinki w trzech stanach:

- **Niebieski** — aktywny, z treścią. Widoczny dla wszystkich użytkowników.
- **Czerwony** — aktywny, ale bez treści. Do uzupełnienia.
- **Żółty** — nieaktywny. Ukryty dla zwykłych użytkowników.

Zwykli użytkownicy widzą tylko niebieskie helplinki.

### Automatyczne tworzenie

Helplinki są tworzone automatycznie (jako nieaktywne) przy pierwszym wyświetleniu strony z elementem helplinku. Nie musisz ich tworzyć ręcznie — system je wykryje, a administrator uzupełnia treść i aktywuje.

### Lista helplinków

W widoku **Baza Wiedzy → Helplinki** znajdziesz listę wszystkich helplinków. Każdy wyświetla:

- **Klucz** — unikalny identyfikator (np. `crm_client_name`)
- **Treść** — podgląd tekstu z dymku
- **Wpis** — powiązany artykuł w Bazie Wiedzy
- **Otwarcia** — ile razy użytkownicy wyświetlili dymek
- **Kliknięcia** — ile razy kliknęli strzałkę do pełnego artykułu

Statystyki pomagają ustalić, które helplinki uzupełniać w pierwszej kolejności — sortuj po liczbie otwarć.

## Edycja helplinka — opis pól

### Aktywny

Włącza lub wyłącza helplink. Tylko aktywne helplinki z treścią (niebieskie) są widoczne dla zwykłych użytkowników. Nieaktywne (żółte) widzi tylko administrator.

### Baza Wiedzy

Baza Wiedzy, do której należy helplink. Helplink wyświetla się tylko na stronach powiązanych z wybraną bazą.

### Wpis

Artykuł w Bazie Wiedzy, do którego prowadzi strzałka **›››** na dole dymka. Wybierz wpis najlepiej opisujący temat helplinka.

### Sekcja

Anchor (kotwica) do konkretnej sekcji w powiązanym wpisie. Dzięki temu strzałka **›››** przenosi użytkownika od razu do odpowiedniego miejsca w artykule, nie na jego początek. Sekcje odpowiadają nagłówkom (h2–h5) we wpisie.

### Klucz

Unikalny identyfikator helplinka (np. `crm_client_name`). Klucz łączy element w interfejsie (np. pole formularza) z tym helplinkiem. Klucze generowane są automatycznie w formacie `modul_obiekt_pole`.

### Treść

Tekst wyświetlany w dymku po kliknięciu ikony **?**. Powinien być zwięzły (1–3 zdania) i od razu odpowiadać na pytanie "co to pole robi?". Możesz używać podstawowego formatowania (pogrubienie, listy, linki, obrazki).

## Wielojęzyczne helplinki

Helplinki obsługują wielojęzyczność — jeśli baza wiedzy jest powiązana z bazami w innych językach (przez kod wielojęzyczności), system automatycznie wyświetla treść helplinków w języku interfejsu użytkownika.

- Użytkownik z interfejsem EN widzi angielskie dymki, z interfejsem PL — polskie
- Jeśli brakuje helplinku w danym języku, wyświetla się wersja z bazy głównej (fallback)
- Klucze helplinków muszą się zgadzać między bazami (np. `crm_client_name` w PL i EN)

Szczegóły konfiguracji: [Wielojęzyczne helplinki — pomoc kontekstowa w języku użytkownika](/kb/sugester-v2/wielojezyczne-helplinki-pomoc-kontekstowa-w-jezyku-uzytkownika)

## Wskazówki

- **Pisz zwięźle** — treść dymku powinna mieścić się w 1–3 zdaniach. Szczegóły zostaw w artykule Bazy Wiedzy.
- **Linkuj do sekcji** — używaj pola "Sekcja" z anchorem (np. `#nazwa-klienta`), aby strzałka ››› prowadziła do konkretnego miejsca w artykule.
- **Jeden wpis, wiele helplinków** — kilka helplinków może prowadzić do różnych sekcji tego samego artykułu (np. 30 helplinków CRM prowadzi do jednego wpisu o kartotece klienta).
- **Uzupełniaj najpopularniejsze** — helplinki z największą liczbą otwarć to te, gdzie użytkownicy najczęściej szukają pomocy.

---

*Starsza wersja tego artykułu (Sugester 1): [Helplinki — podpowiedzi/dymki pomocy wyświetlane na Twojej stronie](https://pomoc.sugester.pl/2376996-Helplinki-podpowiedzi-dymki-pomocy-wyswietlane-na-Twojej-stronie)*