Konfiguracja

Wszystkie ustawienia Tipping są na jednym ekranie, WooCommerce → Tipping. Kontrolka jest domyślnie dobrowolna i nic nie renderuje, dopóki jej nie włączysz i nie skonfigurujesz.

Włącz napiwki

Główny przełącznik. Gdy wyłączony, nic nie renderuje się na sklepie. Włącz go, by pokazać kontrolkę napiwku tam, gdzie ją umieścisz. Jeśli kontrolka jest włączona, ale źle skonfigurowana (np. brak presetów), łagodnie nic nie renderuje, zamiast pokazywać zepsuty widżet.

Typ presetu

Jak liczone są przyciski presetu:

• Stałe kwoty — każdy preset to stała wartość walutowa (np. 2, 5, 10 w walucie sklepu).
• Procent koszyka — każdy preset to procent zamówienia (np. 5%, 10%, 15%), liczony z podsumy koszyka.

Wartości presetu

Lista kwot do wyboru przez klienta, interpretowanych zgodnie z typem presetu. Trzymaj listę krótką — trzy lub cztery opcje najłatwiej przejrzeć.

Domyślny wybór

Która opcja jest zaznaczona, gdy kontrolka pojawia się po raz pierwszy. Zalecany domyślny to Bez napiwku, co utrzymuje pełną dobrowolność napiwku: klient nie płaci nic ekstra, dopóki aktywnie nie wybierze. Możesz ustawić preset jako domyślny, jeśli wolisz, ale niezerowy domyślny nie jest już ściśle dobrowolny.

Pozwól na własną kwotę

Dodaje pole, w którym klient wpisze własną wartość zamiast wybierać preset — przydatne dla hojnych klientów lub darowizn, gdzie mile widziana jest dowolna kwota.

Miejsce

Gdzie pojawia się kontrolka:

• Strona koszyka
• Strona zamówienia
• Oba

Strona zamówienia to najczęstsze miejsce, bo jest tuż przed płatnością. Pokazanie jej też w koszyku daje klientowi wcześniejszą okazję, by dodać napiwek.

Etykieta i opis

Treść, którą widzi klient — nagłówek i linia wyjaśnienia. Dopasuj do kontekstu: „Dodaj napiwek dla zespołu”, „Wesprzyj naszą pracę”, „Zaokrąglij na cel charytatywny”. Czytelna treść zamienia kontrolkę z tajemniczej opłaty w zachęcającą opcję.

Podatek od napiwku

Domyślnie wyłączony, bo większość napiwków i darowizn nie jest opodatkowana. Włącz tylko, jeśli prawo wymaga podatku od napiwków. Gdy włączony, opłata napiwku jest traktowana jako opodatkowana; gdy wyłączony, jest dodawana bez podatku.

Jak liczony i zapisywany jest napiwek

• Wybór kwoty przelicza sumy zamówienia przez AJAX zamówienia WooCommerce, więc klient zawsze widzi aktualną sumę przed płatnością.
• Preset procentowy liczony jest z podsumy koszyka w momencie wyboru i przeliczany przy każdej zmianie koszyka, więc zawsze odzwierciedla bieżące zamówienie.
• Napiwek jest dodawany jako natywna opłata koszyka WooCommerce, więc pojawia się w sumach zamówienia, e-mailach i raportach. Kwota jest też zapisywana jako metadana zamówienia do audytu.

Dostępność i porządek

Kontrolka jest przyjazna klawiaturze, ze stylami focus-visible, wystawia status ARIA live podczas aktualizacji sum i respektuje prefers-reduced-motion. Tipping jest zgodny z HPOS (Custom Order Tables) i blokami koszyka/zamówienia, gotowy do tłumaczenia (dołączony jest plik POT) i deinstaluje się czysto, bez własnych tabel w bazie.