Konfiguracja

Wszystkie ustawienia Dankon są na jednym ekranie, WooCommerce > Dankon. 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 kontrolka napiwku pojawiła się na stronie zamówienia. 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ć.

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ę.

Co jest ustalone w kodzie

Kilku rzeczy nie ma i nie da się ich przestawić:

• Napiwek nigdy nie jest opodatkowany. Opłata jest zawsze dodawana jako nieopodatkowana, ustawienia podatku od napiwku nie ma.
• Domyślny wybór to zawsze “Bez napiwku”. Nie da się z góry zaznaczyć płatnego presetu, dzięki czemu napiwek pozostaje w pełni dobrowolny.
• Nie ma pola na własną kwotę. Klient wybiera spośród Twoich presetów albo nie daje napiwku.
• Kontrolka renderuje się tylko na klasycznej stronie zamówienia, na haku woocommerce_review_order_before_payment. Nie ma ustawienia miejsca, nie ma wersji dla koszyka i nie ma shortcode’u.

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. Dankon 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.