WooCommerce 10.5 kehittäjille: ajastetut Analytics-importit, Checkout-lohkon parannukset ja uusia suodattimia veroihin

WooCommerce 10.5 on tulossa pian, ja jos ylläpidät vilkasta kauppaa tai kehität laajennuksia/teemoja WooCommercen päälle, tässä versiossa on useita kohtia, jotka kannattaa huomioida jo ennen päivitystä. Isoin yksittäinen muutos liittyy siihen, miten tilausdata siirtyy Analytics-tauluihin – ja se osuu suoraan suorituskykyyn, ActionScheduler-kuormaan ja tietokantapaineeseen.

Julkaisuaikataulu (Beta → lopullinen)

• WooCommerce 10.5 Beta on saatavilla testaukseen.
• Feature Freeze alkoi maanantaina 12.1.2026.
• WooCommerce 10.5 Beta 1 julkaistiin 19.1.2026.
• WooCommerce 10.5 Beta 2 julkaistiin 26.1.2026.
• Lopullinen julkaisu on aikataulutettu: 4.2.2026.

Beta-versioita voi testata WooCommercen oman WooCommerce Beta Tester plugin -lisäosan avulla. Tämä on käytännössä helpoin tapa tarkistaa, osuuko mikään muutos juuri teidän koodiin tai kaupan konfiguraatioon.

Mitä uutta WooCommerce 10.5:ssa on tulossa

1) Analytics-importti uusiksi: Scheduled Imports oletukseksi

WooCommerce 10.5:n merkittävin muutos on perustavanlaatuinen parannus siihen, miten WooCommerce tuo tilaustietoja Analytics-tauluihin. Aiemmin jokainen tilaustapahtuma laukaisi oman analytics-importtityön ActionSchedulerin kautta. Vaikka malli on asynkroninen, kiireisissä kaupoissa se johti käytännössä valtaviin ActionScheduler-jonoihin (tyypillisesti 10 000+ ajastettua actionia), mikä aiheutti selviä suorituskykyongelmia, tietokantakontentiota ja sivuston hidastumista.

Tässä julkaisussa WooCommerce ottaa oletukseksi Scheduled Imports -mallin: Analytics-data päivitetään erissä 12 tunnin välein, ja käsittely tapahtuu 100 tilauksen batch-kokoisina paloina. Molemmat ovat räätälöitävissä uusien filttereiden avulla:

• woocommerce_analytics_import_interval (importin ajastusväli)
• woocommerce_analytics_regenerate_batch_size (batch-koko eli montako tilausta per erä)

Käytännön vaikutus: ajastettujen actionien määrä ja tietokantakuorma tippuvat selvästi, mutta kauppiaalle jää silti näkyvyys importin tilaan ja mahdollisuus käynnistää importteja myös manuaalisesti tarpeen mukaan. (Viite: #61603)

2) Checkout-lohko: shipping-vaihtoehtojen UI fiksummaksi useissa paketeissa

Checkout blockin (lohkopohjaisen kassasivun) toimitusvaihtoehtojen käyttöliittymää parannetaan tilanteisiin, joissa tilaus jakautuu useisiin paketteihin – erityisesti subscription-tuotteiden yhteydessä. Uudistuksessa toimitusvaihtoehdoissa näytetään tuotteen thumbnail-kuvat ja vaihtoehdot ryhmitellään reunustettuihin konteihin, kun paketteja on useampi.

Samassa yhteydessä korjataan bugi, jossa toimitustavat eivät synkronoituneet oikein, kun käyttäjä vaihtoi Ship- ja Pickup-toimitusvalintojen välillä. (Viite: #61625)

3) Luotettavampi tilausten katselu legacy-/korruptoituneella verodatalla

WooCommerce 10.5 parantaa tilausten tarkastelun luotettavuutta tilanteissa, joissa vanha tai korruptoitunut verodata on tallentunut epätyypillisessä muodossa (esim. tax-arvot float/string, vaikka odotetaan array-rakennetta).

Korjaus lisää taaksepäin yhteensopivan käsittelyn kaikkiin order item -tyyppeihin (tuotteet, toimitus, maksut/fees), päättelee veroprosenttien/tax rate ID:t tilauksen kontekstista ja tarjoaa lisäksi uuden filtterin, jos haluat toteuttaa oman konversiologiikan:

• woocommerce_order_item_legacy_tax_conversion

Tämä on erityisen tärkeä niille, joilla on pitkään elänyt kauppa, migraatioita tai custom-koodia verojen ympärillä. (Viite: #62271)

4) Select2-tyylien skooppaus: ei enää vuotoa muiden lisäosien näkymiin

WooCommercen lataamat Select2-tyylit skoopataan nyt niin, etteivät ne vuoda muiden lisäosien käyttöliittymiin. Tämä tehdään :where(.woocommerce) -valitsimen avulla.

Oleellinen yksityiskohta: :where()-pseudo-luokka säilyttää nollaspesifisyyden, joten olemassa olevien custom-ylikirjoitusten (overrides) ei pitäisi rikkoutua, mutta samalla WooCommercen Select2-CSS ei enää sotke muiden pluginien UI:ta. (Viite: #61956)

5) Uusi woocommerce_shipping_tax_class -filtteri: dynaamisempi toimitusveron laskenta

WooCommerce 10.5 tuo uuden filtterin woocommerce_shipping_tax_class, jonka avulla toimituksen verokannan (shipping tax) voi laskea dynaamisesti ostoskorin sisällön, asiakastiedon ja sijainnin perusteella.

Tämä mahdollistaa esimerkiksi logiikan, jossa toimitusvero määräytyy korin vallitsevan (predominant) verokannan mukaan. Ratkaisu on suunniteltu joustavaksi monimutkaisiin vero-skenaarioihin, kuten sellaisiin, joita tarvitaan esimerkiksi Alankomaissa. (Viite: #59512)

API-muutokset ja kehittäjähuomiot (advisories)

10.5 sisältää myös joukon muutoksia, joista on julkaistu erillisiä kehittäjähuomioita. Tässä tiivis, mutta käytännössä tärkeä lista – näissä kohdissa kannattaa klikata suoraan alkuperäisiin kirjoituksiin, jos ylläpidät integraatioita tai laajennuksia:

• WC REST API käsittelee nyt oikein special character -merkkien dekoodauksen product variation -attribuuteissa. Lisätiedot: https://developer.woocommerce.com/2026/01/14/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5/
• AccessiblePrivateMethods trait poistuu. Se kuului Internal-namespaceen nimenomaan signaaliksi siitä, ettei sitä ole tarkoitettu julkiseen käyttöön. Tämä voi vaikuttaa lisäosiin, jotka ovat käyttäneet traitia virheellisesti. Lisätiedot: https://developer.woocommerce.com/2026/01/15/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5/
• Kategoriapohjaiset product permalinkit päivittyvät: syvin (deepest) kategoria priorisoidaan paremman SEO:n ja URL-konsistenssin vuoksi. Muutos koskee vain tiettyjä permalink-rakenteita. Lisätiedot: https://developer.woocommerce.com/2026/01/13/product-permalink-changes-coming-in-woocommerce-10-5/
• Variable product -sivuilla Add to Cart -nappi pidetään nyt disabled-tilassa, kunnes variation script on latautunut. Tämä estää tilanteen, jossa hitaalla yhteydellä käyttäjä ehtii klikata lisää ostoskoriin ennen kuin variaatioiden valintalogiikka on valmis, mikä aiemmin saattoi johtaa epäonnistuneeseen submitiin. Lisätiedot: https://developer.woocommerce.com/2026/01/16/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5/

Suorituskykyparannukset 10.5:ssa

Uusi kokeellinen REST API -cache

WooCommerce 10.5 tuo uuden kokeellisen (experimental) REST API cache -mekanismin, jonka voi ottaa käyttöön mihin tahansa WC REST API:n endpointiin. Julkaisun yhteydessä on luvassa tarkempaa ohjeistusta testaukseen ja käyttöönottoon; toistaiseksi tiedossa on, että cache on suunniteltu yleiskäyttöiseksi endpoint-tasolla.

Variation prices -cachen parannukset + uusi callback-utility

Cached variation prices -toiminnallisuuteen on tehty parannuksia, ja lisäksi mukaan tulee uusi utility-luokka callbackien kanssa työskentelyyn. Taustaa ja yksityiskohdat: https://developer.woocommerce.com/2026/01/08/variation-prices-caching-improvements-in-woocommerce-10-5/

Kokeellinen Product Object Caching (per request)

10.5 esittelee myös kokeellisen Product Object Caching -ominaisuuden, jossa tuote-instansseja cachetetaan yhden requestin aikana, jotta samaa tuotetta ei ladattaisi tietokannasta moneen kertaan. Tämä voi tuoda selviä hyötyjä etenkin sivuilla, joilla samalla pyynnöllä kosketaan useisiin tuotteisiin useissa kohdissa. PR: https://github.com/woocommerce/woocommerce/pull/62041 ja lisätaustoitus: https://developer.woocommerce.com/2026/01/19/experimental-product-object-caching-in-woocommerce-10-5/

Product Filters -cache: korjaus väärin asetettuun/ladattuun cache-dataan

WooCommerce 10.5 korjaa myös Product Filters -toiminnallisuuden cache-dataan liittyviä suorituskykyongelmia, joissa data ei aiemmin asettunut tai latautunut oikein. Ongelma saattoi johtaa siihen, että tietokanta täyttyi suodattimien cache-datasta ja isojen katalogien kauppojen suorituskyky heikkeni.

Samalla WooCommercen transients cleanup tool päivitetään niin, että se tyhjentää myös filter data cache -datan ajon yhteydessä. Huomio: jos asiakkaat käyttävät Product Filters -lohkoa ja suorituskykyongelmat jatkuvat, tämä voi olla taustasyy – ja käytännön ratkaisu on WooCommerce transientsien siivous. (Viite: #62575)

Changelog

Täysi muutosloki löytyy GitHubista readme.txt-tiedostona: https://github.com/woocommerce/woocommerce/blob/10.5.0-beta.1/plugins/woocommerce/readme.txt

Pikachecklist kehittäjälle ennen päivitystä

1. Testaa Beta (tai vähintään stagingissa) WooCommerce Beta Tester pluginilla: https://woocommerce.com/products/woocommerce-beta-tester/
2. Jos kaupassa on ollut ActionSchedulerin jono-ongelmia, seuraa 10.5:n Scheduled Imports -käyttäytymistä ja arvioi tarve säätää woocommerce_analytics_import_interval– ja woocommerce_analytics_regenerate_batch_size-filttereitä.
3. Jos laajennus on käyttänyt mitään Internal-nimenavaruudesta (erityisesti AccessiblePrivateMethods trait), varmistu että riippuvuus poistuu ennen 10.5:ttä.
4. Jos tuotat/parsisit variaatioattribuutteja REST API:n kautta, tarkista special character -dekoodausmuutos ja sen vaikutus integraatioihin.
5. Jos teet CSS-ylikirjoituksia Select2:lle WooCommercen adminissa tai omissa näkymissä, varmista että :where(.woocommerce)-skooppaus ei muuta oletuksia (spesifisyys pysyy nollassa, mutta scope on tiukempi).
6. Jos toimitusveron laskenta vaatii maakohtaista logiikkaa, arvioi uusi woocommerce_shipping_tax_class -filtteri.
7. Jos kaupassa on iso katalogi ja Product Filters -lohko käytössä, pidä silmällä cache-korjauksen vaikutusta ja tarvittaessa aja transientsien siivous.