Popis
Swatch nahrazuje výchozí rozbalovací nabídky <select> variant WooCommerce vizuálními, přístupnými vzorky na stránkách jednotlivých produktů. Zvolte typ vzorku pro jednotlivé atributy (barevné tečky nebo tlačítka/štítky) a přiřaďte barvu nebo štítek každé položce.
Vzorky ovládají přímo formulář variant WooCommerce, takže cena, sklad a tlačítko přidání do košíku se aktualizují přesně stejně jako u standardních rozbalovacích nabídek. Vybrané stavy i nedostupné kombinace se promítají automaticky.
Kompletní zdrojový kód naleznete na GitHubu na adrese github.com/wppoland/plogins-swatch, pokud si chcete kód prohlédnout nebo nahlásit problém.
Funkce
- Typy vzorků: barva a tlačítko/štítek.
- Výběr typu pro jednotlivé atributy na obrazovce globálních atributů.
- Barva pro jednotlivé položky (
sanitize_hex_color) a vlastní štítek, uložené jako metadata položek. - Napojeno do nativního formuláře variant WooCommerce, bez jQuery, čistý JavaScript.
- Ovladatelné z klávesnice (sémantika radiogroup, šipky) a označené pro čtečky obrazovky.
- Viditelné zvýraznění aktivního prvku (focus-visible), dostatečný kontrast, podpora omezení pohybu (reduced-motion), žádný posun rozvržení.
- Bezproblémový návrat ke standardní rozbalovací nabídce, pokud atribut nemá žádná data vzorku.
- Vzorky také ve výpisech obchodu a kategorií, ve výchozím nastavení vypnuté, aby se stránka obchodu nezměnila bez vašeho vědomí.
- Stránka nastavení pod WooCommerce: zapnutí/vypnutí, výchozí typ vzorku a přepínač zobrazení v katalogu obchodu.
Zcela soběstačný. Žádné externí služby, žádný účet, žádné závislosti třetích stran.
Externí služby
Swatch se nepřipojuje k žádným externím službám. Neprovádí žádné odchozí HTTP požadavky, nenačítá vzdálené skripty, písma ani prostředky z CDN a neodesílá žádnou telemetrii ani analytická data. Není vyžadován žádný účet ani API klíč.
Vše je uloženo ve vaší vlastní databázi: typ vzorku pro každý atribut, globální výchozí hodnoty a verze schématu jsou uloženy v možnostech swatch_attribute_types, swatch_settings a swatch_db_version a barva a štítek každé položky jsou uloženy jako metadata položky swatch_color a swatch_label u položek atributů WooCommerce. Plugin neodesílá žádný e-mail.
Překlady
Plogins Swatch je plně přeložitelný a obsahuje šablonu plogins-swatch.pot. Překlady jsou dodávány prostřednictvím jazykových balíčků WordPress.org z translate.wordpress.org, kde vzniká polština, němčina a španělština; samotný balíček neobsahuje žádné zkompilované soubory překladů.
Snímky obrazovky


Instalace
- Nainstalujte plugin z Pluginy > Přidat nový vyhledáním výrazu Plogins Swatch, nebo nahrajte složku
plogins-swatchdo/wp-content/plugins/. - Aktivujte jej. WooCommerce musí být aktivní.
- Přejděte na WooCommerce > Swatch a upravte výchozí nastavení.
- V sekci Produkty > Vlastnosti nastavte barvu vzorku nebo štítek pro každý prvek vlastnosti.
Nejčastější dotazy
-
Dokumentace a odkazy
-
- Dokumentace: plogins.com/plogins-swatch/docs/
- Stránka pluginu: plogins.com/plogins-swatch/
- Zdrojový kód: github.com/wppoland/plogins-swatch
- Hlášení chyb a žádosti o funkce: github.com/wppoland/plogins-swatch/issues
-
Vyžaduje to WooCommerce?
-
Ano. Swatch rozšiřuje variabilní produkty WooCommerce a bez něj nic nedělá.
-
Co se stane s atributy, které jsem nenakonfiguroval?
-
Získají výchozí typ vzorku pluginu (ve výchozím stavu tlačítkové vzorky), stejně jako jakýkoli atribut, kterému jste nenastavili vlastní typ. Pouze u atributu barvy bez nakonfigurovaných barev dojde k automatickému návratu k rozbalovací nabídce.
-
Funguje to bez jQuery?
-
Ano. Frontend je čistý JavaScript (vanilla JavaScript), který se napojuje na vlastní události variant WooCommerce.
-
Mohou nakupující vybírat varianty pomocí klávesnice?
-
Ano. Vzorky využívají sémantiku radiogroup, navigaci šipkami na klávesnici a viditelné zvýraznění aktivního prvku.
-
Funguje to na mobilních zařízeních?
-
Ano. Vzorky zůstávají v nativním formuláři variant s prvky přizpůsobenými pro dotykové ovládání; není vyžadována žádná samostatná mobilní aplikace ani skriptovací framework.
-
Funguje tento plugin na síti webů WordPress Multisite?
-
Ano. Tento plugin je kompatibilní se sítí webů WordPress Multisite. Můžete jej aktivovat pro celou síť nebo na jednotlivých webech; každý web si uchovává vlastní nastavení a data.
Autoři
Swatch – Variation Swatches for WooCommerce je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
SpolupracovníciPlugin „Swatch – Variation Swatches for WooCommerce“ byl přeložen do 3 jazyků. Děkujeme všem překladatelům za jejich pomoc.
Přeložte “Swatch – Variation Swatches 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.0.18
- Opraveno: vzorky nedostupných kombinací nebyly nikdy deaktivovány a odkaz „Vymazat“ ponechával staré vzorky zvýrazněné. WooCommerce spouští své události variant prostřednictvím jQuery, což nativní posluchač událostí nikdy nezachytí, takže vzorky vynechaly každou aktualizaci. Nyní odebírají události přímo přes jQuery z WooCommerce.
- Opraveno: přidání nebo uložení jakékoli položky atributu ukládalo černou barvu vzorku, protože pole barvy vždy odesílá hodnotu. Položka, které jste barvu nikdy nenastavili, pak zobrazovala černou tečku a atribut barvy se již nemohl vrátit k rozbalovací nabídce. Zaškrtávací políčko „Bez barvy“ nyní ponechá položku bez barvy; výběr barvy políčko odškrtne. Položky uložené jako černé v dřívějších verzích si tuto barvu ponechají, dokud u nich nezaškrtnete „Bez barvy“.
1.0.17
- Štítky „Již brzy“ a „Nechat se informovat“ v oznámení o upgradu jsou anglické zdrojové řetězce pro všechny jazyky; polské weby dříve měly vlastní polský zdrojový text, který překladatelé v jiných jazycích viděli nepřeložený.
1.0.16
- Zobrazovaný název již neobsahuje předponu „Plogins “. Název v URL (slug), textová doména i všechny klíče možností zůstávají beze změny, takže na existující instalaci se nic nemění.
1.0.15
- Propagace upgradu v postranním panelu se nyní zavírá stejně jako banner. Zavření banneru dříve ponechalo reklamu přes celou výšku na obrazovce nastavení napořád, což neodpovídá pokynům WordPress.org o přiměřeném používání výzev k upgradu.
1.0.14
- Zabezpečení (nízké): značkování vzorků nyní při výpisu prochází přes
wp_kses()s explicitním seznamem povolených prvků (allowlist). Každý vykreslovací modul ošetřuje zapisované hodnoty (escaping), ale každý končí filtrem, takže na stránku se ve skutečnosti dostalo cokoli, co vrátilo poslední zpětné volání. Rozšíření nebo cokoli jiného napojeného na tyto filtry mohlo do stránky obchodu vložit neošetřený kód. Seznam povolených prvků pokrývá elementy a atributy, které vzorky používají, včetněimgpro obrázkové vzorky v placené verzi adata-*pro hodnoty, které skript načítá. - Poznámka: vložená barva (inline colour), která není hexadecimální hodnotou, je při filtrování značkování WordPressem odstraněna, takže zpětné volání vracející
rgb(...)o tuto barvu přijde. Barvy uložené u položky atributu tím nejsou dotčeny: při ukládání i čtení procházejí přessanitize_hex_color().
1.0.13
- Opraveno: propagace upgradu na PRO se stále zobrazovala lidem, kteří si již placenou verzi zakoupili. Zavřít šlo pouze banner, takže propagace v postranním panelu a zamčené karty funkcí neustále provázely platícího zákazníka. Propagace nyní kontroluje, zda je placená verze aktivní, a pokud ano, skryje se.
- Opraveno: znaky šipek v cestách administračního menu a v řetězcích předávaných překladatelům. Šipka uvnitř překládatelného řetězce dělá ze znaku problém pro každého překladatele a mění rozvržení v jakémkoli jazyce, který ji vynechá.
1.0.12
- Opraveno: postup instalace uváděl nahrání složky
swatch. Balíček se rozbaluje doplogins-swatchod chvíle, kdy sestavení začalo přebírat název složky z textové domény, takže postup podle souboru readme umístil plugin na místo, kde jej WordPress nemohl najít. - Opraveno: odkaz na obrazovku atributů obsahoval znak šipky uvnitř překládaného řetězce, což dělalo ze šipky starost překladatelů namísto součásti rozvržení.
- Změněno: seznam funkcí nyní zmiňuje vzorky ve výpisech obchodu a kategorií. Přibyly ve verzi 1.0.8 a v popisu to dosud nebylo uvedeno.
- Změněno: polština, němčina a španělština jsou opět kompletní na 52 z 52 řetězců. Deset řetězců, včetně celé sekce výpisu obchodu, nemělo překlad v žádném jazyce.
1.0.11
- Opraveno: smazání pluginu zanechalo v databázi příznak „zavřít“ u oznámení PRO pro jednotlivé uživatele. Odinstalace jej nyní odstraní pro každého uživatele, nejen pro toho, který jej zavřel.
1.0.10
- Opraveno: oznámení o verzi PRO na obrazovce nastavení stále nabízelo vzorky ve výpisu obchodu jako placenou funkci. Ty jsou přitom v bezplatném pluginu dostupné od verze 1.0.8 pod zaškrtávacím políčkem Vzorky ve výpisu obchodu. Verze PRO v tomto případě přidává obrázek položky namísto barevného vzorku, a oznámení to nyní uvádí.
1.0.9
- Změněno: Vzorky ve výpisu obchodu nyní ukazuje, že závisí na hlavním přepínači nad ním. Při vypnuté možnosti Povolit vzorky je řádek neaktivní a uvádí, že ve výpisech se zatím vzorky vykreslovat nebudou, namísto umožnění zaškrtnutí, které nic neudělá. Stav se vykresluje z uložených nastavení, takže je správný i při vypnutém JavaScriptu, a pole zůstává v obou případech dostupné a uložitelné.
- Změněno: oba přepínače v této sekci propojují svůj text nápovědy se zaškrtávacím políčkem pomocí
aria-describedby, takže čtečka obrazovky přečte vysvětlení spolu s ovládacím prvkem.
1.0.8
- Novinka: Vzorky ve výpisu obchodu, nastavení na obrazovce Swatch. Vykreslování v archivu bylo v tomto pluginu přítomno vždy, kompletní a funkční, ale bylo blokováno pevně zadanou hodnotou, kterou přepínalo pouze placené rozšíření. To z něj dělalo vestavěnou funkci, kterou plugin odmítal spustit, což pravidla WordPress.org nedovolují, takže nyní jde o nastavení. Ve výchozím stavu je vypnuto, protože mění vzhled stránky obchodu.
- Barevné a štítkové vzorky se ve výpisech vykreslují přesně stejně jako na stránce produktu. Obrázkové vzorky ve výpisech jsou tím, co navíc přináší placená verze.
1.0.7
- Přejmenováno na Plogins Swatch – Variation Swatches for WooCommerce, aby název začínal značkou namísto obecného slova, což vyžaduje schvalovací tým pluginů WordPress.org. Název v URL pluginu (slug) zůstává beze změny.
1.0.6
- Otestováno s WordPress 7.1. Ověřeno aktivací tohoto sestavení na čisté instalaci 7.1 s WooCommerce 11.1, nikoli pouze úpravou hlavičky.
1.0.5
- Opravena propagace verze 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ěhla v eurech, přičemž částka ve zlotých byla pevným přepočtem, který se kvůli vývoji kurzu lišil od skutečně účtované částky. Propagace nyní zobrazuje cenu v eurech, která je skutečně účtována.
1.0.3
- Překlady: dokončena polština, němčina a španělština pro panel upgradu na 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.5
- Přejmenováno na Plogins Swatch for WooCommerce pro výraznější název pluginu.
0.1.4
- Filtry skupin vzorků
swatch/swatch_group_varsaswatch/swatch_group_classespro velikosti a tvary v PRO verzi.
0.1.3
- Filtry pro jednotlivé vzorky (
swatch/product_swatch_html,swatch/archive_swatch_html) aswatch/swatch_itemspro PRO bublinové nápovědy a rozšíření.
0.1.2
- Přidán volitelný náhled vzorků ve výpisu archivu prostřednictvím filtrů
swatch/archive_enabledaswatch/archive_htmlpro rozšíření.
0.1.1
- Přidán filtr
swatch/variation_gallerya zpřístupněnswatch_variation_galleryv JSON variant pro rozšíření.
0.1.0
- První vydání.
