# Kreator widgetów

> Zrób własny widget do streama na Kick w HTML, CSS i JavaScript w kreatorze widgetów KickBot, przetestuj go na zdarzeniach testowych i opublikuj w bibliotece.

Source: https://kickbot.com/pl/docs/widgets/widget-builder

Kreator widgetów pozwala zrobić własną nakładkę na stream na Kick w HTML, CSS i JavaScript. KickBot przekazuje do Twojego kodu zdarzenia z Kick na żywo (nowi obserwujący, suby, podarowane suby, KICKi, raidy, wiadomości z czatu i więcej), więc nie musisz łączyć się z żadnym API. Widgetu możesz używać na własnym streamie albo go opublikować, żeby inni streamerzy mogli zainstalować go z biblioteki widgetów. Otwórz go na [kickbot.com/dashboard/widget-builder](https://kickbot.com/dashboard/widget-builder).

Kreator jest dla osób, które umieją trochę programować. Jeśli chcesz po prostu gotową nakładkę, skorzystaj z [biblioteki widgetów](https://kickbot.com/pl/docs/widgets/widget-library). Opis kodu (zdarzenia, dane i ustawienia) znajdziesz w artykule [Kreator widgetów: dokumentacja techniczna](https://kickbot.com/pl/docs/widgets/widget-builder-reference).

![Strona główna kreatora widgetów KickBot z przyciskiem Nowy widget, jednym widgetem z ukrytym URL i sekcją Dokumentacja](https://kickbot.com/docs/images/widgets/widget-builder/01-home.webp "Kreator widgetów pokazuje Twoje widgety i ich URL-e do OBS.")

## Zrób nowy widget

1. Otwórz [kickbot.com/dashboard/widget-builder](https://kickbot.com/dashboard/widget-builder) i kliknij **Nowy widget**.
2. Wybierz **Pusty** albo zacznij od szablonu: **Viewer Count**, **Simple Follower Goal** lub **Basic Chat Widget**. Szablon kopiuje kod tego widgetu KickBot, więc możesz go zmieniać.
3. Wpisz nazwę w polu **Nazwa widgetu**. Przy pustym widgecie ustaw też **Szerokość (px)** i **Wysokość (px)** (domyślnie 800 × 600).
4. Kliknij **Utwórz widget**. Otworzy się edytor.

![Okienko Nowy widget z opcją Pusty oraz szablonami Viewer Count i Simple Follower Goal](https://kickbot.com/docs/images/widgets/widget-builder/02-new-widget.webp "Zacznij od pustego widgetu albo od szablonu.")

> **Note:** W planie Darmowym możesz mieć w kreatorze do 10 widgetów. W Premium nie ma limitu. Widgety zainstalowane z biblioteki się nie liczą.

## Edytor

Edytor ma trzy części: ustawienia po lewej, kod na środku i podgląd na żywo po prawej.

![Edytor kreatora widgetów z Ustawieniami podstawowymi i Zmiennymi użytkownika po lewej, kartą z kodem HTML na środku i podglądem po prawej](https://kickbot.com/docs/images/widgets/widget-builder/03-editor.webp "Ustawienia, kod i podgląd w edytorze kreatora widgetów.")

- **Ustawienia podstawowe**: nazwa oraz szerokość i wysokość, w jakich widget jest wyświetlany.
- **Zmienne użytkownika**: ustawienia, które streamerzy mogą zmienić bez kodu, np. kolor, tekst albo liczba celu. Zobacz [Zmienne użytkownika](https://kickbot.com/pl/docs/widgets/widget-builder-reference#user-variables).
- **Wyślij zdarzenie testowe**: przyciski, które wysyłają do podglądu udawane zdarzenie (Sub, Sub w prezencie, KICKs, Follow, Raid, Wiadomość i inne).
- **Widoczność**: pokazuje, czy widget jest prywatny, czy opublikowany, i ma przycisk **Opublikuj widget**.
- **Kod**: karty **HTML**, **CSS** i **JavaScript**. W menu **Układ edytora** na górze wybierz jeden plik naraz (**Pojedynczy**) albo dwa pliki jednocześnie (**Obok siebie** lub **Jeden pod drugim**).
- **Podgląd**: pokazuje widget w jego rozmiarze, przeskalowany tak, żeby się zmieścił. Zmienia się na bieżąco, gdy piszesz. Przycisk odświeżania uruchamia go od nowa, a przycisk otwierania w nowym oknie pokazuje go osobno (przydatne, gdy chcesz otworzyć konsolę przeglądarki).

Edytor sam zapisuje Twoją pracę, gdy piszesz. **Zapisz** zapisuje wszystko naraz, a tekst pod przyciskiem pokazuje, kiedy był ostatni zapis. **Wyjdź** wraca do listy widgetów.

Edytor potrzebuje szerokiego ekranu. Na telefonie KickBot poprosi Cię o otwarcie go na komputerze. Twój widget jest zapisany, więc możesz tam kontynuować.

## Przetestuj widget

1. Otwórz **Wyślij zdarzenie testowe**.
2. Kliknij zdarzenie, np. **Follow** albo **Wiadomość**.
3. Zobacz, jak reaguje podgląd.

Zdarzenia testowe mają taki sam format jak prawdziwe, tylko z przykładowymi danymi. Trafiają wyłącznie do podglądu na tej stronie, nigdy do OBS ani na Twój stream. Żeby przetestować widget na prawdziwych zdarzeniach, dodaj go do OBS i rozpocznij stream albo poproś znajomego, żeby zaobserwował Twój kanał.

## Użyj widgetu na streamie

Każdy zrobiony przez Ciebie widget pojawia się też w [Zapisanych widgetach](https://kickbot.com/dashboard/saved-widgets) z napisem „Twój własny widget” pod nazwą. Jego URL zawsze uruchamia najnowszą wersję Twojego kodu.

1. Na stronie kreatora widgetów kliknij **Kopiuj URL** przy swoim widgecie.
2. W OBS dodaj źródło **Browser** (Przeglądarka), wklej URL i ustaw szerokość i wysokość na rozmiar widgetu.
3. Kliknij **OK**.

Jeśli zmienisz kod, gdy widget jest już w OBS, odśwież browser source, żeby wczytać nowy kod. Gdy zmienisz wartość zmiennej użytkownika w Zapisanych widgetach i klikniesz **Zapisz**, OBS sam przeładuje widget. Więcej pomocy znajdziesz w artykule [Dodaj nakładkę KickBot do OBS](https://kickbot.com/pl/docs/getting-started/add-browser-source-obs).

> **Caution:** Nie udostępniaj URL. Każdy, kto go ma, może wyświetlić Twój widget na swoim ekranie.

## Opublikuj w bibliotece widgetów

Opublikuj widget, gdy chcesz, żeby inni streamerzy mogli go znaleźć i zainstalować.

1. W edytorze otwórz **Widoczność** i kliknij **Opublikuj widget**.
2. Dodaj **Główny obrazek** i co najmniej jeden obraz więcej. Łącznie możesz dodać do 10 obrazów, każdy do 10 MB. Najlepiej sprawdza się 1920 × 1080.
3. Napisz **Opis**: co pokazuje widget i jak go skonfigurować.
4. Wyślij. Okienko pokaże **Widget opublikowany!**, ale widget najpierw trafia do weryfikacji.

Zespół KickBot sprawdza każdy widget. Po akceptacji widget pojawia się w bibliotece widgetów, a jako autor widnieje Twoja nazwa z Kick. Weryfikacja zwykle trwa krócej niż 24 godziny.

> **Caution:** Widget możesz opublikować tylko raz. Potem edytor pokazuje „Widget już opublikowany. Skontaktuj się z supportem, jeśli chcesz coś zmienić”. Dobrze przetestuj widget, zanim go opublikujesz.

## Usuń widget

Na stronie kreatora widgetów otwórz menu **⋯** przy widgecie i kliknij **Usuń**. To usuwa jego kod i ustawienia i nie da się tego cofnąć.

## Członkowie zespołu

Członkowie zespołu potrzebują uprawnienia **Kreator widgetów**, żeby otwierać edytor i tworzyć widgety. Żeby widzieć URL-e widgetów, potrzebują uprawnienia **Konfiguracja widgetów**. Zobacz [Zarządzanie zespołem](https://kickbot.com/pl/docs/account/team).

## Najczęstsze pytania

**Czy muszę umieć programować?**

Tak, trochę HTML, CSS i JavaScript. Jeśli nie programujesz, zainstaluj widget z [biblioteki widgetów](https://kickbot.com/pl/docs/widgets/widget-library) i po prostu zmień jego ustawienia.

**Czy mogę edytować widget KickBot z biblioteki?**

Nie możesz zmienić kodu widgetu z biblioteki. Zacznij nowy widget od szablonu **Viewer Count**, **Simple Follower Goal** albo **Basic Chat Widget**, a dostaniesz kopię jego kodu, którą możesz zmieniać.

**Czy mój widget może wczytywać czcionki, obrazy albo inne skrypty?**

Tak. Twój HTML, CSS i JavaScript działają w OBS jak zwykła strona internetowa, więc możesz podpiąć czcionki z sieci, obrazy i skrypty z innych stron. Użyj zmiennych użytkownika typu **Obraz/GIF**, **Wideo** albo **Audio**, żeby streamerzy mogli wgrywać własne pliki.

**Czy mogę tworzyć widgety przez API KickBot?**

Tak. API KickBot pozwala wyświetlać listę Twoich widgetów, tworzyć je i aktualizować. Zobacz [dokumentację API widgetów](https://kickbot.com/docs/api/reference/widgets).
