O WooCommerce 10.5 entra na fase final com foco claro em reduzir carga desnecess\u00e1ria no servidor (especialmente em lojas com volume alto), corrigir arestas na experi\u00eancia de checkout e limpar alguns pontos que, na pr\u00e1tica, estavam a causar problemas de compatibilidade entre extens\u00f5es. Se mant\u00e9ns plugins\/integra\u00e7\u00f5es em cima do WooCommerce, esta \u00e9 uma vers\u00e3o para ler com aten\u00e7\u00e3o – h\u00e1 melhorias grandes de performance, novos filtros e alguns avisos que podem impactar c\u00f3digo existente.<\/p>\n\n\n\n
O ciclo do 10.5 foi marcado pelo Feature Freeze<\/em> a 12 de janeiro de 2026, e a partir da\u00ed entrou forte a fase de testes e estabiliza\u00e7\u00e3o.<\/p>\n\n\n\n Para testar as betas, a recomenda\u00e7\u00e3o oficial \u00e9 usar o WooCommerce Beta Tester plugin<\/a>, que facilita alternar entre vers\u00f5es beta sem ter de gerir ZIPs manualmente.<\/p>\n\n\n\n A mudan\u00e7a mais estrutural do WooCommerce 10.5 est\u00e1 na forma como os dados das encomendas s\u00e3o importados para as tabelas de Analytics. At\u00e9 aqui, cada evento de encomenda disparava um job de importa\u00e7\u00e3o via ActionScheduler. Mesmo sendo ass\u00edncrono, em lojas com tr\u00e1fego e volume altos isto gerava filas enormes (10.000+ actions), com degrada\u00e7\u00e3o s\u00e9ria de performance, conten\u00e7\u00e3o na base de dados e lentid\u00e3o generalizada do site.<\/p>\n\n\n\n No 10.5, o comportamento por defeito passa a ser Scheduled Imports<\/strong>: uma abordagem por lotes (batch processing) que refresca os dados de Analytics a cada 12 horas<\/strong> e processa 100 encomendas por batch<\/strong>. Ambos os valores s\u00e3o configur\u00e1veis por filtros novos:<\/p>\n\n\n\n O efeito pr\u00e1tico \u00e9 uma redu\u00e7\u00e3o dr\u00e1stica no n\u00famero de a\u00e7\u00f5es agendadas e na press\u00e3o sobre a base de dados. Al\u00e9m disso, h\u00e1 um ganho de clareza operacional para quem gere a loja: o estado das importa\u00e7\u00f5es fica mais vis\u00edvel e continua a ser poss\u00edvel disparar importa\u00e7\u00f5es manualmente quando necess\u00e1rio. (PR: #61603<\/a>)<\/p>\n\n\n\n Para quem usa o Checkout em blocos (block-based checkout), o 10.5 melhora a UI das op\u00e7\u00f5es de envio: quando existem m\u00faltiplos packages<\/em> (um cen\u00e1rio comum, por exemplo, com produtos de subscri\u00e7\u00e3o), as op\u00e7\u00f5es passam a apresentar thumbnails dos produtos<\/strong> e containers com borda<\/strong>, tornando a leitura e sele\u00e7\u00e3o mais \u00f3bvias.<\/p>\n\n\n\n A mesma entrega tamb\u00e9m corrige um bug relevante: ao alternar entre op\u00e7\u00f5es de entrega Ship<\/strong> e Pickup<\/strong>, os m\u00e9todos de envio nem sempre sincronizavam corretamente. (PR: #61625<\/a>)<\/p>\n\n\n\n Outra corre\u00e7\u00e3o que tende a salvar tempo de suporte: o WooCommerce 10.5 melhora a confiabilidade ao abrir encomendas antigas (ou com dados de impostos danificados) em que os valores de imposto estavam guardados como A solu\u00e7\u00e3o no core adiciona tratamento backwards-compatible<\/em> em todos os tipos de itens de encomenda (produtos, envios, taxas\/fees), tenta inferir IDs de taxas (tax rate IDs) com base no contexto da encomenda, e ainda exp\u00f5e um filtro para personalizar a convers\u00e3o:<\/p>\n\n\n\n (PR: #62271<\/a>)<\/p>\n\n\n\n Se j\u00e1 apanhaste interfaces de outros plugins \u201cmexidas\u201d por estilos do WooCommerce, esta \u00e9 para ti. No 10.5, os estilos do Select2 carregados pelo WooCommerce passam a estar scoped<\/em> de forma a n\u00e3o afetar outras \u00e1reas do wp-admin nem UI de terceiros, atrav\u00e9s de O detalhe importante aqui \u00e9 que O 10.5 introduz um filtro novo para suportar cen\u00e1rios de impostos mais complexos no c\u00e1lculo do envio: Isto abre espa\u00e7o para regras como \u201cusar a taxa predominante no carrinho para taxar o envio\u201d, o que \u00e9 \u00fatil em pa\u00edses\/mercados com regras espec\u00edficas (o post cita o caso dos Pa\u00edses Baixos\/Netherlands como exemplo de complexidade). (PR referenciado no post: #59512<\/a>)<\/p>\n\n\n\n Al\u00e9m das features principais, o 10.5 agrega um conjunto de mudan\u00e7as que foram detalhadas em posts pr\u00f3prios no blog de developers. Aqui fica o mapa do que merece valida\u00e7\u00e3o no teu c\u00f3digo.<\/p>\n\n\n\n A WC REST API passa a lidar corretamente com decoding de caracteres especiais<\/strong> em atributos de varia\u00e7\u00f5es de produto. Na pr\u00e1tica, isto reduz inconsist\u00eancias quando tens atributos com caracteres fora do \u201cASCII simples\u201d e integra\u00e7\u00f5es que dependem de valores est\u00e1veis na API.<\/p>\n\n\n\n Mais detalhes no advisory: https:\/\/developer.woocommerce.com\/2026\/01\/14\/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5\/<\/p>\n\n\n\n O trait AccessiblePrivateMethods<\/strong> vai ser removido. Ele vivia no namespace Advisory completo: https:\/\/developer.woocommerce.com\/2026\/01\/15\/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5\/<\/p>\n\n\n\n Para estruturas espec\u00edficas de permalink que usam categorias no URL do produto, o 10.5 vai ajustar a forma como a categoria \u00e9 escolhida: a prioridade passa a ser a categoria mais profunda<\/strong>. O objetivo \u00e9 melhorar SEO e consist\u00eancia dos URLs, mas isto pode alterar URLs gerados (e por consequ\u00eancia caches, regras de rewrite, ou integra\u00e7\u00f5es que assumiam uma categoria diferente).<\/p>\n\n\n\n Advisory: https:\/\/developer.woocommerce.com\/2026\/01\/13\/product-permalink-changes-coming-in-woocommerce-10-5\/<\/p>\n\n\n\n Em p\u00e1ginas de produtos vari\u00e1veis, o WooCommerce passa a garantir que o Add to Cart fica desativado<\/strong> at\u00e9 o script de varia\u00e7\u00f5es terminar de carregar. Isto resolve um comportamento que aparecia em liga\u00e7\u00f5es lentas: o utilizador conseguia clicar em \u201cAdd to Cart\u201d antes da l\u00f3gica de sele\u00e7\u00e3o\/inicializa\u00e7\u00e3o de varia\u00e7\u00f5es estar pronta, resultando em submiss\u00f5es falhadas.<\/p>\n\n\n\n Advisory: https:\/\/developer.woocommerce.com\/2026\/01\/16\/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5\/<\/p>\n\n\n\n O 10.5 introduz um REST API cache experimental<\/strong>, desenhado para ser aplic\u00e1vel a qualquer endpoint na WC REST API. O an\u00fancio indica que vai haver mais informa\u00e7\u00e3o (incluindo instru\u00e7\u00f5es de teste) antes do release final.<\/p>\n\n\n\n O caching de pre\u00e7os de varia\u00e7\u00f5es tamb\u00e9m recebeu melhorias, juntamente com uma nova utility class para trabalhar com callbacks. Para detalhes t\u00e9cnicos e impacto esperado, o ponto de entrada \u00e9 o post dedicado: https:\/\/developer.woocommerce.com\/2026\/01\/08\/variation-prices-caching-improvements-in-woocommerce-10-5\/<\/p>\n\n\n\n Outra novidade relevante \u00e9 o Product Object Caching (experimental)<\/strong>. A proposta \u00e9 cachear inst\u00e2ncias de produto durante cada request, evitando carregamentos duplicados a partir da base de dados quando o mesmo produto \u00e9 necess\u00e1rio em m\u00faltiplos pontos do ciclo de execu\u00e7\u00e3o.<\/p>\n\n\n\n PR: https:\/\/github.com\/woocommerce\/woocommerce\/pull\/62041 – Post com contexto: https:\/\/developer.woocommerce.com\/2026\/01\/19\/experimental-product-object-caching-in-woocommerce-10-5\/<\/p>\n\n\n\n O 10.5 corrige problemas de performance relacionados com dados de cache do bloco Product Filters<\/strong> que n\u00e3o estavam a ser corretamente definidos e carregados. Quando isto acontecia, a base de dados podia ficar inundada com cache data de filtros, afetando lojas com cat\u00e1logos grandes.<\/p>\n\n\n\n Al\u00e9m do fix, a ferramenta de limpeza de transients do WooCommerce foi atualizada para tamb\u00e9m limpar este cache de filtros quando executa. Ainda assim, fica um ponto operacional importante: se uma loja usa o bloco Product Filters e continua com sintomas de performance, uma causa prov\u00e1vel pode ser precisamente este cache – e a solu\u00e7\u00e3o indicada \u00e9 limpar os transients do WooCommerce<\/strong>. (PR: #62575<\/a>)<\/p>\n\n\n\n Para uma revis\u00e3o exaustiva de mudan\u00e7as (incluindo detalhes menores), o changelog completo do 10.5 beta est\u00e1 aqui: https:\/\/github.com\/woocommerce\/woocommerce\/blob\/10.5.0-beta.1\/plugins\/woocommerce\/readme.txt<\/p>\n\n\n\n O WooCommerce 10.5 muda de forma profunda a importa\u00e7\u00e3o de dados para Analytics, traz ajustes importantes na API e no checkout em blocos, e ainda abre caminho para novas camadas de cache experimentais.<\/p>\n","protected":false},"author":27,"featured_media":227,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[22],"tags":[104,24,103,37,10],"class_list":["post-228","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ecossistema-wordpress","tag-analytics","tag-performance","tag-rest-api","tag-woocommerce","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/posts\/228","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/users\/27"}],"replies":[{"embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/comments?post=228"}],"version-history":[{"count":0,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/posts\/228\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/media\/227"}],"wp:attachment":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/media?parent=228"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/categories?post=228"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/tags?post=228"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n\n
O que vem a\u00ed no 10.5 (mudan\u00e7as centrais)<\/h2>\n\n\n\n
1) Importa\u00e7\u00e3o de encomendas para Analytics: de \u201cuma action por evento\u201d para importa\u00e7\u00f5es agendadas em batch<\/h3>\n\n\n\n
\n\n
woocommerce_analytics_import_interval<\/code> – controla o intervalo (por defeito, 12 horas).<\/li>\n\n\nwoocommerce_analytics_regenerate_batch_size<\/code> – controla o tamanho do batch (por defeito, 100 encomendas por batch).<\/li>\n\n<\/ul>\n\n\n\n2) Checkout block: UI das op\u00e7\u00f5es de envio melhorada (thumbnails, packages) + corre\u00e7\u00e3o de sync Ship\/Pickup<\/h3>\n\n\n\n
3) Encomendas com dados de impostos \u201clegados\u201d ou corrompidos: mais robustez na visualiza\u00e7\u00e3o<\/h3>\n\n\n\n
float<\/code>\/string<\/code> em vez de arrays – algo que pode acontecer por migra\u00e7\u00f5es antigas, integra\u00e7\u00f5es que gravaram dados fora do formato esperado, ou casos espec\u00edficos de legado.<\/p>\n\n\n\n\n\n
woocommerce_order_item_legacy_tax_conversion<\/code> – permite l\u00f3gica de convers\u00e3o customizada em extens\u00f5es.<\/li>\n\n<\/ul>\n\n\n\n4) CSS do Select2: estilos do WooCommerce deixam de \u201cvazar\u201d para outros plugins<\/h3>\n\n\n\n
:where(.woocommerce)<\/code>.<\/p>\n\n\n\n:where()<\/code> tem especificidade zero, o que ajuda a manter compatibilidade com overrides existentes, ao mesmo tempo que evita o efeito colateral de styling global. (PR: #61956<\/a>)<\/p>\n\n\n\n5) Novo filtro
woocommerce_shipping_tax_class<\/code>: c\u00e1lculo din\u00e2mico de impostos no envio<\/h3>\n\n\n\nwoocommerce_shipping_tax_class<\/code>. A ideia \u00e9 permitir definir a tax class<\/em> (classe de imposto) do shipping de forma din\u00e2mica, com base no conte\u00fado do carrinho, dados do cliente e localiza\u00e7\u00e3o.<\/p>\n\n\n\nMudan\u00e7as de API e avisos para extens\u00f5es (Developer Advisories)<\/h2>\n\n\n\n
WC REST API: decoding correto de caracteres especiais em atributos de varia\u00e7\u00f5es<\/h3>\n\n\n\n
Remo\u00e7\u00e3o do trait AccessiblePrivateMethods (namespace
Internal<\/code>)<\/h3>\n\n\n\nInternal<\/code>, o que j\u00e1 era um sinal expl\u00edcito de que n\u00e3o deveria ser consumido publicamente. Ainda assim, algumas extens\u00f5es acabaram por depender dele de forma indevida – e \u00e9 a\u00ed que pode haver impacto.<\/p>\n\n\n\nPermalinks de produto baseados em categorias: prioridade para a categoria mais profunda<\/h3>\n\n\n\n
Produto vari\u00e1vel: bot\u00e3o \u201cAdd to Cart\u201d desativado at\u00e9 o script de varia\u00e7\u00f5es carregar<\/h3>\n\n\n\n
Performance: caches experimentais e melhorias em pontos cr\u00edticos<\/h2>\n\n\n\n
REST API cache experimental (aplic\u00e1vel a qualquer endpoint)<\/h3>\n\n\n\n
Caching de pre\u00e7os de varia\u00e7\u00f5es: melhorias + nova utility class para callbacks<\/h3>\n\n\n\n
Product Object Caching experimental: menos loads duplicados por request<\/h3>\n\n\n\n
Product Filters: corre\u00e7\u00e3o de cache data mal definido (e limpeza via transients)<\/h3>\n\n\n\n
Changelog completo (para auditoria de regress\u00f5es)<\/h2>\n\n\n\n
Checklist r\u00e1pida para developers antes de atualizar em produ\u00e7\u00e3o<\/h2>\n\n\n\n
\n\n
:where(.woocommerce)<\/code>.<\/li>\n\n\nInternal<\/code>, procurar uso do trait AccessiblePrivateMethods e remover depend\u00eancia.<\/li>\n\n\nRefer\u00eancias \/ Fontes<\/h2>\n