WooCommerce 10.5: kas mainās izstrādātājiem un ko pārbaudīt pirms relīzes

WooCommerce 10.5 relīze ir tuvumā, un šoreiz izmaiņu sarakstā ir vairākas lietas, kas reāli ietekmē gan veiktspēju, gan integrāciju uzvedību. Ja uzturi veikalu ar lielu pasūtījumu plūsmu vai būvē paplašinājumus, kas pieskaras analītikai, nodokļiem, REST API vai Checkout blokiem, 10.5 ir versija, ko nevajadzētu “palaist garām” bez testēšanas.

Zemāk apkopoju, kas tieši nāk 10.5, kāpēc tas ir svarīgi izstrādātājiem un kur ir iespējamie saderības “asas stūri”.

Relīzes grafiks un testēšana

• Feature Freeze sākās: 2026. gada 12. janvārī
• WooCommerce 10.5 Beta 1: izlaista 2026. gada 19. janvārī
• WooCommerce 10.5 Beta 2: izlaista 2026. gada 26. janvārī
• WooCommerce 10.5 stabilā relīze: plānota 2026. gada 4. februārī

Testēšanai paredzēts izmantot oficiālo WooCommerce Beta Tester spraudni, kas ļauj ērti uzlikt beta versijas bez manuālas ZIP instalēšanas.

Kas konkrēti nāk WooCommerce 10.5

1) Analītikas pasūtījumu importa mehānisma pārbūve (Scheduled Imports pēc noklusējuma)

Lielākais un praktiski jūtamākais jaunums ir fundamentāla izmaiņa tajā, kā WooCommerce ielādē pasūtījumu datus Analytics tabulās. Līdz šim pie katra pasūtījuma notikuma WooCommerce caur ActionScheduler palaida analītikas importa darbu. Teorētiski tas bija asinhroni un “droši”, bet praksē aizņemtos veikalos tas ļoti ātri uzkrāja milzīgus ActionScheduler backlogus (piemēram, 10 000+ darbību), kas rezultējās ar nopietnu veiktspējas kritumu, datubāzes contention un kopēju lapas palēninājumu.

WooCommerce 10.5 pēc noklusējuma pāriet uz Scheduled Imports pieeju: analītikas dati tiek atjaunoti partijās (batch processing) ar noteiktu intervālu, nevis “katrs notikums → atsevišķs scheduled action” režīmā.

• Atjaunošanas intervāls: ik pēc 12 stundām
• Apstrādes apjoms: 100 pasūtījumi vienā batch
• Intervāls ir pielāgojams ar filtru woocommerce_analytics_import_interval
• Batch izmērs ir pielāgojams ar filtru woocommerce_analytics_regenerate_batch_size
• Mazāk scheduled actions, mazāka slodze uz DB, vienlaikus veikala īpašniekam ir skaidrāka redzamība par statusu un iespēja importu palaist manuāli jebkurā brīdī

Tehniski tas nozīmē, ka, ja tavs spraudnis balstās uz biežu vai “gandrīz reāllaika” Analytics datu atjaunošanu, 10.5 uzvedība var atšķirties no tā, ko tu līdz šim netieši pieņēmi. Ja vajadzīgs cits ritms, tagad ir oficiāli filtri, ar kuriem to korekti pielāgot. Saistītais PR: #61603.

2) Checkout bloka piegādes opciju UI uzlabojumi (īpaši vairākiem sūtījumu “package” gadījumiem)

Checkout blokā piegādes opciju interfeiss ir uzlabots situācijās, kad tiek izveidoti vairāki “packages” (piemēram, tipiski abonēšanas produktiem). Tagad piegādes izvēlē var parādīties produktu sīktēli (thumbnails) un vizuāli atdalīti konteineri ar apmalēm, ja ir vairāki sūtījumi.

Papildus tam ir salabota kļūda, kur piegādes metodes ne vienmēr korekti sinhronizējās, pārslēdzoties starp “Ship” un “Pickup” piegādes veidiem. Saistītais PR: #61625.

3) Stabilāka pasūtījumu attēlošana ar “legacy” vai bojātiem nodokļu datiem

Reālajā pasaulē joprojām gadās pasūtījumi ar vēsturisku vai korumpētu nodokļu (tax) struktūru, kur nodokļu vērtības saglabātas kā float vai string, nevis kā masīvi. WooCommerce 10.5 šādos gadījumos uzlabo uzticamību, lai pasūtījumu skatā nerastos kļūdas un dati tiktu apstrādāti pēc iespējas korekti.

Labojums ir veidots ar backwards-compatible pieeju un attiecas uz visiem order item tipiem (produkti, piegāde, fees). Sistēma arī mēģina “inteliģenti” atvasināt tax rate ID no pasūtījuma konteksta.

Izstrādātājiem svarīgākais: pievienots filtrs woocommerce_order_item_legacy_tax_conversion, lai nepieciešamības gadījumā varētu ielikt savu konvertēšanas loģiku. Saistītais PR: #62271.

4) WooCommerce Select2 stili vairs “neiztek” citu spraudņu interfeisos

Ja esi kaut reizi debugojis, kāpēc kāda cita spraudņa admin UI pēkšņi izskatās “kā WooCommerce”, tad šis ir patīkams jaunums. WooCommerce ielādētie Select2 stili tagad tiek scopo-ti ar :where(.woocommerce), lai tie neietekmētu citas saskarnes ārpus WooCommerce konteksta.

Svarīga nianse: :where() pseido-klase saglabā nulles specifiskumu, tāpēc esošie custom override risinājumi (CSS pārrakstīšana) turpina strādāt, bet vienlaikus tiek samazināts risks nejauši salauzt citu spraudņu UI. Saistītais PR: #61956.

5) Jauns filtrs dinamiskam piegādes nodoklim: woocommerce_shipping_tax_class

WooCommerce 10.5 ievieš jaunu filtru woocommerce_shipping_tax_class, kas ļauj dinamiski aprēķināt piegādes nodokļa (shipping tax) likmi, balstoties uz groza saturu, klienta datiem un atrašanās vietu.

Praktiski tas dod iespēju implementēt sarežģītākus noteikumus, piemēram, aprēķināt piegādes nodokli pēc grozā dominējošās nodokļa likmes. Šāda elastība ir īpaši noderīga valstīs ar specifiskiem nodokļu scenārijiem (pieminēts Nīderlandes piemērs). Saistītais PR ir norādīts kā #59512 (pēc saites redzams PR #62040).

API izmaiņas un izstrādātāju brīdinājumi (advisories)

10.5 ietver arī vairākas izmaiņas, par kurām WooCommerce komanda publicējusi atsevišķus izstrādātāju skaidrojumus. Kopsavilkumā:

WC REST API: korekta special character decoding variāciju atribūtiem

WC REST API tagad korekti apstrādās special characters (īpašās rakstzīmes) decoding produktu variāciju atribūtiem. Ja tev ir integrācijas, kas veido/atjaunina variācijas ar ne-ASCII simboliem vai URL encoding niansēm, šis ir obligāts tests. Pilnais skaidrojums: https://developer.woocommerce.com/2026/01/14/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5/

Tiks noņemts AccessiblePrivateMethods trait (Internal namespace)

No WooCommerce 10.5 tiks izņemts AccessiblePrivateMethods trait. Tas atradās Internal namespace un bija skaidrs signāls, ka to nevajadzētu izmantot publiski. Ja kāds paplašinājums tomēr to bija paņēmis lietošanā, šī izmaiņa var izraisīt kļūdas. Pilnais skaidrojums: https://developer.woocommerce.com/2026/01/15/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5/

Produktu permalinki, kas balstīti uz kategorijām, tiks koriģēti (dziļākā kategorija kā prioritāte)

Permalinki, kas veidojas no kategorijām, tiks atjaunināti tā, lai prioritizētu dziļāko kategoriju. Mērķis: labāka SEO loģika un konsekventāki URL. Tas neattiecas uz visiem permalinku režīmiem, bet uz konkrētām permalink struktūrām (kā norādīts advisory). Detalizēti: https://developer.woocommerce.com/2026/01/13/product-permalink-changes-coming-in-woocommerce-10-5/

Variablo produktu lapās Add to Cart būs disabled līdz pilnībā ielādējas variation script

WooCommerce 10.5 nodrošina, ka variablo produktu lapās poga Add to Cart būs atspējota (disabled), līdz kamēr variāciju skripts ir pilnībā ielādējies. Iepriekš uz lēnākiem savienojumiem lietotājs varēja paspēt nospiest “Add to Cart” pirms variāciju izvēles loģika inicializējās, kas beidzās ar neveiksmīgiem submit mēģinājumiem. Detalizēti: https://developer.woocommerce.com/2026/01/16/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5/

Veiktspējas uzlabojumi 10.5

Eksperimentāls REST API cache (jebkuram endpoint)

WooCommerce 10.5 ievieš jaunu eksperimentālu REST API kešu, ko varēs piemērot jebkuram WC REST API endpoint. Detalizētāka informācija (tai skaitā kā testēt) ir solīta pirms 10.5 relīzes, bet jau pats fakts ir svarīgs: tas iezīmē virzienu uz sistemātiskāku API atbildes kešošanu, kas var būt būtisks ieguvums headless un integrāciju bagātām instalācijām.

Variāciju cenu kešošanas uzlabojumi + jauna utilītes klase callback darbam

Variāciju cenu (variation prices) kešošana saņēmusi uzlabojumus, un papildus pievienota jauna utilītes klase, kas palīdz darbā ar callbacks. Pilnais skaidrojums: https://developer.woocommerce.com/2026/01/08/variation-prices-caching-improvements-in-woocommerce-10-5/

Eksperimentāls Product Object Caching (kešo produktus vienas pieprasījuma izpildes laikā)

Vēl viens eksperimentāls virziens ir Product Object Caching: produkta objekti tiek kešoti katra request ietvaros, lai nepieļautu dublētu produktu ielādi no datubāzes. Tas ir īpaši aktuāli sarežģītos šablonos vai filtrēšanas/upsell scenārijos, kur vienā lapā var netīši notikt vairākas identiskas WC_Product ielādes.

Tehniskā izmaiņa: https://github.com/woocommerce/woocommerce/pull/62041, un papildu skaidrojums: https://developer.woocommerce.com/2026/01/19/experimental-product-object-caching-in-woocommerce-10-5/

Product Filters: kešatmiņas datu iestatīšanas/ielādes labojumi + transients cleanup uzlabojums

WooCommerce 10.5 uzlabo veiktspējas problēmas, kas saistītas ar Product Filters kešatmiņas datiem: iepriekš tie ne vienmēr tika korekti iestatīti un ielādēti, kas varēja novest pie datubāzes “applūdināšanas” ar filtru datu kešu. Tas ir īpaši sāpīgi veikaliem ar lieliem katalogiem.

Papildus ir atjaunināts WooCommerce transients cleanup rīks, lai, tam darbojoties, tiktu dzēsts arī filtru datu kešs. Vienlaikus ir izcelts ļoti praktisks diagnostikas punkts: ja klienti izmanto Product Filters bloku un joprojām jūt veiktspējas problēmas, iespējamais iemesls var būt tieši šis kešs, un risinājums ir WooCommerce transients iztīrīšana. Saistītais PR: #62575.

Ko es ieteiktu notestēt kā izstrādātājam

• Ja tev ir custom Analytics sinhronizācija: pārbaudi, kā Scheduled Imports (12h / 100 pasūtījumi batch) ietekmē datu aktualitāti, un vai tev vajag koriģēt ar woocommerce_analytics_import_interval vai woocommerce_analytics_regenerate_batch_size.
• Ja paplašinājums pieskaras Checkout bloka piegādes izvēlei: notestē vairāku packages scenārijus, kā arī pārslēgšanos starp Ship/Pickup.
• Ja strādā ar vēsturiskiem pasūtījumiem vai migrācijām: atver pasūtījumus ar “neglītiem” tax datiem un pārbaudi, vai nav regressions; ja vajag, izmanto woocommerce_order_item_legacy_tax_conversion.
• Ja admin pusē izmanto Select2 citos spraudņos: pārbaudi, vai WooCommerce CSS vairs neizmaina svešas saskarnes; un vai tavi WooCommerce override joprojām strādā ar :where(.woocommerce) scoping.
• Ja tev ir sarežģīti nodokļu noteikumi piegādei: izmēģini woocommerce_shipping_tax_class un pārliecinies, ka aprēķini korekti reaģē uz grozu/klientu/lokāciju.
• Ja uzturi REST API integrāciju ar variācijām: notestē atribūtus ar diakritiskajām zīmēm un citiem special characters (encoding/decoding).
• Ja front-endā ir custom variāciju UI: pārbaudi, kā Add to Cart disabled līdz variation script ielādei ietekmē tavu JS un UX.
• Ja lieto Product Filters bloku lielā katalogā: pārbaudi keša uzvedību pēc atjaunināšanas un, ja vajag, palaid transients cleanup.

Changelog un noderīgas saites

Pilnais 10.5 changelog (beta branch): https://github.com/woocommerce/woocommerce/blob/10.5.0-beta.1/plugins/woocommerce/readme.txt