WooCommerce 10.5 arendajale: ajastatud Analytics import, uued filtrid ja mitu jõudluskatset

WooCommerce 10.5 on „kohe tulemas” ning arendaja vaates on see väljalase pigem infrastruktuurne kui kosmeetiline: mitu muudatust sihib otse seda, kuidas suurte poodide tellimused, analüütika ja cache’imine käituvad. Allpool on kokku võetud olulisemad tehnilised muudatused, millele tasub oma laiendusi ja teemasid testides tähelepanu pöörata.

Väljalaske ajakava (10.5)

• WooCommerce 10.5 Beta on testimiseks saadaval.
• Feature Freeze algas 12. jaanuaril 2026.
• WooCommerce 10.5 Beta 1 avaldati 19. jaanuaril 2026.
• WooCommerce 10.5 Beta 2 avaldati 26. jaanuaril 2026.
• Lõplik väljalase on plaanitud 4. veebruariks 2026 (beeta postituses on eraldi mainitud ka, et väljalase on „scheduled” 3. veebruariks 2026, kuid ajajoones on kuupäevana kirjas 4. veebruar 2026).

Kui tahad beetasid proovida, on soovituslik kasutada ametlikku WooCommerce Beta Tester pluginat.

Mis on 10.5-s arendaja jaoks kõige olulisem

1) Analyticsi tellimuste import: ActionScheduleri „tormist” ajastatud partiideks

10.5 toob fundamentaalse muudatuse sellesse, kuidas WooCommerce viib tellimuste andmed Analyticsi tabelitesse. Varem käivitati iga tellimusega seotud sündmuse peale eraldi analytics import job ActionScheduleri kaudu. Jah, see oli asünkroonne, aga aktiivsetel poodidel lõppes see sageli massiivse ActionScheduleri järjekorraga (10 000+ action’it), mis omakorda tekitas tõsiseid jõudlusprobleeme: DB contention, aeglustused ja üldine saidi „uimasus”.

WooCommerce 10.5 seab nüüd vaikimisi sisse Scheduled Imports lähenemise: analüütika andmeid uuendatakse partiide kaupa iga 12 tunni tagant ning korraga töödeldakse 100 tellimust partii kohta. Mõlemad väärtused on arendaja jaoks kohandatavad uute filtrite abil:

• woocommerce_analytics_import_interval – importimise intervall (vaikimisi 12h).
• woocommerce_analytics_regenerate_batch_size – tellimuste arv ühe partii kohta (vaikimisi 100).

Praktiline mõju: oluliselt vähem ajastatud action’eid, väiksem koormus andmebaasile, parem ülevaade importimise staatusest ning võimalus importi igal ajal käsitsi käivitada. Tehniline viide: #61603.

2) Checkout ploki tarnevalikute UI: pisipildid, paketid ja sünkroniseerimine

Checkout block’i tarnevalikute kasutajaliides saab täienduse: kui tellimus jaguneb mitmeks paketiks (eriti mainitakse subscription-tooteid), kuvatakse tarnevalikutes nüüd toote pisipildid ning visuaalselt eristatud (bordered) konteinerid.

Lisaks parandatakse bugi, kus tarneviisid ei sünkroniseerunud korralikult juhul, kui kasutaja lülitas Ship ja Pickup tarnevalikute vahel. Tehniline viide: #61625.

3) Pärand- või vigase maksustamise andmetega tellimuste vaatamine muutub töökindlamaks

Kui oled kunagi pärinud poodi, kus ajalooliselt on maksude (tax) andmed mõnes tellimuses „imelikud”, siis 10.5 parandab siin töökindlust. Konkreetne probleem: maksuväärtused olid mõnes kohas salvestatud float’i või string’ina, kuigi kood eeldas massiivi.

Parandus lisab tagurpidi ühilduva käsitluse kõikide order item tüüpide jaoks (tooted, shipping, fees). Lisaks püütakse maksura (tax rate) ID-d nutikalt järeldada tellimuse kontekstist. Arendajale lisatakse ka filter, millega saad vajadusel oma konversiooniloogikat süstida:

• woocommerce_order_item_legacy_tax_conversion – custom conversion logic legacy tax andmete normaliseerimiseks.

Tehniline viide: #62271.

4) Select2 stiilid ei tohiks enam „lekkida” teistesse pluginatesse

WooCommerce laadib Select2 (popular third-party UI component) stiile, mis varasemalt võisid mõnes admin- või front-end olukorras mõjutada ka teiste plugin’ate kasutajaliidese elemente. 10.5-s scope’itakse need stiilid nüüd :where(.woocommerce) kaudu.

Oluline detail: :where() pseudo-class säilitab nulli specificity, mis tähendab, et olemasolevad custom override’id peaksid jätkuvalt töötama, kuid samal ajal ei „värvita” WooCommerce’i Select2 reeglid enam kogu ülejäänud admini. Tehniline viide: #61956.

5) Uus woocommerce_shipping_tax_class filter: dünaamiline tarne maksuklass

10.5 lisab uue filtri woocommerce_shipping_tax_class, millega saab tarne maksuklassi (ja seega tarne maksustamise loogikat) arvutada dünaamiliselt ostukorvi sisu, kliendi andmete ja asukoha põhjal.

Selle mõte on võimaldada keerukamad stsenaariumid: näiteks arvutada tarne maks „ostukorvis domineeriva” maksura alusel. Postituses tuuakse eraldi välja, et see aitab paindlikult lahendada keerukamaid maksujuhtumeid (näitena mainitakse Hollandit). Tehniline viide: #59512.

API muudatused ja arendaja-teated (advisories)

10.5-ga tuleb rida muudatusi, mida WooCommerce arendajablogi käsitleb eraldi advisory-postitustes. Siin on kiire ülevaade koos linkidega, et saaksid kontrollida, kas miski puudutab sinu laiendust.

• WC REST API hakkab korrektselt käsitlema special character decoding’ut product variation attribute’ide puhul. Detailid: https://developer.woocommerce.com/2026/01/14/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5/
• AccessiblePrivateMethods trait eemaldatakse. See asus Internal namespace’is, mis pidi juba vihjama, et seda ei tarbita avaliku API-na, aga kui mõni laiendus seda siiski kasutas, võib see nüüd katki minna. Detailid: https://developer.woocommerce.com/2026/01/15/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5/
• Kategoorial põhinevad toote permalingid muutuvad: eelistatakse kõige sügavamat (deepest) kategooriat, et URL-id oleksid SEO ja järjepidevuse mõttes paremad. Mõjutatud on ainult teatud permalink structure’id. Detailid: https://developer.woocommerce.com/2026/01/13/product-permalink-changes-coming-in-woocommerce-10-5/
• Variable product lehtedel on Add to Cart nupp nüüd vaikimisi disabled, kuni variation script on täielikult laadinud. Eesmärk: vältida olukorda, kus aeglase ühenduse korral klikitakse nuppu enne, kui valiku-loogika initsialiseerub, ja vormi submit ebaõnnestub. Detailid: https://developer.woocommerce.com/2026/01/16/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5/

Jõudlus: uued katselised cache’id ja parandused suurte kataloogide jaoks

Eksperimentaalne REST API cache (uus)

WooCommerce 10.5 lisab uue eksperimentaalse REST API cache’i, mida saab rakendada ükskõik millisele WC REST API endpoint’ile. Postituse järgi jagatakse enne 10.5 lõppväljalaset rohkem infot, sh kuidas seda testida.

Variation prices caching: täiendused ja uus utiliit callback’ide jaoks

Ka cached variation prices saavad täiendusi ning lisandub uus utility class callback’idega töötamiseks. Detailsem postitus: https://developer.woocommerce.com/2026/01/08/variation-prices-caching-improvements-in-woocommerce-10-5/

Eksperimentaalne Product Object Caching

10.5 toob sisse ka eksperimentaalse Product Object Caching funktsiooni, mis tõstab jõudlust cache’ides iga request’i jooksul tooteobjektide instantsid. Sisuline eesmärk: vältida sama toote korduvat laadimist andmebaasist ühe ja sama päringu kontekstis.

Tehniline PR: https://github.com/woocommerce/woocommerce/pull/62041 ning taustapostitus: https://developer.woocommerce.com/2026/01/19/experimental-product-object-caching-in-woocommerce-10-5/

Product Filters: cache-andmete seadistamise/laadimise parandused + transients cleanup

WooCommerce parandab jõudlusprobleemi, mis oli seotud Product Filters’i cache-andmetega: need ei olnud varem korrektselt setitud ja laetud ning tulemuseks võis olla, et andmebaas „ujutatakse üle” filtri cache’iga. 10.5 muudatus tagab, et suurte kataloogidega poodide jõudlust see enam ei mõjutaks.

Lisaks uuendatakse WooCommerce transients cleanup tool’i, et see puhastaks käivitamisel ka filtri andmete cache’i. Samas on oluline diagnostika-detail: kui kliendid kasutavad Product Filters plokki ja kogevad endiselt jõudlusprobleeme, võib põhjus olla just selles ning lahendusena soovitatakse puhastada WooCommerce transients. Tehniline viide: #62575.

Changelog ja beeta testimine

Täielik muudatuste nimekiri on WooCommerce’i readme.txt changelog’is (beeta branch’i pealt): https://github.com/woocommerce/woocommerce/blob/10.5.0-beta.1/plugins/woocommerce/readme.txt

Beeta testimiseks on ametlik tee WooCommerce Beta Tester plugin. Eriti mõistlik on testida, kui sinu lahendus puudutab ühte neist piirkondadest: Analytics (reporting), tellimuse maksude käsitlemine, Checkout block, REST API integratsioonid, permalingi struktuurid, variable product UX, või jõudluse optimeerimine (cache, filtrid).

Kokkuvõte: mida 10.5 puhul esimesena üle kontrollida

1. Kui sul on suur tellimuste maht, jälgi Analyticsi andmete uuenemise käitumist: Scheduled Imports (12h intervall, 100 orderit partii kohta) ning vajadusel filtreid woocommerce_analytics_import_interval ja woocommerce_analytics_regenerate_batch_size.
2. Kui sul on Checkout block’i kohandusi (shipping UI, pickup/ship toggle), testi mitme package’iga ostukorve (sh subscription-tooted).
3. Kui töötled või migreerid tellimuste maksude andmeid, arvesta tagurpidi ühilduva konversiooniga ja filtriga woocommerce_order_item_legacy_tax_conversion.
4. Kui sinu plugin lisab Select2 põhiseid UI osi, kontrolli, et stiilid ei sõltu WooCommerce’i globaalsetest reeglitest (nüüd scope’itud :where(.woocommerce) alla).
5. Kui oled teinud eriloogika tarne maksustamiseks, vaata üle uus woocommerce_shipping_tax_class filter.
6. Kui sul on REST API klientkood, kontrolli variation attribute’ide special character decoding’u mõju.
7. Kui mõni kood kasutab Internal namespace’i asju (nt AccessiblePrivateMethods), eemalda sõltuvus enne 10.5 peale minekut.
8. Kui kasutad kategoorial põhinevaid product permalink’e, testi URL-i genereerimist (deepest category prioriteet).
9. Kui suur kataloog + Product Filters plokk, jälgi cache’i käitumist ja vajadusel kasuta transients cleanup’i.