Opis
Shiplume pokazuje kupującym, jak daleko ich koszykowi do progu darmowej dostawy i ile jeszcze muszą dodać, żeby go osiągnąć. Komunikat zmienia się razem z koszykiem, więc „darmowa dostawa od 50 zł” przestaje być drobnym drukiem i staje się kwotą, na którą klient może zareagować.
Domyślnie próg pochodzi prosto z WooCommerce. Shiplume sprawdza włączone metody darmowej dostawy we wszystkich strefach wysyłki i bierze najniższą znalezioną minimalną kwotę zamówienia, więc nie musisz utrzymywać tej wartości w dwóch miejscach. Jeśli wolisz ustawić ją sam, przełącz na tryb ręczny i wpisz stałą kwotę; ta kwota służy też jako zapasowa, gdy tryb automatyczny nie znajdzie pasującej metody.
Gdy nie ma nic przydatnego do pokazania (pasek jest wyłączony, koszyk jest pusty albo nie ustawiono progu), Shiplume niczego nie wyświetla zamiast pustego lub zawsze ukończonego paska.
Dokumentacja i linki
- Dokumentacja: plogins.com/plogins-nudge/docs/
- Strona wtyczki: plogins.com/plogins-nudge/
- Kod źródłowy: github.com/wppoland/plogins-nudge
- Zgłoszenia błędów i propozycje funkcji: github.com/wppoland/plogins-nudge/issues
Co robi
- Automatycznie odczytuje próg darmowej dostawy z aktywnych metod darmowej dostawy WooCommerce albo przyjmuje stałą kwotę ustawioną ręcznie.
- Odświeża się razem z koszykiem na klasycznych stronach koszyka i zamówienia (zbudowanych na shortcode’ach
[woocommerce_cart]i[woocommerce_checkout]). Mały skrypt (bez własnego jQuery) animuje szerokość między aktualizacjami. - Udostępnia prawdziwą rolę
role="progressbar"zaria-valuenow/min/maxi czytelnym komunikatem tekstowym dla czytników ekranu; respektujeprefers-reduced-motion. - Rezerwuje wysokość paska przed renderowaniem, więc jego pojawienie się nie przesuwa układu strony.
- Styluje pasek własnościami CSS
--nudge-*i dopasowuje się do ciemnych schematów kolorów, więc motyw może zmienić jego kolory bez edycji znaczników. - Pozwala napisać własne komunikaty postępu i sukcesu, z tokenem
{amount}w każdym z nich w miejscu brakującej kwoty. - Zawiera plik POT, usuwa swoje opcje przy odinstalowaniu i deklaruje zgodność z HPOS.
Kod źródłowy i zgłoszenia błędów są na GitHubie: github.com/wppoland/plogins-nudge
Usługi zewnętrzne
Shiplume nie łączy się z żadną usługą zewnętrzną. Nie wysyła statystyk, nie rejestruje licencji, nie wczytuje zdalnych czcionek ani skryptów i nie wykonuje żadnych żądań HTTP poza Twój serwer. Wszystko, czego potrzebuje (próg darmowej dostawy i sumy koszyka), pochodzi z WooCommerce w tej samej witrynie, a arkusz stylów paska i mały skrypt animacji są serwowane z folderu wtyczki, nie z CDN. Jedyne dane, które Shiplume zapisuje, to dwie opcje WordPressa w Twojej bazie danych (nudge_settings z konfiguracją i nudge_db_version do aktualizacji); obie są usuwane, gdy usuniesz wtyczkę.
Tłumaczenia
Shiplume można w całości przetłumaczyć i zawiera szablon shiplume.pot. Tłumaczenia trafiają do witryn jako pakiety językowe WordPress.org z translate.wordpress.org i tam powstają wersje polska, niemiecka i hiszpańska; sama paczka nie zawiera skompilowanych plików tłumaczeń.
Zrzuty ekranu



Instalacja
- Wgraj wtyczkę do
/wp-content/plugins/shiplumealbo zainstaluj ją przez Wtyczki > Dodaj nową. - Włącz wtyczkę. WooCommerce musi być aktywne.
- Przejdź do WooCommerce > Shiplume, włącz pasek i wybierz, gdzie ma się wyświetlać.
Najczęściej zadawane pytania
-
Czy wymaga WooCommerce?
-
Tak. Shiplume nic nie robi, dopóki WooCommerce nie jest aktywne.
-
Skąd pochodzi kwota darmowej dostawy?
-
W trybie automatycznym Shiplume odczytuje minimalną kwotę zamówienia z włączonych metod darmowej dostawy WooCommerce i bierze najmniejszą z nich spośród wszystkich stref wysyłki. W trybie ręcznym sam ustalasz stałą kwotę. Jeśli tryb automatyczny nie znajdzie metody z minimalną kwotą zamówienia, używa kwoty ręcznej.
-
Co się wyświetla, gdy nie ustawiono progu darmowej dostawy?
-
Nic. Zamiast pustego albo zawsze pełnego paska Shiplume niczego nie wyświetla, dopóki nie ma prawdziwego progu, do którego można odliczać.
-
Czy działa z blokami koszyka i zamówienia?
-
Jeszcze nie. Pasek wyświetla się na klasycznych stronach koszyka i zamówienia, zbudowanych na shortcode’ach
[woocommerce_cart]i[woocommerce_checkout]. Działa bezpiecznie obok bloków i deklaruje zgodność z blokami koszyka i zamówienia, ale niczego w nich nie rysuje. Jeśli Twoje strony używają bloków, ekran ustawień Shiplume informuje o tym przy polach wyboru miejsca wyświetlania. -
Czy mogę zmienić treść komunikatów i kolory?
-
Tak. Komunikaty postępu i sukcesu można edytować na ekranie ustawień, a kolory i rozmiary paska to własności CSS
--nudge-*, które motyw może nadpisać. -
Czy wtyczka działa w WordPress Multisite?
-
Tak. Ta wtyczka jest zgodna z WordPress Multisite. Włącz ją dla całej sieci lub w pojedynczych witrynach; każda witryna zachowuje własne ustawienia i dane.
Recenzje
Wtyczka nie ma jeszcze żadnej recenzji.
Kontrybutorzy i deweloperzy
„Shiplume – pasek postępu wysyłki dla WooCommerce” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.
ZaangażowaniWtyczka „Shiplume – pasek postępu wysyłki dla WooCommerce” została przetłumaczona na 1 język. Podziękuj tłumaczom za ich wkład.
Przetłumacz wtyczkę “Shiplume – pasek postępu wysyłki dla WooCommerce” na swój język.
Interesuje cię rozwój wtyczki?
Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.
Rejestr zmian
1.1.6
- Poprawka: pasek pokazywał się dwa razy na klasycznym koszyku i stronie zamówienia, raz nad podsumowaniem i raz w nim. Na stronie zamówienia przy każdym odświeżeniu dochodziła kolejna kopia. Teraz na każdej stronie jest jeden pasek, a pasek na stronie zamówienia nadal się aktualizuje, gdy kupon zmienia sumę.
- Poprawka: klasa miejsca wyświetlania i atrybut data paska wypisywały „Array” zamiast cart lub checkout.
1.1.5
- Wyświetlana nazwa to teraz Shiplume – Shipping Progress Bar for WooCommerce. Slug, ustawienia i hooki się nie zmieniają.
1.1.4
- Znaczniki paska są escapowane przez wp_kses_post() w miejscu wypisania, zamiast polegać wyłącznie na szablonie.
1.1.3
- Etykiety „Coming soon” i „Get notified” w powiadomieniu o ulepszeniu są teraz angielskimi tekstami źródłowymi dla wszystkich języków; polskie witryny dostawały wcześniej własny polski tekst źródłowy, który tłumacze innych języków widzieli potem nieprzetłumaczony.
1.1.2
- Zmiana nazwy na Shiplume, zwykłą angielską nazwę zamiast esperanckiej. Domena tekstowa i folder wtyczki idą za nazwą; zapisane ustawienia, opcje i wszystkie hooki się nie zmieniają.
1.1.1
- Promocja ulepszenia w panelu bocznym jest teraz odrzucana razem z banerem. Odrzucenie banera zostawiało na ekranie ustawień reklamę na całą wysokość na stałe, a nie o to chodzi w wytycznej WordPress.org, według której zachęty do ulepszenia mają być stosowane z umiarem.
1.1.0
- Zmiana nazwy na Instigo. Zespół recenzentów WordPress.org prosi, żeby nazwa wtyczki zaczynała się od charakterystycznego, wymyślonego określenia, a nie od ogólnego opisowego słowa. Instigo to w esperanto zachęta. Domena tekstowa idzie za nazwą; zapisane dane, ustawienia i wszystkie hooki się nie zmieniają.
1.0.11
- Poprawka: promocja ulepszenia do PRO nadal zachęcała do zakupu osoby, które już kupiły płatną wersję. Odrzucić można było tylko baner, więc promocja w panelu bocznym i zablokowane karty funkcji towarzyszyły płacącemu klientowi na stałe. Promocja sprawdza teraz, czy płatna wersja jest aktywna, i wtedy się usuwa.
- Poprawka: symbole strzałek w ścieżkach menu administracyjnego i w tekstach przekazywanych tłumaczom. Strzałka w tekście do tłumaczenia sprawia, że ten znak staje się problemem każdego tłumacza i zmienia układ w każdym języku, który ją pomija.
1.0.10
- Poprawka: usunięcie wtyczki zostawiało w bazie danych flagę „odrzuć” z powiadomienia PRO dla poszczególnych użytkowników. Odinstalowanie usuwa ją teraz dla każdego użytkownika, a nie tylko dla tego, który powiadomienie odrzucił.
1.0.9
- Poprawiono dwa komunikaty paska, które na przetłumaczonym sklepie zostawały po angielsku. „Add {amount} more to get free shipping!” i „You have unlocked free shipping!” były zwykłymi tekstami w pliku konfiguracyjnym, a nie tekstami do tłumaczenia, więc nigdy nie trafiały do szablonu tłumaczeń i żaden pakiet językowy nie mógł ich zastąpić. Teraz można je tłumaczyć, więc pasek przechodzi na język witryny, gdy tylko pojawi się tłumaczenie, bez zmian w ustawieniach. Tłumaczenia przychodzą jako pakiety językowe WordPress.org, a nie w tej paczce, więc pasek zostaje po angielsku, dopóki pakiet nie zostanie opublikowany. Twoja własna treść, jeśli ją wpisałeś, zostaje dokładnie taka, jak ją napisałeś.
1.0.8
- Zmiana nazwy na Plogins Nudge – Free Shipping Bar for WooCommerce, tak aby nazwa zaczynała się od marki, a nie od ogólnego słowa, o co prosi zespół recenzentów wtyczek WordPress.org. Slug wtyczki się nie zmienia.
1.0.7
- Przetestowano z WordPress 7.1. Sprawdzone przez włączenie tej wersji na czystej instalacji 7.1 z WooCommerce 11.1, a nie przez edycję nagłówka.
1.0.6
- Poprawiono promocję PRO na ekranie ustawień, która podawała cenę w złotych. PRO jest wyceniane i rozliczane w euro, więc administrator polskiej witryny widział kwotę w złotych, a płacił w euro, a kwota w złotych była stałym przeliczeniem, które rozjeżdżało się z faktyczną opłatą wraz ze zmianą kursu. Promocja pokazuje teraz cenę w euro, która jest faktycznie pobierana.
1.0.5
- Ekran ustawień ostrzega teraz, gdy strona koszyka lub zamówienia jest zbudowana na bloku koszyka lub zamówienia WooCommerce, w którym pasek nie może się pojawić, zamiast zostawiać zaznaczone pole miejsca wyświetlania, podczas gdy w sklepie nic się nie pokazuje.
- Token
{amount}działa teraz także w komunikacie sukcesu, więc nie trafia już do kupujących jako dosłowny tekst. - Poprawiono opis wtyczki: pasek wyświetla się na klasycznych stronach koszyka i zamówienia, a nie w blokach koszyka i zamówienia.
1.0.3
- Tłumaczenia: uzupełniono polski, niemiecki i hiszpański dla panelu ulepszenia do PRO.
1.0.2
- Dodano dołączone tłumaczenia interfejsu na polski, niemiecki i hiszpański.
1.0.1
- Pierwsze stabilne wydanie.
0.1.4
- Zmiana nazwy na Plogins Nudge for WooCommerce, żeby nazwa wtyczki była bardziej charakterystyczna.
0.1.3
- Akcja
nudge/bar_renderedi atrybutdata-nudge-placementdla sygnałów analitycznych PRO.
0.1.2
- Filtr
nudge/bar_context, dzięki któremu PRO może zmieniać postęp, komunikaty i znaczniki progów.
0.1.1
- Filtr
nudge/thresholdiThresholdResolver::zoneThreshold()dla celów per strefa w PRO.
0.1.0
- Pierwsze wydanie: pasek postępu darmowej dostawy w koszyku i na stronie zamówienia, z progiem automatycznym lub ręcznym, aktualizacją na żywo przy zmianach w koszyku, edytowalnymi komunikatami, obsługą trybu ciemnego i ograniczonego ruchu oraz ekranem ustawień w WooCommerce > Nudge.
