Shiplume – Shipping Progress Bar for WooCommerce

Popis

Shiplume ukazuje zákazníkům, jak daleko je jejich košík od limitu pro dopravu zdarma a za kolik ještě musí nakoupit, aby na ni dosáhli. Zpráva se aktualizuje při změnách v košíku, takže „doprava zdarma nad 1000 Kč“ přestává být jen drobným písmem v patičce a stává se číslem, podle kterého může zákazník jednat.

Ve výchozím nastavení pochází limit přímo z WooCommerce. Shiplume zkontroluje povolené způsoby dopravy zdarma ve všech zónách dopravy a použije nejnižší nalezenou minimální částku objednávky, takže hodnotu nemusíte spravovat na dvou místech. Pokud ji chcete nastavit sami, přepněte na manuální režim a zadejte pevnou částku; tato částka slouží také jako záložní, pokud automatický režim nenajde žádný odpovídající způsob.

Když není co užitečného zobrazit (lišta je vypnutá, košík je prázdný nebo není nastaven žádný limit), Shiplume nevykreslí nic místo toho, aby zobrazoval prázdnou nebo trvale dokončenou lištu.

Dokumentace a odkazy

Co plugin dělá

  • Načítá limit dopravy zdarma automaticky z aktivních způsobů dopravy zdarma ve WooCommerce, nebo použije pevnou částku nastavenou ručně.
  • Znovu se vykresluje spolu s košíkem na klasických stránkách Košík a Pokladna (vytvořených pomocí zástupných symbolů [woocommerce_cart] a [woocommerce_checkout]). Drobný skript (bez vlastní závislosti na jQuery) animuje změnu šířky mezi aktualizacemi.
  • Využívá skutečný prvek role="progressbar" s atributy aria-valuenow/min/max a čitelnou textovou zprávu pro čtečky obrazovky; respektuje prefers-reduced-motion.
  • Před vykreslením rezervuje výšku lišty, takže její přidání nezpůsobí posun rozvržení stránky.
  • Lišta je stylována pomocí vlastních CSS proměnných --nudge-* a přizpůsobuje se tmavému režimu, takže ji šablony mohou přebarvit bez úpravy HTML kódu.
  • Umožňuje upravit texty zpráv o průběhu a úspěchu, přičemž v obou lze použít zástupný znak {amount} pro zbývající částku.
  • Obsahuje soubor POT, při odinstalaci odstraňuje své volby a deklaruje kompatibilitu s HPOS.

Zdrojový kód a hlášení chyb se nachází na GitHubu: github.com/wppoland/plogins-nudge

Externí služby

Shiplume se nepřipojuje k žádné externí službě. Neodesílá analytická data, neregistruje licenci, nenačítá vzdálená písma ani skripty a neprovádí žádné HTTP požadavky mimo váš server. Vše, co potřebuje (limit dopravy zdarma a mezisoučty košíku), pochází z WooCommerce na stejném webu, a stylopis lišty i malý animační skript jsou načítány ze složky pluginu, nikoli z CDN. Jediná data, která Shiplume ukládá, jsou dvě položky nastavení WordPressu ve vaší vlastní databázi (nudge_settings pro konfiguraci a nudge_db_version pro aktualizace), přičemž obě jsou odstraněny, když plugin smažete.

Překlady

Shiplume je plně přeložitelný a obsahuje šablonu shiplume.pot. Překlady jsou dodávány prostřednictvím jazykových balíčků WordPress.org z translate.wordpress.org, kde vznikají překlady do polštiny, němčiny a španělštiny; samotný balíček neobsahuje žádné zkompilované soubory překladu.

Snímky obrazovky

Instalace

  1. Nahrajte plugin do /wp-content/plugins/shiplume nebo jej nainstalujte přes Pluginy > Přidat nový.
  2. Aktivujte ho. WooCommerce musí být aktivní.
  3. Přejděte do WooCommerce > Shiplume, povolte lištu a zvolte, kde se má zobrazovat.

Nejčastější dotazy

Vyžaduje WooCommerce?

Ano. Shiplume nedělá nic, dokud není aktivní WooCommerce.

Odkud se bere částka pro dopravu zdarma?

V automatickém režimu Shiplume načte minimální výši objednávky z povolených způsobů dopravy zdarma ve WooCommerce a použije nejnižší hodnotu ze všech zón dopravy. V manuálním režimu si pevnou částku nastavíte sami. Pokud automatický režim nenajde žádný způsob s minimální částkou objednávky, použije místo toho manuální částku.

Co se zobrazí, když není nastaven žádný cíl dopravy zdarma?

Nic. Místo vykreslení prázdné nebo vždy dokončené lišty Shiplume výstup zcela vynechá, dokud neexistuje reálný limit, ke kterému lze odpočítávat.

Funguje s bloky košíku a pokladny?

Zatím ne. Lišta se zobrazuje na klasických stránkách Košík a Pokladna vytvořených pomocí zástupných symbolů (shortcodes) [woocommerce_cart] a [woocommerce_checkout]. Vedle bloků funguje bezpečně a deklaruje kompatibilitu s bloky košíku a pokladny, ale uvnitř nich nic nevykresluje. Pokud vaše stránky používají bloky, obrazovka nastavení Shiplume vás na to upozorní vedle zaškrtávacích políček umístění.

Mohu změnit texty a barvy?

Ano. Zprávy o průběhu i dosažení cíle lze upravit na stránce nastavení a barvy i velikost lišty představují vlastní vlastnosti CSS --nudge-*, které může vaše šablona přepsat.

Funguje tento plugin na WordPress Multisite?

Ano. Tento plugin je kompatibilní s WordPress Multisite. Můžete ho aktivovat pro celou síť nebo na jednotlivých webech; každý web si uchovává vlastní nastavení a data.

Recenze

Přečtěte si 1 recenzi

Autoři

Shiplume – Shipping Progress Bar for WooCommerce je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.

Spolupracovníci

Plugin „Shiplume – Shipping Progress Bar for WooCommerce“ byl přeložen do 4 jazyků. Děkujeme všem překladatelům za jejich pomoc.

Přeložte “Shiplume – Shipping Progress Bar for WooCommerce” do svého jazyka.

Zajímá vás vývoj?

Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.

Přehled změn

1.1.7

  • Opraveno: v obchodě bez nastaveného způsobu dopravy zdarma se již nezobrazuje text „Přidejte ještě X pro dopravu zdarma!“. Výchozí manuální částka byla 50, takže automatický režim přecházel na cíl, který WooCommerce nikdy neaplikuje. Manuální částka nyní začíná na 0; obchod, který nastavení uložil, si zachovává uloženou hodnotu.
  • Opraveno: pokud má způsob dopravy zdarma zaškrtnuto „Aplikovat pravidlo minimální částky před slevovým kupónem“, průběh se počítá před odečtením kupónů, stejně jako ve WooCommerce. Lišta dříve vyzývala k dalšímu nákupu, i když WooCommerce již dopravu zdarma nabízela.
  • Opraveno: ukazatel průběhu předává svou hodnotu čtečkám obrazovky. Atributy aria-valuenow, aria-valuemin a aria-valuemax byly z výstupu odstraněny.
  • Opraveno: lišta se po aktualizaci košíku nebo pokladny opět animuje. Skript nativně naslouchal událostem, které WooCommerce spouští přes jQuery, a které k němu nedorazily.

1.1.6

  • Opraveno: lišta se na klasickém košíku a pokladně zobrazovala dvakrát, jednou nad součty a jednou uvnitř nich. Na pokladně se při každém obnovení přidala další kopie. Nyní je na každé stránce pouze jedna lišta a lišta na pokladně se stále aktualizuje, když kupón změní celkovou částku.
  • Opraveno: třída umístění a datový atribut lišty vypisovaly hodnotu „Array“ namísto cart nebo checkout.

1.1.5

  • Zobrazovaný název je nyní Shiplume – Shipping Progress Bar for WooCommerce. Název v URL, nastavení i hooky zůstávají nezměněny.

1.1.4

  • HTML kód lišty je při výpisu ošetřen funkcí wp_kses_post() namísto spoléhání se pouze na šablonu.

1.1.3

  • Texty oznámení o aktualizaci „Coming soon“ a „Get notified“ jsou anglickými zdrojovými řetězci pro všechny jazyky; polské weby dříve dostávaly vlastní polský zdrojový text, který pak překladatelé do jiných jazyků viděli nepřeložený.

1.1.2

  • Přejmenováno na Shiplume, což je jednoduchý anglický název nahrazující ten v esperantu. Textová doména i složka pluginu odpovídají novému názvu; uložená nastavení, volby i veškeré hooky zůstávají beze změny.

1.1.1

  • Upoutávka na upgrade v postranním panelu se nyní řídí stejným zavřením jako banner. Zavření banneru dříve ponechávalo reklamu na celou výšku na obrazovce nastavení natrvalo, což neodpovídá pravidlu WordPress.org o střídmém používání výzev k upgradu.

1.1.0

  • Přejmenováno na Instigo. Tým pro kontrolu pluginů na WordPress.org požaduje, aby název pluginu začínal osobitým, nově vytvořeným identifikátorem namísto obecného popisného slova. Instigo je v esperantu výraz pro podnět či pobídku. Textová doména následuje název; uložená data, nastavení i veškeré hooky zůstávají beze změny.

1.0.11

  • Opraveno: upoutávka na přechod na verzi PRO se stále nabízela uživatelům, kteří si placenou verzi již zakoupili. Šlo skrýt pouze banner, takže upoutávka v postranním panelu a karty zamknutých funkcí platícího zákazníka neustále provázely. Upoutávka nyní ověřuje, zda je aktivní placená verze, a v takovém případě se nezobrazuje.
  • Opraveno: znaky šipek v cestách v administračním menu a v řetězcích předávaných překladatelům. Šipka uvnitř přeložitelného řetězce komplikuje práci překladatelům a mění rozvržení v jazycích, které ji vynechají.

1.0.10

  • Opraveno: smazání pluginu zanechalo v databázi příznak „skrýt“ pro oznámení o verzi PRO pro každého uživatele. Odinstalace jej nyní odstraní pro všechny uživatele, nejen pro toho, který jej zavřel.

1.0.9

  • Opraven problém, kdy obě zprávy lišty zůstávaly v angličtině na přeloženém webu. Řetězce „Add {amount} more to get free shipping!“ a „You have unlocked free shipping!“ byly zapsány jako prostý text v konfiguračním souboru namísto přeložitelných řetězců, takže se nedostaly do šablony překladu a žádný jazykový balíček je nemohl nahradit. Nyní jsou přeložitelné, takže lišta převezme jazyk webu ihned, jakmile překlad existuje, aniž by bylo nutné měnit nastavení. Překlady jsou dodávány jako jazykové balíčky z WordPress.org, nikoli v tomto stažení, takže lišta zůstává v angličtině, dokud balíček nevyjde. Vlastní formulace, pokud jste nějakou zadali, zůstává přesně tak, jak jste ji napsali.

1.0.8

  • Přejmenováno na Plogins Nudge – Free Shipping Bar for WooCommerce, aby název začínal značkou namísto obecného slova, jak vyžaduje tým pro kontrolu pluginů na WordPress.org. Název v URL (slug) pluginu zůstává nezměněn.

1.0.7

  • Otestováno s WordPress 7.1. Ověřeno aktivací tohoto sestavení na čisté instalaci verze 7.1 s WooCommerce 11.1, nikoli pouze úpravou hlavičky.

1.0.6

  • Opravena upoutávka na verzi PRO na obrazovce nastavení, která uváděla cenu v PLN. Verze PRO je naceněna a účtována v EUR, takže správci na polském webu se zobrazovala částka ve zlotých, ale platba probíhala v eurech, přičemž hodnota ve zlotých byla pevný přepočet, který se při pohybu kurzu odchyloval od skutečné částky. Upoutávka nyní zobrazuje skutečně účtovanou cenu v eurech.

1.0.5

  • Obrazovka nastavení vás nyní upozorní, když je stránka košíku nebo pokladny vytvořena pomocí bloku Košík nebo Pokladna od WooCommerce, kde se lišta nemůže zobrazit, namísto ponechání zaškrtnutého políčka umístění bez zobrazení v obchodě.
  • Zástupný symbol {amount} nyní funguje také ve zprávě o úspěchu, takže se zákazníkům již nezobrazuje jako doslovný text.
  • Opraven popis pluginu: lišta se vykresluje na klasických stránkách košíku a pokladny, nikoli uvnitř bloků Košík a Pokladna.

1.0.3

  • Překlady: dokončena polština, němčina a španělština pro panel přechodu na verzi PRO.

1.0.2

  • Přidány přibalené překlady rozhraní pluginu do polštiny, němčiny a španělštiny.

1.0.1

  • První stabilní verze.

0.1.4

  • Přejmenováno na Plogins Nudge for WooCommerce pro výraznější název pluginu.

0.1.3

  • Akce nudge/bar_rendered a atribut data-nudge-placement pro analytické signály verze PRO.

0.1.2

  • Filtr nudge/bar_context, aby verze PRO mohla upravovat postup, zprávy a značky úrovní.

0.1.1

  • Filtr nudge/threshold a ThresholdResolver::zoneThreshold() pro cíle podle jednotlivých zón ve verzi PRO.

0.1.0

  • První vydání: ukazatel průběhu dopravy zdarma pro košík a pokladnu s automatickým nebo manuálním limitem, živými aktualizacemi při změnách košíku, upravitelnými zprávami, podporou tmavého režimu a omezení pohybu a obrazovkou nastavení v sekci WooCommerce > Nudge.