WooCommerce 10.5: što se mijenja za developere i na što pripaziti prije upgradea

WooCommerce 10.5 je pred vratima i, barem iz developerske perspektive, ovo nije “još jedan minor release”. Fokus je vrlo jasan: manje opterećenja na ActionScheduleru i bazi, stabilniji edge caseovi (porezi), čišći CSS utjecaj na ostatak admina/fronta te nekoliko promjena koje mogu zakačiti ekstenzije koje su se oslanjale na interne detalje.

U nastavku je pregled onoga što je najvažnije za web shopove koji rade na prometnim instalacijama, za timove koji grade ekstenzije i za sve koji imaju custom checkout/SEO/permalink logiku.

Raspored izdanja (i kako testirati)

• Feature Freeze je započeo 12. siječnja 2026.
• WooCommerce 10.5 Beta 1 je objavljen 19. siječnja 2026.
• WooCommerce 10.5 Beta 2 je objavljen 26. siječnja 2026.
• Finalni release je zakazan za 4. veljače 2026.

Za testiranje beta verzija preporučeni put je službeni WooCommerce Beta Tester plugin, koji ti omogućuje instalaciju beta buildova bez ručnog “petljanja” po paketima.

Što dolazi u WooCommerce 10.5 (ključne developerske promjene)

1) Velika promjena: import narudžbi u Analytics tablice prelazi na Scheduled Imports

Najveća i najkonkretnija promjena u 10.5 je temeljno poboljšanje načina na koji WooCommerce importira order podatke u Analytics tablice.

Do sada je WooCommerce za praktički svaki “order event” okidao analytics import job preko ActionSchedulera. Iako je to asinkrono, na busy siteovima je u praksi završavalo ogromnim backlogsima (često 10.000+ akcija), što onda povlači degradaciju performansi, jaču kontenciju u bazi i općenita usporavanja.

U 10.5, default postaje Scheduled Imports: batch procesiranje koje osvježava analytics podatke svakih 12 sati i obrađuje 100 narudžbi po batchu.

Oba parametra su prilagodljiva kroz nove filtere:

• woocommerce_analytics_import_interval (interval osvježavanja)
• woocommerce_analytics_regenerate_batch_size (veličina batcha)

Bitna posljedica: drastično se smanjuje broj scheduled akcija i opterećenje baze, a vlasnici shopova dobivaju jasniji uvid u status importa i mogućnost ručnog pokretanja importa kad god treba. Referenca: #61603.

2) Checkout block: shipping opcije dobivaju jasniji UI (thumbnaili, paketi) + bugfix synca

Checkout block dobiva poboljšan prikaz shipping opcija, posebno u scenarijima gdje postoji više paketa (npr. subscription proizvodi). UI sada može prikazivati thumbnailove proizvoda i vizualno odvojene (bordered) kontejnere za pakete.

Uz to, ispravljen je bug gdje se shipping metode nisu ispravno sinkronizirale pri prebacivanju između “Ship” i “Pickup” opcija dostave. Referenca: #61625.

3) Robusnije prikazivanje narudžbi s legacy/korumpiranim tax podacima

Ako si ikad naletio na narudžbe s “čudnim” poreznim podacima (npr. tax vrijednosti spremljene kao float/string umjesto arraya), 10.5 uvodi pouzdanije, unatrag kompatibilno rukovanje tim slučajevima.

Fix pokriva sve tipove order itema (proizvodi, shipping, fees), pokušava inteligentno zaključiti tax rate ID-eve iz konteksta narudžbe i dodaje filter woocommerce_order_item_legacy_tax_conversion za custom konverzijsku logiku ako ti treba specifično ponašanje u ekstenziji. Referenca: #62271.

4) Select2 CSS: stilovi su sada scopeani da ne “curi” u druge pluginove

WooCommerce stilovi za Select2 (popularna JS komponenta za napredne select dropdownove) sada su scopeani kroz :where(.woocommerce) kako ne bi utjecali na sučelja drugih pluginova.

Ovo je dobar kompromis jer :where() pseudo-klasa zadržava nultu specifičnost, pa postojeći custom overrideovi (ako si ih već imao) ne bi trebali iznenada prestati raditi, dok se istovremeno smanjuje “kolateralna šteta” na admin ekranima. Referenca: #61956.

5) Novi filter woocommerce_shipping_tax_class za dinamičko računanje poreza na dostavu

Uveden je novi filter woocommerce_shipping_tax_class koji otvara mogućnost dinamičkog izračuna poreznih stopa za dostavu na temelju sadržaja košarice, podataka o kupcu i lokacije.

Ovo omogućuje implementaciju pravila poput “shipping tax prati dominantnu stopu u košarici” te rješavanje kompleksnijih tax scenarija (u objavi se kao primjer spominju zahtjevi poput onih u Nizozemskoj). Referenca: #59512.

API promjene i developerske napomene (advisories)

Uz core promjene, 10.5 povlači i nekoliko “advisory” tema koje se isplati pročitati ako radiš s REST API-jem, oslanjaš se na interne namespaceove ili imaš custom permalink setup.

• WC REST API sada ispravno hendla decoding special karaktera za atribute varijacija proizvoda. Detalji: https://developer.woocommerce.com/2026/01/14/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5/
• Trait AccessiblePrivateMethods će biti uklonjen. Bio je dio Internal namespacea kao jasan signal da nije namijenjen javnom korištenju; ekstenzije koje su ga pogrešno koristile mogu puknuti. Detalji: https://developer.woocommerce.com/2026/01/15/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5/
• Promjene u product permalinkovima baziranim na kategorijama: prioritet dobiva najdublja kategorija radi boljeg SEO-a i konzistentnosti URL-ova, ali utječe samo na specifične permalink strukture. Detalji: https://developer.woocommerce.com/2026/01/13/product-permalink-changes-coming-in-woocommerce-10-5/
• Na stranicama varijabilnih proizvoda gumb Add to Cart je sada disabled dok se variation script u potpunosti ne učita. Na sporijim vezama korisnici su ranije mogli kliknuti prije inicijalizacije logike odabira varijacije, što je vodilo u failed submit. Detalji: https://developer.woocommerce.com/2026/01/16/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5/

Performance poboljšanja u 10.5

Eksperimentalni REST API cache (primjenjiv na bilo koji endpoint)

WooCommerce 10.5 uvodi novi eksperimentalni REST API cache koji se može primijeniti na bilo koji endpoint u WC REST API-ju. Prema najavi, više informacija (uključujući kako testirati) dolazi bliže samom 10.5 releaseu.

Cached variation prices: poboljšanja + utility klasa za callbackove

Poboljšano je i cacheiranje cijena varijacija, uz dodavanje nove utility klase za rad s callbackovima. Detalji: https://developer.woocommerce.com/2026/01/08/variation-prices-caching-improvements-in-woocommerce-10-5/

Eksperimentalni Product Object Caching

Uveden je i eksperimentalni Product Object Caching: tijekom jednog requesta WooCommerce može cacheirati instance proizvoda kako bi spriječio ponovna učitavanja istog proizvoda iz baze. To je posebno korisno na stranicama gdje se isti proizvod “provuče” kroz više komponenti i hookova.

Implementacija je dostupna kroz PR: https://github.com/woocommerce/woocommerce/pull/62041, a dodatni kontekst je ovdje: https://developer.woocommerce.com/2026/01/19/experimental-product-object-caching-in-woocommerce-10-5/

Product Filters: popravci oko cache podataka + čišćenje transienta

Ispravljeni su i performance problemi gdje se cache podaci Product Filtersa nisu ispravno postavljali i učitavali. U praksi je to moglo dovesti do “floodanja” baze cache zapisima i degradacije performansi na shopovima s velikim katalozima.

Ažuriran je i WooCommerce alat za cleanup transienta tako da pri pokretanju čisti i filter data cache. Ako koristiš Product Filters block i i dalje vidiš performance probleme, jedan od mogućih uzroka je upravo ovaj cache, a predloženo rješenje je čišćenje WooCommerce transienta. Referenca: #62575.

Brzi check: što bih testirao prije produkcijskog upgradea

1. Ako imaš veliki promet, provjeri ponašanje Analyticsa nakon prelaska na Scheduled Imports (interval i batch size po potrebi prilagodi filterima woocommerce_analytics_import_interval i woocommerce_analytics_regenerate_batch_size).
2. Ako koristiš Checkout block i imaš subscription scenarije ili više paketa, prođi kroz shipping/pickup toggle i provjeri da UI i sync rade očekivano.
3. Ako imaš povijesne narudžbe migrirane iz drugih sustava, otvori nekoliko “problematičnih” narudžbi i potvrdi da porezni podaci ne ruše prikaz; po potrebi se zakači na woocommerce_order_item_legacy_tax_conversion.
4. Ako si customizirao admin/front Select2, provjeri je li ti neko sučelje ranije implicitno ovisilo o WooCommerce Select2 CSS-u izvan .woocommerce scopea.
5. Ako radiš kompleksniji tax setup za dostavu, isprobaj woocommerce_shipping_tax_class i provjeri pokriva li pravila koja si ranije rješavao ručno.
6. Ako tvoja ekstenzija koristi interne WooCommerce detalje, posebno Internal namespace, provjeri ovisnost o AccessiblePrivateMethods traitu.
7. Ako radiš s permalink strukturom “po kategorijama”, testiraj generiranje URL-ova i redirekcije, posebno gdje postoji više kategorija različite dubine.
8. Na sporijim mrežama testiraj variable product page: Add to Cart je sada disablean dok se skripta ne učita – provjeri da ti custom JS/UI ne očekuje drugačiji flow.
9. Ako koristiš REST API intenzivno, pripazi na promjene oko dekodiranja special karaktera u atributima varijacija, te isprobaj eksperimentalni REST API cache kad upute budu dostupne.
10. Ako koristiš Product Filters block na velikom katalogu, nakon upgradea provjeri DB opterećenje i po potrebi pokreni cleanup WooCommerce transienta.

Changelog i službene reference

Kompletan changelog za 10.5 beta granu dostupan je ovdje: https://github.com/woocommerce/woocommerce/blob/10.5.0-beta.1/plugins/woocommerce/readme.txt