> ## 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.
# Produkty
> Dodawaj i zarządzaj produktami w swoim sklepie: rangi, itemy i waluta w grze.
Produkty to serce Twojego sklepu. To właśnie tutaj dodajesz wszystko, co gracze mogą u Ciebie kupić: rangi, itemy, klucze do skrzynek czy walutę w grze. Na tej stronie pokażemy Ci, jak zarządzać listą produktów oraz jak dodać i skonfigurować nowy produkt krok po kroku — pole po polu.
## Lista produktów
Twoje produkty wyświetlają się jako **lista kart**. Każdy wiersz to jeden produkt, na którym widzisz od razu najważniejsze informacje:
* **Miniaturkę** — pierwsze zdjęcie produktu (jeśli go dodałeś). Gdy nie ma zdjęcia, pokazuje się ikona paczki.
* **Nazwę** produktu.
* **Cenę** oraz **nazwę serwera**, do którego produkt jest przypisany.
* Plakietkę **Wyróżniony** — jeśli zaznaczyłeś, że produkt ma się wyróżniać w sklepie.
* **Status** — `Aktywny` (zielony) albo `Wyłączony` (szary).
* Przyciski **Edytuj** (ołówek) i **Usuń** (kosz) po prawej stronie.
Kolejność wierszy na liście to dokładnie ta sama kolejność, w jakiej produkty pojawią się w sklepie. Chwyć **uchwyt** (symbol ⠿) i **przeciągnij wiersz** w górę lub w dół, aby zmienić, co gracze zobaczą jako pierwsze. Najpopularniejsze produkty warto ustawić na początku. Nowa kolejność zapisuje się automatycznie.
Przy pozycji **Produkty** w menu bocznym widzisz mały licznik z liczbą wszystkich Twoich produktów. To szybki sposób, by sprawdzić, ile pozycji masz już w sklepie.
### Edytowanie i usuwanie
Każdy produkt możesz w każdej chwili zmienić lub skasować:
Kliknij ikonę ołówka, aby otworzyć formularz z aktualnymi ustawieniami produktu i wprowadzić zmiany.
Kliknij ikonę kosza. Pojawi się pytanie z potwierdzeniem — produkt zostanie skasowany dopiero po kliknięciu **Usuń**. Tej operacji nie da się cofnąć.
Jeśli pracujesz w zespole, przyciski edycji i usuwania zobaczą tylko osoby, którym przydzielono odpowiednie uprawnienia. Współpracownik bez uprawnień zobaczy listę, ale nie zmieni ani nie skasuje produktów.
### Gdy nie masz jeszcze produktów
Jeśli lista jest pusta, zobaczysz komunikat zachęcający do dodania pierwszego produktu. To normalne na początku — wystarczy kliknąć przycisk dodawania i przejść przez formularz opisany niżej.
## Dodawanie nowego produktu
Aby utworzyć nowy produkt, kliknij przycisk dodawania nad listą.
Każdy produkt musi należeć do jakiegoś **serwera**. Jeśli nie dodałeś jeszcze żadnego serwera, zobaczysz prośbę „Najpierw dodaj serwer" — przejdź do sekcji **Serwery**, dodaj serwer i wróć tutaj.
### Krok 1: wybierz serwer
Na górze ekranu dodawania pojawia się **siatka kart serwerów**. Kliknij ten, do którego ma trafić nowy produkt — wybrana karta zostanie podświetlona i zaznaczona „ptaszkiem". Dopiero wtedy poniżej pokaże się formularz produktu.
Po wybraniu serwera jest on już „zablokowany" w formularzu, więc nie musisz wskazywać go po raz drugi. Dzięki temu produkt na pewno trafi do właściwego miejsca.
### Krok 2: wypełnij formularz
Formularz jest podzielony na czytelne sekcje. Omówmy je po kolei.
#### Sekcja „Podstawowe"
Podaj jasną, krótką nazwę, np. „Ranga VIP" albo „1000 monet". Nazwa to pierwsza rzecz, którą widzi gracz, więc niech od razu mówi, co kupuje. To pole jest **wymagane**.
Pokazuje się tylko, jeśli serwer nie został wcześniej wybrany. Wskazuje, na którym serwerze zostanie zrealizowany zakup.
Wpisz kwotę, którą gracz zapłaci przy zakupie. Możesz używać groszy, np. `9.99`. To pole jest **wymagane**. Jeśli korzystasz z wariantów (patrz niżej), to pole nosi nazwę **Cena bazowa** i pełni rolę ceny zapasowej.
Pole opcjonalne. Wpisz tu **starą, wyższą cenę**, jeśli chcesz pokazać, że produkt jest w promocji. W sklepie pojawi się ona przekreślona obok aktualnej ceny — to sprawdzony sposób, by zachęcić do zakupu.
Cenę „przed promocją" ustaw **wyżej** niż cenę zwykłą — inaczej przekreślenie nie ma sensu. Jeśli akurat nie prowadzisz promocji, zostaw to pole puste.
#### Sekcja „Sposób sprzedaży"
To ważna decyzja: wybierasz, **jak gracz kupuje** ten produkt. Masz do wyboru dwa kafelki — możesz włączyć tylko jeden:
Gracz sam **wybiera ilość** za pomocą suwaka — idealne dla waluty w grze (monety, punkty) albo kluczy do skrzynek. Obowiązuje jedna cena za sztukę. Możesz dorzucić **sugestie pakietów** z bonusami.
Gracz **wybiera jedną z gotowych opcji** (np. ranga na 30 albo 90 dni). Każdy wariant ma własną cenę i własne komendy. Idealne dla rang i zestawów w kilku odmianach.
Te dwa tryby się wzajemnie wykluczają. Gdy przełączysz produkt na **Warianty**, suwak ilości i sugestie pakietów przestają obowiązywać. Gdy wybierzesz **Ilość (suwak)**, warianty są pomijane.
**Gdy wybierzesz „Ilość (suwak)"**, pojawią się dodatkowe pola:
* **Min. ilość** — najmniejsza liczba, jaką gracz może kupić (domyślnie `1`).
* **Maks. ilość** — największa liczba w jednym zakupie (domyślnie `64`).
* **Krok** — o ile suwak zmienia ilość przy każdym ruchu (domyślnie `1`). Np. krok `10` pozwala kupować po 10, 20, 30 sztuk.
Pod tymi polami znajdziesz edytor **sugestii pakietów**, opisany w osobnej sekcji niżej.
#### Sekcja „Komendy realizacji"
To jedno z najważniejszych pól. Tutaj wpisujesz, co Twój serwer ma zrobić, gdy gracz opłaci zamówienie — np. nadać rangę, dodać monety albo wydać przedmiot. To pole jest **wymagane** (przynajmniej jedna komenda).
Zasady są proste:
* **Jedna komenda na linię.** Każdą kolejną akcję wpisz w nowym wierszu.
* Komendy wykonają się automatycznie na serwerze zaraz po opłaceniu zamówienia.
W komendach możesz użyć **zmiennych** (znaczników), które automatycznie zostaną zamienione na właściwe dane:
Nick gracza, który dokonał zakupu — dzięki temu komenda trafi do właściwej osoby.
Nazwa kupionego produktu — przydaje się np. w ogłoszeniach na czacie.
Liczba zakupionych sztuk — np. liczba monet albo kluczy do skrzynek.
Przykład wpisu z dwóch komend:
```
lp user {PLAYER} parent add vip
broadcast {PLAYER} kupił rangę!
```
**Zawsze ustaw i sprawdź komendy, zanim aktywujesz produkt.** Jeśli aktywujesz produkt bez poprawnych komend, gracz zapłaci, ale nic nie dostanie. To najczęstsza pomyłka u nowych właścicieli sklepów. Najlepiej zrób testowy zakup i sprawdź, czy przedmiot trafia do gry.
W trybie **Wariantów** komendy z tej sekcji są **komendami domyślnymi**. Każdy wariant może mieć dodatkowo własne komendy — wykonają się one zamiast domyślnych dla tego wariantu.
#### Sekcja „Opis i zdjęcia"
Jedno–dwa zdania widoczne na karcie produktu w sklepie. Powinno w skrócie mówić, co gracz dostaje.
Pełny opis widoczny po wejściu w produkt. Tutaj rozpisz szczegóły: co dokładnie zawiera oferta, na jak długo, jakie daje korzyści. Dobry opis tłumaczy wszystko, więc mniej osób rezygnuje z zakupu.
Adresy zdjęć produktu — **jeden adres URL na linię**. Pierwszy obraz z listy posłuży jako miniaturka na liście produktów i jako główne zdjęcie w sklepie. Pozostałe utworzą galerię.
Zdjęcia dodajesz, wklejając ich adresy internetowe. Najpierw umieść grafikę w sieci (np. na hostingu obrazków albo własnym serwerze), skopiuj jej adres i wklej go tutaj. Każdy adres w osobnej linii.
#### Sekcja „Tłumaczenia"
Ta sekcja pojawia się **tylko wtedy**, gdy Twój sklep obsługuje więcej niż jeden język (dodajesz je w ustawieniach sklepu). Pola podstawowe (nazwa, opisy) to wersja w języku domyślnym, a tutaj uzupełniasz ich odpowiedniki w pozostałych językach.
* Dla każdego dodatkowego języka masz osobny blok z polami **Nazwa**, **Krótki opis** i **Opis**.
* Pola, które zostawisz puste, automatycznie wyświetlą wersję domyślną — nie musisz tłumaczyć wszystkiego naraz.
Jeśli prowadzisz sklep dla graczy z kilku krajów, warto przetłumaczyć przynajmniej nazwę i krótki opis najpopularniejszych produktów. Reszta i tak pokaże wersję domyślną.
#### Sekcja „Warianty"
Pojawia się tylko w trybie **Warianty**. Warianty to opcje do wyboru — np. „VIP 30 dni" i „VIP 90 dni". Kupujący wybiera jeden z nich.
Każdy wariant ma:
* **Nazwę wariantu** (wymagana) — np. `VIP 30 dni`.
* **Cenę (PLN)** (wymagana) — własna cena tej opcji.
* **Komendy wariantu** — komendy wykonywane po zakupie tego konkretnego wariantu. Jeśli zostawisz je puste, zadziałają komendy domyślne z sekcji „Komendy realizacji".
* **Ceny per metoda** (opcjonalnie) — rozwijany panel, w którym możesz nadpisać cenę wariantu dla wybranej metody płatności (więcej niżej).
Przyciskiem **Dodaj wariant** tworzysz kolejne opcje, a koszem przy wierszu usuwasz niepotrzebne. Możesz mieć **do 20 wariantów** na jeden produkt.
W trybie wariantów musisz dodać **co najmniej jeden wariant z ceną**. Bez tego gracz nie miałby czego wybrać.
#### Sekcja „Metody płatności"
Tutaj decydujesz, **którymi metodami** można zapłacić za ten produkt i czy chcesz dla niektórych ustawić inną cenę.
* Każda metoda płatności skonfigurowana w sklepie ma tu swój przełącznik. Włącz te, które mają być dostępne dla tego produktu.
* Przy włączonej metodzie (w trybie suwaka) możesz wpisać **cenę dla tej metody**. Zostaw pole puste, aby użyć ceny standardowej — wpisz kwotę, aby ustawić stałą cenę właśnie dla tej metody płatności.
Jeśli nie masz jeszcze skonfigurowanych metod płatności, zobaczysz informację, by dodać je w zakładce **Operatorzy płatności**. W trybie wariantów ceny per metoda ustawiasz osobno przy każdym wariancie (w panelu „Ceny per metoda").
Ceny per metoda przydają się, gdy któryś operator płatności pobiera wyższą prowizję (np. SMS). Możesz wtedy ustawić dla tej metody nieco wyższą cenę, żeby pokryć koszt.
#### Sekcja „Zaawansowane"
Liczba decydująca o miejscu produktu na liście. W praktyce wygodniej jest po prostu **przeciągać** wiersze na liście produktów, ale jeśli wolisz, możesz tu wpisać konkretną wartość.
Przełącznik widoczności. Włączony = produkt jest w sklepie i można go kupić. Wyłączony = produkt jest ukryty (szkic).
Włącz, aby produkt dostał plakietkę **Wyróżniony** i był mocniej eksponowany w sklepie. Świetne dla bestsellerów lub nowości.
Na koniec kliknij **Dodaj produkt** (lub **Zapisz zmiany** przy edycji). Anulowanie zamyka formularz bez zapisywania.
## Sugestie pakietów (bonusy za większą ilość)
Sugestie pakietów dostępne są w trybie **Ilość (suwak)**. To gotowe kafelki z kwotami, które pojawiają się pod suwakiem w sklepie — i świetny sposób, by zachęcić graczy do większych zakupów.
Każdy pakiet ma dwa pola:
* **Ilość** — liczba sztuk w pakiecie (np. `50`).
* **Bonus (gratis)** — ile sztuk gracz dostaje dodatkowo za darmo (np. `5`).
Pakiety dodajesz przyciskiem **Dodaj pakiet**, a koszem usuwasz. Możesz mieć **do 12 pakietów**.
Przykład: gracz kupuje **1000 monet**, a Ty dorzucasz **+200 monet** w prezencie. Taka oferta wygląda atrakcyjnie i często podnosi wartość zamówienia. Bonusowe sztuki są dodawane automatycznie do tego, co gracz otrzymuje — nie musisz nic liczyć ręcznie.
## Status: aktywny czy szkic
Każdy produkt jest albo **aktywny**, albo zapisany jako **szkic** (przełącznik „Aktywny" w sekcji „Zaawansowane"). Na liście produktów rozpoznasz to po plakietce statusu:
Produkt jest zapisany, ale ukryty przed graczami — na liście oznaczony jako **Wyłączony**. Idealny, gdy dopiero przygotowujesz ofertę i nie chcesz jeszcze jej pokazywać.
Produkt jest widoczny w sklepie i można go kupić — na liście oznaczony jako **Aktywny**. Ustaw ten status dopiero wtedy, gdy wszystko jest gotowe i przetestowane.
## Najczęstsze pytania
Jeśli masz jeden serwer, i tak klikasz jego kartę na górze ekranu dodawania. To jedna chwila, a dzięki temu masz pewność, że produkt trafi we właściwe miejsce.
Suwak ilości to jeden produkt sprzedawany w dowolnej liczbie sztuk po stałej cenie (np. monety). Warianty to gotowe opcje do wyboru, każda z własną ceną i komendami (np. ranga na 30 albo 90 dni). Wybierz to, co lepiej pasuje do danego produktu.
Sprawdź, czy przełącznik **Aktywny** jest włączony. Produkt ze statusem **Wyłączony** jest ukryty przed graczami.
Tak — usunięcie produktu nie kasuje historii zamówień. Pamiętaj jednak, że operacji nie da się cofnąć, a produkt zniknie ze sklepu od razu.
Pokazuje ona graczom przekreśloną, wyższą cenę obok aktualnej — to wyraźny sygnał, że robią dobry interes. Ustaw ją wyżej niż cenę zwykłą albo zostaw pustą.
## Dobre praktyki
* **Jasne nazwy** — gracz powinien od razu wiedzieć, co kupuje. Unikaj skrótów i tajemniczych określeń.
* **Dobry opis** — napisz, co dokładnie gracz dostaje i na jak długo. Im mniej pytań, tym więcej zakupów.
* **Najpierw komendy, potem aktywacja** — zawsze ustaw i przetestuj komendy (testowy zakup!), zanim ustawisz produkt jako aktywny.
* **Wybierz właściwy sposób sprzedaży** — suwak dla waluty i kluczy, warianty dla rang i zestawów w kilku odmianach.
* **Dorzuć bonusy** — sugestie pakietów z gratisami realnie podnoszą wartość zamówień.
* **Wyróżnij bestsellery** — włącz „Wyróżniony" dla najlepszych ofert i przeciągnij je na początek listy.
* **Dbaj o zdjęcia** — produkt z dobrą grafiką wygląda poważniej i sprzedaje się lepiej.