WooCommerce 10.5: čo prinesie vývojárom (importy analytík, dane, API a výkon)

WooCommerce 10.5 je tesne pred vydaním a z pohľadu vývoja ide o release, ktorý sa oplatí sledovať hlavne kvôli výkonu a kompatibilite. Najväčšia zmena sa týka toho, ako sa údaje o objednávkach dostávajú do Analytics tabuliek – presne tá časť, ktorá na vyťažených e-shopoch dokáže spraviť slušnú šarapatu v databáze aj v ActionScheduler queue.

Nižšie je prehľad najdôležitejších noviniek, na ktoré narazíš pri vývoji tém a rozšírení, plus krátky prehľad API upozornení a performance vecí, ktoré WooCommerce 10.5 prináša.

Harmonogram vydania (beta a finál)

• Feature Freeze pre 10.5 odštartoval v pondelok 12. januára 2026.
• WooCommerce 10.5 Beta 1 bola vydaná 19. januára 2026.
• WooCommerce 10.5 Beta 2 bola vydaná 26. januára 2026.
• Finálne vydanie WooCommerce 10.5 je naplánované na 4. februára 2026.

Na testovanie beta verzií sa používa oficiálny plugin WooCommerce Beta Tester, ktorý ti umožní jednoduché prepínanie na beta buildy v prostredí, kde si to vieš bezpečne odskúšať.

Čo konkrétne prichádza vo WooCommerce 10.5 (zmeny, ktoré reálne pocítiš)

1) Nový spôsob importu objednávok do Analytics: Scheduled Imports namiesto per-event jobov

Najväčší zásah v 10.5 je „fundamentálne“ prekopanie importu order dát do Analytics tabuliek. Doteraz WooCommerce pri každom evente na objednávke spúšťal import cez ActionScheduler. Aj keď to bolo asynchrónne, na rušných weboch to viedlo k obrovským backlogom – rádovo 10 000+ naplánovaných akcií – a následne k degradácii výkonu, kontencii v databáze a spomaleniam.

V 10.5 je defaultne zapnutý režim Scheduled Imports: analytické dáta sa budú obnovovať dávkovo, nie „na každý event“.

• Obnova analytických dát prebieha každých 12 hodín (batch processing).
• Každá dávka spracuje 100 objednávok.
• Obe hodnoty sú prispôsobiteľné cez nové filtre: woocommerce_analytics_import_interval a woocommerce_analytics_regenerate_batch_size.
• Výsledok: výrazne menej naplánovaných akcií a nižší tlak na databázu, zároveň lepšia viditeľnosť stavu importu pre majiteľov obchodov a možnosť spúšťať import manuálne.

Relevantný PR: #61603.

2) Checkout blok: vylepšené UI pre shipping options (thumbnaily + kontajnery pri viacerých balíkoch)

Ak pracuješ s Block Checkoutom, 10.5 prináša úpravy UI pre výber dopravy: pri situácii, keď je objednávka rozdelená do viacerých balíkov (typicky pri subscription produktoch), sa v shipping možnostiach zobrazia náhľady produktov (thumbnails) a zároveň sa použijú orámované kontajnery, aby bolo jasnejšie, ku ktorému balíku sa voľba viaže.

Súčasťou je aj fix bugu, kde sa shipping metódy nesprávne synchronizovali pri prepínaní medzi voľbami doručenia Ship vs Pickup. PR: #61625.

3) Spoľahlivejšie zobrazenie objednávok s legacy/poškodenými tax dátami (float/string namiesto array)

Ďalšia zmena, ktorá má výrazný dopad na robustnosť: WooCommerce 10.5 zlepšuje prácu s objednávkami, kde sú tax hodnoty uložené „divne“ – napríklad ako float alebo string, namiesto očakávaných polí. Takéto dáta sa v praxi vyskytujú pri legacy migráciách, nešťastných importoch alebo nekorektných custom integráciách.

Fix je navrhnutý tak, aby bol spätne kompatibilný a pokrýval všetky typy order itemov:

• produkty (products)
• doprava (shipping)
• poplatky (fees)

WooCommerce bude vedieť inteligentne odvodiť tax rate ID z kontextu objednávky a zároveň pridáva filter woocommerce_order_item_legacy_tax_conversion, cez ktorý vieš doplniť vlastnú konverznú logiku, ak máš špecifický formát historických dát. PR: #62271.

4) Select2 CSS štýly sú scoped, aby „nepretiekli“ do UI iných pluginov

WooCommerce načítava Select2 (UI komponent pre selecty) a doteraz sa jeho štýly vedeli nechcene prejaviť aj v administrácii alebo rozhraniach iných pluginov. V 10.5 sú Select2 štýly scopingované cez :where(.woocommerce).

Dôležitý detail: pseudo-class :where() má nulovú špecificitu, takže existujúce custom override štýly by mali naďalej fungovať, no zároveň sa minimalizuje riziko, že WooCommerce CSS bude ovplyvňovať cudzie UI. PR: #61956.

5) Nový filter woocommerce_shipping_tax_class: dynamická tax trieda dopravy podľa obsahu košíka

WooCommerce 10.5 pridáva filter woocommerce_shipping_tax_class, ktorý umožňuje dynamicky určovať, aká tax class sa má použiť na dopravu. Význam to má v krajinách a scenároch, kde sa daň na shipping odvíja od toho, čo presne je v košíku, kto je zákazník a kam sa doručuje.

Konkrétne sa spomína možnosť počítať daň na dopravu podľa prevládajúcej sadzby v košíku (predominant tax rate) – typ flexibilnej logiky, ktorý je užitočný aj pri komplexných pravidlách, napríklad v Holandsku. PR: #59512.

API zmeny a upozornenia (developer advisories)

Okrem „hlavných“ zmien má 10.5 aj niekoľko bodov, ktoré môžu ovplyvniť kompatibilitu rozšírení. Toto sú najdôležitejšie advisories, ktoré sa oplatí prejsť detailnejšie:

• WC REST API bude korektne riešiť dekódovanie špeciálnych znakov v atribútoch variácií produktov. Detail: https://developer.woocommerce.com/2026/01/14/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5/
• Trait AccessiblePrivateMethods bude odstránený. Bol súčasťou Internal namespace (čo malo byť jasným signálom, že to nie je verejné API). Môže to rozbiť rozšírenia, ktoré ho používali nesprávne. Detail: https://developer.woocommerce.com/2026/01/15/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5/
• Zmeny v product permalinks založených na kategóriách: prioritu dostane „najhlbšia“ kategória (deepest category), čo zlepšuje SEO a konzistentnosť URL, a týka sa len konkrétnych permalink štruktúr. Detail: https://developer.woocommerce.com/2026/01/13/product-permalink-changes-coming-in-woocommerce-10-5/
• Na stránkach variabilných produktov bude tlačidlo Add to Cart defaultne disabled, kým sa plne nenačíta variation script. Cieľ: zabrániť tomu, aby používateľ na pomalom pripojení klikol „príliš skoro“ a odoslanie zlyhalo. Detail: https://developer.woocommerce.com/2026/01/16/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5/

Výkon: nové cache experimenty a opravy pre veľké katalógy

Experimentálna REST API cache (pre ľubovoľný endpoint)

V 10.5 má pribudnúť nová experimentálna REST API cache, ktorú bude možné aplikovať na ľubovoľný endpoint WC REST API. Podľa oznámenia budú detailnejšie informácie (vrátane toho, ako to testovať) dostupné pred vydaním 10.5.

Vylepšenia pre cached variation prices + nová utility trieda pre callbacky

Cachovanie cien variácií (cached variation prices) dostalo v 10.5 ďalšie vylepšenia a pribúda aj nová utility class na prácu s callbackmi. Detailný rozpis je v samostatnom článku: https://developer.woocommerce.com/2026/01/08/variation-prices-caching-improvements-in-woocommerce-10-5/.

Experimentálne Product Object Caching (cache inštancií produktov v rámci requestu)

Ďalšia výkonová novinka je experimentálne Product Object Caching. Myšlienka je jednoduchá: počas jedného requestu sa budú cacheovať inštancie produktov, aby sa zabránilo duplicitnému načítaniu z databázy. PR: https://github.com/woocommerce/woocommerce/pull/62041, doplňujúci developer post: https://developer.woocommerce.com/2026/01/19/experimental-product-object-caching-in-woocommerce-10-5/.

Oprava cache dát pre Product Filters (a dopad na transients cleanup)

WooCommerce 10.5 rieši aj výkonové problémy súvisiace s cache dátami Product Filters, ktoré sa predtým korektne nenastavovali a nenačítavali. V praxi to mohlo zaplaviť databázu cache dátami filtrov a negatívne ovplyvniť obchody s veľkými katalógmi.

Zmena zabezpečuje, že databáza nebude zahltená cache dátami filtrov a výkon veľkých katalógov neutrpí. Zároveň bol upravený nástroj na čistenie WooCommerce transientov tak, aby pri spustení vyčistil aj filter data cache. Ak však zákazníci používajú Product Filters block a stále vidia výkonové problémy, jednou z príčin môže byť práve tento cache balast – odporúčané riešenie je vyčistiť WooCommerce transients. PR: #62575.

Changelog (kompletný zoznam zmien)

Kompletný changelog pre 10.5 (beta vetva) je dostupný tu: https://github.com/woocommerce/woocommerce/blob/10.5.0-beta.1/plugins/woocommerce/readme.txt.

Rýchle praktické zhrnutie pre vývojára

• Ak riešiš výkon na rušných store, sleduj hlavne prechod na Scheduled Imports pre Analytics (interval 12h, batch 100 objednávok, filtre na úpravu).
• Ak máš custom checkout integrácie alebo testuješ subscription flow, všímaj si zmeny v shipping UI v Checkout bloku a fix synchronizácie Ship/Pickup.
• Ak pracuješ s historickými objednávkami/migráciami, nová tolerancia voči legacy tax dátam môže odstrániť fatálne hrany – a cez woocommerce_order_item_legacy_tax_conversion si vieš doplniť vlastnú konverziu.
• Pozor na kompatibilitu: REST API špeciálne znaky vo variáciách, odstránenie AccessiblePrivateMethods, zmeny v product permalinks a disabled Add to Cart pri variabilných produktoch, kým sa nenačíta script.
• Vo výkone sa oplatí sledovať experimenty: REST API cache a Product Object Caching, plus fixy okolo Product Filters cache a transients cleanup.