WooCommerce 11.1 – Tilausten peruuttaminen, API-päivitykset ja muuta

WooCommerce 11.1 julkaistaan näillä näkymin tänään, 1. syyskuuta 2026. Tällä kertaa uusi versio tuo mukanaan EU:n alueella toimiville kauppiaille suunnattuja ominaisuuksia vaatimustenmukaisuuteen, API-työkaluja kehittäjille, korjauksia lohkoeditorin suorituskykyyn sekä kokeellisia ominaisuuksia.

Tässä artikkelissa nostamme esiin tärkeimmät ominaisuudet, seikat jotka kehittäjien kannattaa ottaa huomioon ynnä muita muutoksiin liittyviä seikkoja.

Tialusten peruuttamisoikeus

Jotta WooCommerce palvelisi EU:n alueella toimivia verkkokauppiaita (ja asiakkaita) paremmin, Woo 11.1 sisältää tilausten peruuttamisoikeuden sisäänrakennettuna ominaisuutena. Se tulee aktivoida käyttöön asetuksissa erikseen (WooCommerce > Asetukset > Edistynyt > Ominaisuudet).

Lisätietoja verkkokaupan peruuttamisoikeudesta (Kilpailu- ja kuluttajavirasto, kkv.fi).

  • Tilauksen peruminen: Asiakas voi pyytää tilauksen peruutusta erillisen sivun kautta (esim. /oma-tili/peruuta-tilaus/), kirjautumista ei vaadita.
  • Tilauksen tietojen hakeminen: Kun syötetty tilausnumero ja laskutussähköpostiosoite vastaavat olemassa olevaa tilausta, pyyntö liitetään suoraan tilaustietoihin muistiinpanona (note).
  • Jos tilaustietojen haku epäonnistuu: Pyynnöt, joille ei löydy vastaavaa tilausta, merkitään manuaalisesti tarkistettaviksi.
  • Kauppiasilmoitukset: Saat kauppiaana ilmoituksen saapuneesta peruutuspyynnöstä sekä sähköpostitse että WooCommercen hallintapaneelissa.

Lisätietoja peruuttamisoikeudesta ja muista kuluttajan oikeuksista löydät mm. EUR-Lex-portaalista.

Rajapintaparannukset

REST API -palautukset ovat nyt automaattisia, ja niitä pääsee myös esikatselemaan. Reitin /wc/v3/orders/{id}/refunds päätepiste tukee nyt compute_totals: true -parametria, joka ohjaa palvelinta käsittelemään monimutkaisen vero- ja tuotelaskentalogiikan automaattisesti. Lisäksi kehittäjät voivat esikatsella laskelmia käyttämällä seuraavaa uutta endpointia:

POST /wc/v3/orders/{id}/refunds/preview

Lisäksi WooCommerce Store APIin lisätään erillinen tarkistus loppusummille. Jotta vältetään poikkeamat kassan käyttöliittymän ja lopullisen veloitetun summan välillä, Store API:n kassapäätepisteet hyväksyvät nyt valinnaisen kokonaislukuparametrin expected_total. Jos palvelimen laskema loppusumma poikkeaa siitä, mitä asiakas näki, pyyntö epäonnistuu virheellä HTTP 409 Conflict, woocommerce_rest_checkout_total_mismatch.

Haluatko oppia lisää HTTP-tilakoodeista ja -virheistä? Lukaise aiemmin julkaistu blogikirjoituksemme, mitä nämä koodit ovat ja mitä ne kertovat.

Parannuksia suorituskykyyn

Onko Woo-verkkokaupallasi raskaita, hitaasti latautuvia sivuja? WooCommerce 11.1 saa ne latautumaan nopeammin näillä parilla päivityksellä:

1. Vähemmän tietokantapyyntöjä

Aiemmin WooCommerce teki erillisiä, toistuvia tietokantakyselyitä tuotemuunnelmille, hinnoille ja editorityökaluille (nk. $N+1$-ongelma). Nyt nämä tiedot haetaan tehokkaasti kerralla, mikä vähentää tarpeettomia tietokantapyyntöjä.

2. Fiksumpi lohkojen lataaminen

Jotta WooCommerce-sivusto olisi mahdollisimman kevyt, Gutenberg-lohkoja tai lohkomalleja ei enää ladata silloin kun niitä ei oikeasti renderöidä ruudulle, kuten AJAX-kutsujen tai API-pyyntöjen aikana.

    Hyvä tietää

    Jos tuotekuvauksesi sisältää WooCommerce-lohkoja, ne latautuvat silti automaattisesti tarvittaessa. Jos rakennat custom-lisäosaa, jonka täytyy ladata nämä lohkot jo varhaisessa vaiheessa, voit käyttää uutta filtteriä, woocommerce_should_register_blocks.

    Päivitykset sähköposteihin

    Haluatko WooCommerce-sähköposteihin rikkaampaa sisältöä? Lohkopohjainen sähköpostieditori saa lisää upotuksia. Myös sekä parannetun kontekstin suojauksen (escaping):

    • Lisää upotuksia: Voit nyt lisätä videoupotteita ja pikkukuvia YouTubesta, Vimeosta, VideoPressistä, TikTokista ja Dailymotionista sekä WordPressin omia linkkejä. Ääniupotukset pysyvät edelleen rajoitettuina, ja ei-tuetut upotukset antavat varoituksen editorissa.
    • Kontekstitietoiset personointitunnisteet: Mukautettujen personointitunnisteiden callbackit saavat nyt tiedon kohdesisällön tyypistä (HTML, plaintext tai href), mikä mahdollistaa asianmukaisen merkkien suojauksen (escaping) kontekstin mukaan. Tämä tarkoittaa, että erikoismerkit voidaan nyt suojata oikein ja automaattisesti, jotta linkit eivät rikkoudu ja sivustosi pysyy turvassa tietoturva-aukoilta (kuten XSS-haavoittuvuudelta).

    Kokeelliset ominaisuudet

    WooCommerce 11.1 sisältää myös kokeellisia ominaisuuksia (experimental) – ne täytyy vain aktivoida erikseen asetuksissa, jotta niitä pääsee kokeilemaan.

    Yksittäiset lohkoskriptit ja tyylit on nyt yhdistetty yhtenäisiksi koontitiedostoiksi (core bundles), mikä nopeuttaa editorin toimintaa huomattavasti vähentämällä verkkopyyntöjä jopa 91 % ja leikkaamalla latausten kokonaiskokoa lähes puolella. Varhainen tuki videoille tuotegallerioissa on myös lisätty testausta varten.

    Kehittäjille

    WooCommerce 11.1 -versiosta alkaen joukko pitkään käytössä olleita WooCommerce Admin -ominaisuuslippuja (mukaan lukien analytics, customize-store ja launch-your-store) poistetaan virallisesti käytöstä. Koska nämä ydinominaisuudet ovat nyt täysin vakaita ja käytössä oletuksena, WooCommerce lataa ne suoraan sen sijaan, että se tarkistaisi lippulähteitä kuten window.wcAdminFeatures tai Features::is_enabled().

    Muutoksella ei kuuluisi olla vaikutusta verkkokauppojen toimintaan. Legacy-tarkistuksille on rakennettu väliaikaisia yhteensopivuussiltoja, jotka antavat varoituksen deprekaatioista. Lisäosien kehittäjien tulee tarkistaa mukautettu koodi ja poistaa nämä tarpeettomat ominaisuusliput ennen kuin yhteensopivuussillat poistetaan kokonaan tulevassa versiossa. Lue lisää näistä muutoksista WooCommercen virallisesta blogista.

    Muut muutokset ja deprekaatiot

    Osa-alueTiedot
    REST APIis_rest_api_request() tunnistaa nyt ?rest_route= -kyselyparametrit, tuoden standardit URL-varamuodot linjaan siistien kestolinkkien (pretty permalinks) kanssa.
    Saavutettavuus (WCAG)Määränmuutospainikkeen DOM-järjestys on päivitetty vastaamaan sen visuaalista sijaintia (korjaus WCAG 1.3.2/2.4.3 -vaatimuksiin). Tiettyihin DOM-lapsi-indekseihin tukeutuvien teemojen tulee testata toimivuus uudelleen.
    DeprekaatiotProductGalleryUtils::get_product_gallery_image_count() on poistettu käytöstä, ja sen korvaa get_product_gallery_media_count().
    Tuotehakusearch_products() käärii nyt sisäiset OR-disjunktionsa sulkeisiin, mikä estää include-, exclude-, status- ja type-kyselyitä vuotamasta viereisiin kyselyryhmiin.
    Yksityiset API:tObjekti window.wc.wcEntities sisäiset entiteetit on poistettu julkisesta näkyvyydestä.
    ValuuttasymbolitMacaon pataca (MOP) päivitetty arvosta P arvoon MOP$; Sambian kwacha (ZMW) päivitetty arvosta ZK arvoon K.

    Täydelliset julkaisutiedot löytyvät WooCommercen virallisesta kehittäjäblogista.

    Seravo: WooCommercen suosittelemaa hostingia

    Tiesitkö, että WooCommerce suosittelee Seravon premium-hostingia? Tutustu erityisesti WordPressille ja WooCommercelle optimoidulle webhotellille jo tänään. Sinä huolehdit vain liiketoiminnasta ja sisällöistä, me hoidamme loput!