WooCommerce 11.0.1: sicurezza, WP 7.1 e API migliorate

Perché aggiornare a WooCommerce 11.0.1?

WooCommerce 11.0.1 è una dot release pensata per chi gestisce un negozio su WordPress e vuole mantenere la piattaforma al sicuro, compatibile con l’ultima versione di WordPress (7.1) e più reattiva nelle operazioni di checkout e reporting. L’aggiornamento non richiede modifiche al database, ma porta una serie di correzioni mirate che incidono direttamente su sicurezza, API, analytics e performance dei log.

---

Compatibilità con WordPress 7.1

• Liste e tabelle – Le liste di ordini e le tabelle dei prodotti ora rispettano il nuovo markup introdotto in WP 7.1, garantendo che le caselle di spunta e i layout responsivi funzionino senza regressioni.
• Test di CI – I test automatici per le liste di revisioni dei prodotti accettano sia il vecchio che il nuovo markup, così il codice rimane stabile durante la transizione.
• Script di amministrazione – Il test JavaScript della schermata “Aggiungi prodotto” è stato aggiornato per includere gli script wp-tooltip e wp-sync introdotti in WP 7.1, senza impatto sul comportamento in produzione.

Pratica: se il tuo sito è già su WP 7.1, l’aggiornamento a WooCommerce 11.0.1 elimina la necessità di patch manuali per le tabelle di amministrazione.

---

Aggiornamenti di sicurezza

1. Protezione delle descrizioni brevi – Le brevi descrizioni dei prodotti, anche quando inserite in blocchi o embed, sono ora coperte da password. L’utente deve inserire la password prima di visualizzare il contenuto.
2. Cookie di sessione più sicuri – I cookie per le sessioni ospite usano un algoritmo di hashing salato più robusto. I cookie legacy rimangono validi fino alla scadenza, così i carrelli non vengono persi durante l’upgrade.
3. Sanitizzazione dei messaggi di errore – I messaggi di errore restituiti dall’API Store sono ora sanitizzati, evitando l’esecuzione di markup potenzialmente pericoloso.

Impatto: riduce il rischio di vulnerabilità XSS e protegge i contenuti sensibili dei prodotti.

---

Correzioni al Store API

• Limiti dei coupon – L’API dei pagamenti ora rispetta correttamente i limiti di utilizzo dei coupon per gli ordini esistenti.
• Validazione dei token del carrello – I token vengono letti da una singola fonte della richiesta e validati prima di caricare la sessione cliente. Un nuovo rule di PHP_CodeSniffer avvisa gli sviluppatori se tentano di leggere direttamente il token.
• Shortcode [woocommerce_review_order] – Il shortcode restituisce contenuto solo quando la chiave ordine corrisponde a una pagina gestita da WooCommerce, evitando esposizioni accidentali.
• Etichette dei prodotti esterni – Le etichette dei pulsanti dei prodotti esterni passano attraverso la sanitizzazione del testo sia in REST API v1‑v4 che nel blocco “Product Button”.

Per gli sviluppatori: le modifiche non cambiano il flusso di lavoro, ma richiedono di aggiornare eventuali integrazioni personalizzate che leggono direttamente i token del carrello.

---

Validazione e miglioramenti degli analytics

• Esportazioni CSV – Prima di generare un CSV, i parametri report_args vengono confrontati con lo schema REST del report richiesto; valori orderby non supportati vengono rifiutati.
• Colonne di data – I report di ordine accettano solo colonne di data riconosciute (woocommerce_date_type o date_type). Valori sconosciuti ricadono su date_paid (per dati salvati) o su date_created (per richieste).

Beneficio pratico: le esportazioni non falliranno più a causa di parametri non validi, migliorando l’affidabilità dei flussi di lavoro di business intelligence.

---

Ottimizzazioni dei log e della performance di checkout

• Scansione log più leggera – La scrittura di un log non richiede più la scansione dell’intera cartella wc-logs. Il processo ora lavora in batch limitati, svuotando la coda finché non è vuota.
• Filtro di debug – Il filtro woocommerce_order_step_logging_enabled permette di disattivare il logging di debug per il checkout senza alterare la soglia globale di log.

Conseguenza: su negozi con migliaia di voci di log, il tempo di checkout si riduce sensibilmente, migliorando l’esperienza utente.

---

Come aggiornare

1. Backup – Esegui un backup completo di file e database, anche se la release non prevede aggiornamenti DB.
2. Aggiornamento – Dal pannello di amministrazione di WordPress, vai su Plugin → Aggiornamenti e installa la versione 11.0.1. In alternativa, scarica il pacchetto dal repository ufficiale e sovrascrivi i file.
3. Verifica – Controlla le pagine di amministrazione (Ordini, Prodotti, Impostazioni Pagamenti) per assicurarti che le nuove impostazioni si carichino correttamente.
4. Test – Esegui un ordine di prova, verificando che i cookie di sessione, i coupon e i log di checkout funzionino senza errori.

---

Cosa tenere d’occhio per il futuro

• Marketplace – L’attivazione di una sottoscrizione Marketplace ora richiede i permessi activate_plugins o switch_themes. Gli endpoint rifiutano tipi di prodotto non supportati.
• Installazione temi in onboarding – L’onboarding verifica il permesso install_themes; gli utenti senza tale capacità non potranno installare temi tramite il flusso di onboarding.
• Matching automatico di immagini per SKU – Richiede il permesso edit_product; gli upload non autorizzati non altereranno prodotti a cui l’utente non ha accesso.

Queste restrizioni rafforzano la sicurezza a livello di permessi, ma richiedono una revisione dei ruoli personalizzati se il tuo team utilizza account con privilegi ridotti.

---

Conclusioni operative

WooCommerce 11.0.1 è una release mirata: non introduce nuove funzionalità di front‑end, ma consolida la base del plugin con correzioni di sicurezza, compatibilità con WordPress 7.1 e ottimizzazioni che riducono i tempi di checkout. Per i gestori di negozi, l’aggiornamento è consigliato subito, soprattutto se si utilizza il Store API o si esportano regolarmente report analytics. Gli sviluppatori dovranno verificare le nuove regole di sanitizzazione e i permessi aggiuntivi, ma non dovrebbero incontrare rotture di compatibilità.

Fonti

• WooCommerce Developer Blog