WooCommerce 10.5: kaj se spreminja za razvijalce (in kaj testirati že zdaj)

WooCommerce 10.5 je tik pred izidom in je zanimiv predvsem zato, ker ne prinaša le nekaj manjših popravkov, ampak konkretno poseže v način uvoza podatkov za Analytics, izboljša UX v Checkout blocku, doda nov filter za davke pri dostavi in prinese nekaj API/razvojnih opozoril, ki lahko vplivajo na obstoječe razširitve.

Spodaj je povzetek najpomembnejših sprememb za razvijalce, skupaj z referencami na PR-je in uradne advisories objave, kjer je relevantno.

Časovnica izdaje (Release schedule) in testiranje

• Feature Freeze se je začel 12. januarja 2026.
• WooCommerce 10.5 Beta 1 je izšel 19. januarja 2026.
• WooCommerce 10.5 Beta 2 je izšel 26. januarja 2026.
• Končna izdaja (Release 10.5) je po načrtu 4. februarja 2026 (v objavi je omenjeno tudi, da je izdaja načrtovana za 3. februar 2026; kot veljavno časovnico upoštevaj “Scheduled: February 4, 2026” v razdelku Update timeline).

Za preizkus beta različic uporabi uradni vtičnik WooCommerce Beta Tester plugin. To je najhitrejši način, da na stagingu ujameš regresije v lastnih vtičnikih/temah, še preden verzija pride v produkcijo.

Kaj prinaša WooCommerce 10.5 (ključne funkcionalne spremembe)

1) Popolnoma prenovljen uvoz naročil v Analytics tabele

Največja sprememba v 10.5 je temeljna izboljšava uvoza order podatkov v Analytics tabele. Prej je WooCommerce za vsak “order event” sprožil analytics import job prek ActionSchedulerja. Čeprav je bil proces asinhron, je na bolj prometnih trgovinah povzročal ogromne vrste (tudi 10.000+ akcij), posledično pa padec zmogljivosti, contention na bazi in upočasnitve celotnega site-a.

V 10.5 WooCommerce privzeto preklopi na Scheduled Imports: analitika se osvežuje paketno (batch processing) na vsakih 12 ur, pri čemer se obdela 100 naročil na batch.

Obe vrednosti sta nastavljivi prek novih filtrov:

• woocommerce_analytics_import_interval – interval osveževanja (privzeto 12 ur).
• woocommerce_analytics_regenerate_batch_size – velikost batcha (privzeto 100 naročil na paket).

Pristop drastično zmanjša število scheduled akcij in obremenitev baze, hkrati pa naj bi lastnikom trgovin dal jasnejšo vidljivost statusa in možnost, da uvoz sprožijo ročno kadarkoli. Referenca: #61603.

2) Checkout block: bolj jasne možnosti dostave (tudi pri več paketih / naročninah)

Checkout block dobi izboljšan UI za shipping options: prikazujejo se thumbnaili produktov in “bordered containers”, ko je prisotnih več paketov (to je posebej relevantno pri subscription produktih).

V istem sklopu je popravljen tudi bug, kjer se shipping metode niso pravilno sinhronizirale pri preklapljanju med dostavo (Ship) in prevzemom (Pickup). Referenca: #61625.

3) Bolj robusten prikaz naročil z legacy ali pokvarjenimi tax podatki

Če si že kdaj podedoval trgovino z naročili, kjer so davki shranjeni “čudno” (npr. tax vrednosti kot float/string namesto array), potem veš, kako hitro lahko to razbije prikaz naročila ali računanje. V 10.5 je dodano bolj zanesljivo, backwards-compatible ravnanje s takimi primeri čez vse tipe order itemov: product, shipping in fees.

Popravek inteligentno sklepa tax rate ID-je iz konteksta naročila in doda filter woocommerce_order_item_legacy_tax_conversion, s katerim lahko razvijalci dodajo svojo konverzijsko logiko. Referenca: #62271.

4) Select2 CSS izolacija: WooCommerce stili naj ne “puščajo” v druge vtičnike

WooCommerce nalaga Select2 stile, ki so v preteklosti včasih nehote vplivali na UI drugih vtičnikov (ker je CSS selektor preširok). V 10.5 so ti stili scopeni z uporabo :where(.woocommerce).

Pomemben detajl: :where() pseudo-class ohrani ničelno specifičnost, zato naj obstoječi custom override-i še naprej delujejo, obenem pa WooCommerce CSS ne bi smel več prepisovati tujih admin vmesnikov. Referenca: #61956.

5) Nov filter woocommerce_shipping_tax_class za dinamične davke pri dostavi

Dodana je nova hook točka: filter woocommerce_shipping_tax_class. Namen je, da lahko davčno stopnjo za dostavo izračunaš dinamično glede na vsebino košarice, podatke o kupcu in lokacijo.

To omogoča kompleksnejše scenarije, npr. izračun davka na dostavo po prevladujoči davčni stopnji v košarici. V objavi je izpostavljeno, da je to uporabno tudi za specifične zahteve v nekaterih državah (primer: Nizozemska). Referenca v objavi: #59512.

API spremembe in razvojna opozorila (Developer advisories)

Poleg funkcionalnih sprememb 10.5 vključuje še nekaj pomembnih “advisories”, ki se tičejo kompatibilnosti. Tukaj je jedro (za detajle so spodaj povezave na uradne objave):

• WC REST API bo pravilno obravnaval dekodiranje posebnih znakov pri atributih variant (product variation attributes). To je relevantno, če uporabljaš npr. posebne znake v nazivih/slugih atributov in se zanašaš na REST integracije. Več: https://developer.woocommerce.com/2026/01/14/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5/
• Odstranjen bo trait AccessiblePrivateMethods. Nahajal se je v namespace-u Internal, kar je bil signal, da ni namenjen javni uporabi. Sprememba lahko vpliva na razširitve, ki so ga kljub temu uporabljale. Več: https://developer.woocommerce.com/2026/01/15/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5/
• Product permalinks, ki temeljijo na kategorijah, bodo posodobljeni: prednost bo imela najgloblja kategorija (deepest category), kar je relevantno za SEO in konsistentnost URL-jev. Vpliva samo na določene permalink strukture. Več: https://developer.woocommerce.com/2026/01/13/product-permalink-changes-coming-in-woocommerce-10-5/
• Na straneh variable productov bo gumb Add to Cart privzeto onemogočen, dokler se variation script ne naloži do konca. Namen je preprečiti klike na počasnejših povezavah, kjer logika za izbiro variacij še ni inicializirana, kar je prej povzročalo neuspešne oddaje. Več: https://developer.woocommerce.com/2026/01/16/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5/

Izboljšave zmogljivosti (Performance improvements)

Eksperimentalni REST API cache (novo)

WooCommerce 10.5 prinaša nov eksperimentalni REST API cache, ki ga bo mogoče uporabiti na kateremkoli endpointu v WC REST API. V času objave še ni polnih navodil za testiranje; omenjeni so kot “more information ahead of the 10.5 release”.

Boljše cache-anje cen variacij + utility class za callbacke

Izboljšan je tudi mehanizem cached variation prices in dodan je nov utility class za delo s callbacki. Podrobnosti: https://developer.woocommerce.com/2026/01/08/variation-prices-caching-improvements-in-woocommerce-10-5/.

Eksperimentalni Product Object Caching (novo)

Dodana je eksperimentalna funkcionalnost Product Object Caching, ki izboljša performance tako, da med posameznim requestom cache-a instance produktov in s tem prepreči podvojene loade produktov iz baze. Referenca PR: https://github.com/woocommerce/woocommerce/pull/62041. Podrobnejša objava: https://developer.woocommerce.com/2026/01/19/experimental-product-object-caching-in-woocommerce-10-5/.

Product Filters: popravek cache podatkov + posodobitev orodja za čiščenje transientov

Rešeni so problemi zmogljivosti pri cache podatkih za Product Filters, ki prej niso bili pravilno nastavljeni in nalagani. To je lahko povzročilo, da je baza dobila poplavo filter-data cache zapisov, kar je pri velikih katalogih konkretno vplivalo na hitrost.

Poleg popravka je posodobljeno tudi WooCommerce orodje za čiščenje transientov (transients cleanup tool), tako da ob zagonu počisti tudi filter-data cache. Če stranke uporabljajo Product Filters block in še vedno opažajo performance težave, je lahko vzrok prav ta cache, rešitev pa je čiščenje WooCommerce transientov. Referenca: #62575.

Changelog

Celoten changelog je v GitHub repozitoriju (beta veja): https://github.com/woocommerce/woocommerce/blob/10.5.0-beta.1/plugins/woocommerce/readme.txt.

Kratek checklist: kaj se splača preveriti na stagingu pred 10.5

1. Če uporabljaš/spreminjaš WooCommerce Analytics: preveri, kako Scheduled Imports vpliva na tvoj setup (interval, batch size, status prikaz) in ali imaš kje custom code, ki se je prej implicitno zanašal na import per order event.
2. Če imaš checkout prilagoditve: testiraj Checkout block pri več paketih (še posebej pri subscription produktih) in preklop med Ship/Pickup.
3. Če si kdaj obdeloval legacy tax strukture: preveri prikaz naročil z “nečistimi” podatki in po potrebi uporabi filter woocommerce_order_item_legacy_tax_conversion.
4. Če si v adminu ali frontendu uporabljal Select2 in si imel čudne CSS kolizije: preveri, ali se je z 10.5 situacija popravila (in ali se ti kakšen tvoj override še pravilno prime).
5. Če imaš kompleksne davčne scenarije za dostavo: preveri nov filter woocommerce_shipping_tax_class.
6. Če integriraš prek WC REST API: posebej preveri variante z atributi, ki vsebujejo posebne znake, in morebitne spremembe v dekodiranju.
7. Če uporabljaš interne WooCommerce trait-e ali utilite iz Internal namespace-a: odstrani odvisnosti od AccessiblePrivateMethods (ker se odstrani).
8. Če imaš custom permalink logiko ali SEO odvisnosti: preveri permalink strukture, ki uporabljajo kategorije, in kako se zdaj izbere “najgloblja kategorija”.
9. Na variable product straneh: preveri, ali tvoja tema ali custom JS pravilno sodeluje z dejstvom, da je Add to Cart gumb onemogočen do nalaganja variation skripte.
10. Če uporabljaš Product Filters block in imaš velik katalog: preveri obnašanje cache-a in po potrebi izvedi čiščenje transientov.