> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Panel sklepu — pierwsze kroki
> Poznaj panel sprzedawcy ItemShop.dev i załóż swój pierwszy sklep z przedmiotami.
Witaj w ItemShop.dev! To miejsce, w którym zakładasz własny sklep z przedmiotami dla swojego serwera Minecraft. Gracze wchodzą na Twoją stronę, kupują przedmioty lub rangi, a specjalny plugin automatycznie wydaje im zakupy w grze — wszystko dzieje się samo, bez Twojego udziału.
## Czym jest ItemShop.dev
Najprościej mówiąc, ItemShop.dev daje Ci trzy rzeczy:
Profesjonalna strona sklepu z koszykiem i płatnościami — bez znajomości programowania.
Gracz płaci, a przedmioty trafiają do niego w grze automatycznie, o każdej porze dnia i nocy.
Zarządzasz produktami, cenami, promocjami i wyglądem strony z jednego panelu.
## Jak utworzyć pierwszy sklep
Po pierwszym zalogowaniu poprowadzi Cię krótki kreator. Wystarczy kilka chwil, żeby Twój sklep był gotowy.
Wpisz nazwę swojego sklepu — najczęściej jest to nazwa Twojego serwera. Na jej podstawie automatycznie powstaje adres Twojej strony, więc wybieraj rozważnie.
Krótka, prosta nazwa łatwiej zapada w pamięć graczom i lepiej wygląda w adresie strony.
Zdecyduj, jak ma wyglądać Twoja strona. Wybierasz spośród gotowych szablonów — to tylko punkt startowy, bo wszystko możesz później dopasować w Edytorze strony.
Podaj dane serwera Minecraft, na którym mają być wydawane zakupy. Dzięki temu plugin wie, gdzie dostarczyć przedmioty kupione przez graczy.
Zaznacz, w jaki sposób gracze będą mogli płacić. Możesz to później rozszerzyć w sekcji Operatorzy płatności.
Stwórz swój pierwszy przedmiot na sprzedaż — np. rangę albo zestaw przedmiotów. Później dodasz ich więcej w sekcji Produkty.
Po zakończeniu kreatora zobaczysz „Gotowe!" oraz konfetti — to znak, że Twój sklep jest skonfigurowany i działa! 🎉 Wystarczy kliknąć **Przejdź do panelu**, by zacząć nim zarządzać.
Nie musisz wszystkiego dopracować od razu. Każdą z tych rzeczy — nazwę, wygląd, serwery, płatności i produkty — możesz spokojnie zmieniać i rozbudowywać później.
### Możesz pominąć każdy krok
Kreator nie zmusza Cię do niczego. Pod każdym krokiem (poza pierwszym) masz przyciski **Wstecz** oraz **Pomiń na razie**, a u góry pasek postępu pokazuje, na którym z czterech etapów jesteś. Jeśli coś już dodałeś, krok oznacza się jako gotowy — możesz wtedy od razu przejść **Dalej** albo **Dodać kolejny** (np. drugi serwer czy drugą metodę płatności).
Każdy element dodajesz **bez opuszczania kreatora** — formularz serwera, płatności czy produktu otwiera się od razu w oknie konfiguracji. Jeśli się rozmyślisz, klikasz **Wróć do kreatora** i wracasz tam, gdzie byłeś.
Jeśli chcesz później założyć **kolejny sklep**, ponownie uruchomisz ten sam kreator — Twoje obecne sklepy pozostaną nietknięte.
## Jak poruszać się po panelu
Po lewej stronie znajduje się pasek nawigacji podzielony na sekcje. Dzięki temu szybko trafisz tam, gdzie potrzebujesz.
* **Pulpit** — szybki przegląd najważniejszych informacji o sklepie
* **Produkty** — dodawanie i edycja przedmiotów na sprzedaż
* **Serwery** — serwery Minecraft, na które trafiają zakupy
* **Plugin** — konfiguracja dodatku wydającego przedmioty w grze
* **Edytor strony** — zmiana wyglądu i układu Twojej strony
* **Zamówienia** — lista i szczegóły wszystkich zakupów graczy
* **Analityka** — statystyki sprzedaży i ruchu na stronie
* **Operatorzy płatności** — metody płatności dostępne w sklepie
* **Kody rabatowe** — zniżki, które gracze wpisują przy zakupie
* **Vouchery** — kody do wykorzystania w sklepie
* **Ustawienia** — podstawowe dane i opcje sklepu
* **Zespół** — zapraszanie współpracowników do panelu
* **Blacklista** — blokowanie wybranych graczy lub adresów
* **Błędy** — podgląd ewentualnych problemów z płatnościami do naprawy
* **Klucze API** — połączenia z innymi narzędziami
Przy niektórych pozycjach w menu — **Produkty**, **Serwery** i **Zamówienia** — widzisz mały licznik z liczbą pozycji. To wygodny sposób, by jednym rzutem oka sprawdzić, ile masz produktów, serwerów albo zamówień, bez wchodzenia w daną sekcję.
Część sekcji może być niewidoczna dla niektórych członków zespołu — to zależy od uprawnień, jakie im nadasz. Jeśli pracujesz w pojedynkę jako właściciel, widzisz wszystko.
### Pasek u góry
Górny pasek towarzyszy Ci na każdej stronie panelu i daje szybki dostęp do najważniejszych rzeczy.
Po lewej stronie widzisz nazwę swojego sklepu i napis „Panel". To podpowiedź, w którym sklepie aktualnie pracujesz — przydatne, gdy masz ich kilka.
Na środku znajduje się pole **Szukaj stron, sklepów, akcji…**. Wpisz nazwę sekcji lub sklepu, a panel od razu Cię tam przeniesie. Możesz ją też otworzyć skrótem klawiszowym.
Na końcu paska jest Twoje imię i awatar. Po kliknięciu rozwija się menu z opcjami **Profil** oraz **Wyloguj**. Obok znajdziesz też przełącznik trybu jasnego i ciemnego.
Wyszukiwarka to najszybszy sposób na nawigację. Zamiast szukać sekcji wzrokiem, otwórz ją skrótem **`Ctrl` + `K`** (na komputerach Apple **`⌘` + `K`**), zacznij pisać i wybierz wynik. Działa też do przeskakiwania między różnymi sklepami.
### Asystent AI
W prawym dolnym rogu znajdziesz przycisk **Asystent AI**. To Twój pomocnik — możesz go zapytać o radę, poprosić o pomoc w ustawieniach albo o szybkie wyjaśnienie, jak coś zrobić. Asystent rozumie polecenia po polsku i potrafi też **wykonać akcję za Ciebie** lub przenieść Cię do właściwej sekcji.
Po otwarciu czatu, zanim cokolwiek napiszesz, zobaczysz **szybkie skróty** do najczęstszych miejsc, m.in.: Produkty, Nowy produkt, Serwery, Kody rabatowe, Zamówienia, Edytor strony, Płatności i Statystyki. Wystarczy kliknąć, by tam trafić.
Jeśli czegoś nie możesz znaleźć lub nie wiesz, jak zacząć, po prostu zapytaj Asystenta AI — odpowie po polsku i podpowie kolejny krok. Czat możesz w każdej chwili wyczyścić albo zamknąć.
## Pulpit — przegląd Twojego sklepu
**Pulpit** to pierwsza strona, którą widzisz po wejściu do panelu. Zbiera w jednym miejscu najważniejsze liczby o Twoim sklepie, dzięki czemu od razu wiesz, jak idzie sprzedaż — bez przeglądania zamówień jeden po drugim.
### Wybór okresu
W prawym górnym rogu Pulpitu znajduje się lista wyboru okresu. Wszystkie liczby i wykresy na tej stronie dotyczą właśnie tego zakresu czasu. Do wyboru masz:
Świeży obraz tego, co dzieje się w sklepie w bieżącym tygodniu.
Spojrzenie na cały miesiąc — dobre do oceny ogólnego tempa sprzedaży.
Szerszy widok kwartału, który pokazuje trendy i sezonowość.
Zmiana okresu od razu przelicza wszystkie kafelki i wykresy poniżej. Jeśli liczby wydają się niskie, sprawdź, czy nie masz ustawionego krótkiego okresu.
### Kafelki z liczbami
U góry Pulpitu znajduje się zestaw kafelków z najważniejszymi wskaźnikami. Każdy pokazuje jedną liczbę, a niektóre mają drobny wykres trendu w tle.
Łączna kwota ze sprzedaży w wybranym okresie. To pieniądze, które zarobił Twój sklep.
Liczba opłaconych zamówień w wybranym okresie.
Liczba różnych graczy, którzy coś u Ciebie kupili.
Średnia wartość jednego zamówienia — pomaga ocenić, ile przeciętnie wydaje gracz.
Ile razy ktoś wszedł na Twoją stronę sklepu w wybranym okresie.
Liczba różnych osób, które odwiedziły sklep (te same osoby liczone są raz).
Procent odwiedzających, którzy faktycznie dokonali zakupu. Im wyższy, tym lepiej działa Twój sklep.
Liczba graczy, którzy w wybranym okresie zostawili u Ciebie pieniądze.
Najważniejsza para liczb to **Wizyty** i **Konwersja**. Jeśli masz dużo wizyt, ale niską konwersję, to znak, że gracze wchodzą, ale coś ich zniechęca do zakupu — warto wtedy zajrzeć w wygląd strony, ceny albo metody płatności.
### Wykres przychodu w czasie
Pod kafelkami znajduje się wykres **Przychód w czasie**. Pokazuje, jak rozkładał się Twój przychód w wybranym okresie — dzień po dniu lub tydzień po tygodniu. Dzięki niemu od razu zauważysz wzrosty (np. po ogłoszeniu promocji) albo spadki, którym warto się przyjrzeć.
### Najlepsze produkty i Top wydający
Na dole Pulpitu są dwa zestawienia, które pomagają zrozumieć, co i kto napędza Twoją sprzedaż:
Lista produktów, które przyniosły najwięcej przychodu w wybranym okresie. Podpowiada, co warto eksponować w sklepie i na czym się skupić.
Lista graczy, którzy wydali u Ciebie najwięcej. To Twoi najbardziej lojalni klienci — warto o nich zadbać.
Jeśli w danym okresie nie było jeszcze sprzedaży, w tych miejscach zobaczysz komunikat **„Brak danych"**. To normalne na początku — liczby pojawią się, gdy gracze zaczną kupować.
Świeżo założony sklep ma puste statystyki — wszystkie kafelki pokazują zera, a wykres jest płaski. To nie błąd. Dane zaczną się pojawiać po pierwszych wizytach i zakupach. Jeśli mimo zamówień nadal widzisz zera, upewnij się, że wybrany okres obejmuje dni, w których była sprzedaż.
## Co dalej
Masz już sklep — teraz warto go dopieścić. Oto dobry kierunek na start:
Przejdź do sekcji **Produkty** i rozbuduj swoją ofertę o kolejne rangi i przedmioty.
Wejdź w **Edytor strony**, aby zmienić kolory, teksty i układ pod swój serwer.
W sekcji **Operatorzy płatności** upewnij się, że gracze mają wygodne metody zapłaty.
Stwórz **Kody rabatowe**, aby zachęcić graczy do pierwszych zakupów.
Zanim ogłosisz sklep graczom, zrób testowy zakup i sprawdź, czy przedmiot poprawnie trafia do gry. To najlepszy sposób, by mieć pewność, że wszystko działa.
## Częste pytania
Nie. Świeży sklep po prostu nie ma jeszcze danych. Kafelki pokazują zera, a wykres jest płaski, dopóki gracze nie zaczną odwiedzać strony i kupować. Sprawdź też, czy nie masz ustawionego krótkiego okresu (np. 7 dni) — wydłuż go, jeśli pierwsze zakupy były dawniej.
Skorzystaj z wyszukiwarki na górnym pasku (skrót **`Ctrl` + `K`** lub **`⌘` + `K`**), wpisz nazwę sekcji i wybierz wynik. Możesz też po prostu zapytać Asystenta AI w prawym dolnym rogu.
Nazwa aktualnego sklepu jest widoczna na górnym pasku. Aby przejść do innego, wpisz jego nazwę w wyszukiwarce — możesz w ten sposób błyskawicznie skakać między swoimi sklepami.
Pieniądze, które gracze płacą za zakupy, trafiają **bezpośrednio na Twoje konto u operatora płatności** (np. imoje, PayPal, Stripe) — ItemShop ich nie przechowuje ani nie wypłaca. W panelu widzisz **statystyki** sprzedaży (np. **Przychód** na Pulpicie i w Analityce), ale realne wypłaty rozliczasz po stronie operatora. Plany Premium to osobna sprawa — opłacasz je **jednorazowo** za wybrany okres bezpieczną płatnością obsługiwaną przez ItemShop, niezależnie od pieniędzy ze sprzedaży.
## Dobre praktyki
* **Zaczynaj od Pulpitu** — to najszybszy sposób, by sprawdzić kondycję sklepu bez zaglądania w setki zamówień.
* **Obserwuj konwersję, nie tylko przychód** — jeśli wizyt jest dużo, a sprzedaży mało, popraw wygląd strony, ceny lub metody płatności.
* **Korzystaj z wyszukiwarki** — `Ctrl` + `K` (lub `⌘` + `K`) to najszybsza nawigacja po panelu i przeskakiwanie między sklepami.
* **Zadbaj o Top wydających** — to Twoi najwierniejsi klienci; warto pomyśleć dla nich o promocji albo bonusie.
* **Nie panikuj przy zerach** — nowy sklep ma puste statystyki; liczby pojawią się wraz z pierwszymi wizytami i zakupami.
* **Pytaj Asystenta AI** — gdy czegoś nie wiesz lub nie możesz znaleźć, on podpowie kolejny krok po polsku.