Konfiguracja

Shiplume konfigurujesz na jednym ekranie: WooCommerce > Shiplume (uprawnienie manage_woocommerce). Wszystko trafia do jednej opcji, nudge_settings (tablica), nałożonej na domyślne wartości z paczki. Ekran ma trzy sekcje.

General

Enable Shiplume

Klucz opcji: enabled (domyślnie włączone). Główny przełącznik. Gdy jest wyłączony, pasek się nie renderuje i żadne style ani skrypty Shiplume nie trafiają na front: zasoby są rejestrowane tylko przy włączonym pasku i ładowane dopiero wtedy, gdy pasek ma się wyrenderować, więc strona bez paska zostaje czysta.

Cart page / Checkout page

Klucze opcji: show_on_cart, show_on_checkout (oba domyślnie włączone). Decydują, gdzie pasek się pokazuje: tylko w koszyku, tylko na kasie, w obu miejscach albo nigdzie. W klasycznym koszyku pasek jest nad sumami (woocommerce_before_cart_totals), na klasycznej kasie przed formularzem (woocommerce_before_checkout_form). Ta sama usługa renderuje też pasek w tabelach sum przez woocommerce_cart_totals_after_order_total i woocommerce_review_order_after_order_total. Wszystkie cztery to hooki klasycznych szablonów: bloki Koszyk i Zamówienie ich nie wywołują, więc na stronie koszyka lub kasy zbudowanej z bloku pasek się nie pokazuje. Ekran ustawień sygnalizuje to przy danym polu, gdy strona używa bloku.

Free-shipping threshold

Threshold source

Klucz opcji: threshold_source, auto (domyślnie) albo manual.

• Automatic, Shiplume przegląda każdą strefę wysyłki (także “Reszta świata”) w poszukiwaniu włączonej metody free_shipping z wymaganiem Minimalna kwota zamówienia albo w wariancie z kuponem (“lub kupon”, “i kupon”) i bierze najmniejszą znalezioną kwotę. Zmienisz regułę, pasek podąży za nią; nie ma kwoty do ręcznego synchronizowania. Metoda darmowej wysyłki wymagająca tylko kuponu nie podaje kwoty, do której można odliczać, i jest pomijana.
• Manual, Shiplume używa stałej kwoty poniżej i całkowicie pomija metody wysyłki.

Jeśli tryb automatyczny nie znajdzie kwalifikującej się metody, używa kwoty ręcznej, więc pasek działa, zanim skończysz konfigurować wysyłkę. Gdy ustalony próg wynosi zero lub mniej, nie ma celu do pokazania i pasek się ukrywa.

Manual amount

Klucz opcji: manual_threshold (domyślnie 50). W walucie sklepu, bez wysyłki i podatków. Używana w trybie ręcznym i jako zapas dla trybu automatycznego. Zapisana wartość przechodzi przez wc_format_decimal i jest przycinana do zera lub więcej.

Z progiem porównywana jest suma zawartości koszyka: same produkty, bez wysyłki, po odjęciu rabatów, czyli ta sama kwota, na podstawie której WooCommerce sprawdza minimalną kwotę zamówienia dla darmowej wysyłki. Procent na pasku śledzi więc dokładnie tę kwotę, którą klient musi osiągnąć na kasie.

Messages

Oba komunikaty to zwykły tekst, przy zapisie czyszczony przez sanitize_text_field (token {amount} zostaje). Puste pole oznacza domyślny tekst z paczki.

Progress message

Klucz opcji: message_progress (domyślnie Add {amount} more to get free shipping!). Pokazywany, dopóki koszyk jest poniżej celu. Wpisz {amount} tam, gdzie ma się pojawić brakująca kwota, sformatowana w walucie sklepu przez wc_price() (na przykład 12,00 zł). Podgląd pod polem pokazuje treść z przykładową kwotą.

Success message

Klucz opcji: message_success (domyślnie You have unlocked free shipping!). Pokazywany, gdy koszyk osiągnie lub przekroczy cel. Token {amount} jest podmieniany także tutaj, ale po osiągnięciu celu brakująca kwota wynosi zero, więc wyświetli się zero w walucie sklepu (na przykład 0,00 zł). Nie wstawiaj tokenu do komunikatu sukcesu, chyba że chcesz pokazać to zero.

Kolory i rozmiary

W panelu nie ma wyboru kolorów, podgląd pokazuje tylko tekst komunikatów. Kolory paska, wysokość toru, promień, odstęp i rozmiar czcionki to zmienne CSS --nudge-* na elemencie .nudge, więc wygląd zmieniasz w CSS motywu albo stylami inline, nie w ustawieniach. Pełna lista zmiennych jest w Korzystanie z paska, w sekcji “Własne kolory”. Pasek reaguje na tryb ciemny (prefers-color-scheme), a animacja wypełnienia respektuje prefers-reduced-motion.

Co jest stałe z założenia

Kilka zachowań celowo nie jest ustawieniami:

• Pasek sam się ukrywa, gdy funkcja jest wyłączona, koszyk jest pusty albo nie ma progu darmowej wysyłki; nigdy nie renderuje pustego ani zawsze pełnego paska.
• Znaczniki dostępności (role="progressbar", region komunikatu aria-live) są zawsze obecne i nie da się ich wyłączyć.

Dane i odinstalowanie

Shiplume zapisuje tylko dwie opcje, nudge_settings i nudge_db_version, i nie tworzy własnych tabel ani metadanych wpisów. Usunięcie wtyczki z ekranu Wtyczki uruchamia procedurę odinstalowania, która usuwa obie opcje.