Filtro WooCommerce por tamanho mostra variações fora de estoque: como corrigir
Um cliente marca o tamanho M, e o filtro WooCommerce por tamanho mostra uma camiseta cuja variação M está fora de estoque. A página do produto então diz que o tamanho está esgotado, e o cliente vai embora. O filtro não está quebrado: por padrão, ele julga um produto variável pelo produto pai, exatamente como o WooCommerce faz, e o pai continua em estoque enquanto qualquer uma de suas variações estiver. A seguir: por que o filtro mostra variações fora de estoque, a configuração do HUSKY que o faz verificar o estoque do tamanho selecionado, as regras que essa verificação segue e o que corrigir quando os resultados ou as contagens ainda estiverem errados.
Por que o filtro por tamanho mostra variações esgotadas
No WooCommerce, um produto variável são dois tipos de registros. O produto pai é o que as páginas da loja e das categorias listam. Sua aba Atributos (Attributes) contém os valores (Tamanho: S, M, L; Cor: preto, vermelho), e esses valores são vinculados ao pai como termos de atributo. Cada variação, como M / preto, é um registro separado, com preço e estoque próprios.
Um filtro por atributo procura produtos pai que tenham o termo selecionado. Se a camiseta lista M na aba Atributos (Attributes), ela corresponde ao tamanho M, qualquer que seja o estoque da variação M. O status de estoque do pai também não ajuda: o WooCommerce o mantém como Em estoque (In stock) enquanto pelo menos uma variação estiver em estoque (ou Em espera (On backorder) se uma estiver em espera) e só o muda para Fora de estoque (Out of stock) quando todas as variações estão esgotadas. Pelo mesmo motivo, a opção do WooCommerce Ocultar itens fora de estoque do catálogo (Hide out of stock items from the catalog) (WooCommerce → Configurações → Produtos → Estoque) não resolve isso: ela oculta a camiseta somente quando todos os seus tamanhos acabaram. A pergunta "o tamanho M está disponível?" precisa ser feita às variações, e o filtro só a faz quando você manda.
Faça o HUSKY verificar o estoque do tamanho selecionado
A verificação de variações pertence ao elemento Em estoque. No HUSKY 3.4.6 ele é uma extensão integrada que está sempre ativa, portanto não há nada para ligar na aba Extensões (Extensions).
- Abra WooCommerce → Configurações → Products Filter, aba Estrutura (Structure), e encontre a linha Em estoque (In stock). Defina-a como Sim (Yes) se os clientes devem ver a caixa de seleção.
- Clique no botão de engrenagem ao lado (opções adicionais (additional options)). Na janela que abrir, defina a primeira configuração, Pesquisar em produtos variáveis (Search in variable produts), como Pesquisar em produtos e suas variações (Search in products and their variations). O padrão, Somente produtos simples (Simple products only), considera apenas o status de estoque do próprio produto, que no caso de um produto variável é o do pai.
- Deixe Usar novo BD. (Use new DB.) em Sim (Yes) e escolha Caixa de seleção (Checkbox) ou Alternador (Switcher) em Visualização (View).
- Salve, limpe o cache de página e teste: escolha um tamanho que você sabe estar esgotado em um produto, marque Em estoque (In stock), e esse produto deve sumir dos resultados.
A verificação só é executada enquanto Em estoque (In stock) faz parte da busca e pelo menos um atributo de produto (uma taxonomia pa_, como Tamanho ou Cor) está selecionado. Sem Em estoque (In stock), a filtragem por atributo continua baseada no pai. A configuração exige trabalho extra do banco de dados, e é por isso que vem desativada por padrão; veja a seção sobre velocidade mais abaixo.
Aplicar Em estoque sem uma caixa de seleção
Se os tamanhos esgotados nunca devem corresponder, você não precisa depender de os clientes marcarem a caixa. O filtro woof_get_request_data pode adicionar a condição de estoque a toda busca executada pelo plugin:
/*
* HUSKY: always search in-stock products only.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
$data['stock'] = 'instock';
return $data;
});
Isso também remove produtos simples fora de estoque e produtos variáveis totalmente esgotados de toda lista de produtos controlada pelo filtro, como descrito no FAQ sobre mostrar apenas produtos em estoque. Defina a linha Em estoque (In stock) como Não (No), para que os clientes não vejam uma caixa de seleção que está sempre marcada.
Se os produtos fora de estoque devem continuar visíveis enquanto os clientes navegam e sair somente quando filtrarem por um atributo, adicione a condição apenas quando houver um atributo na busca:
/*
* HUSKY: apply In stock only when a product attribute (pa_*) is being filtered.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
foreach (array_keys($data) as $key) {
if (strpos($key, 'pa_') === 0) {
$data['stock'] = 'instock';
break;
}
}
return $data;
});
Como a verificação de variações decide
Com Usar novo BD. (Use new DB.) em Sim (Yes), o HUSKY lê a tabela de consulta de atributos de produtos do WooCommerce, na qual cada variação tem uma linha para cada um de seus valores de atributo, junto com um indicador de estoque. Para cada produto variável, ele reúne as variações que têm qualquer um dos valores selecionados e remove o produto quando essas variações existem e nenhuma delas está em estoque. Essa regra explica os resultados que à primeira vista parecem estranhos:
| Produto | Busca | Resultado |
|---|---|---|
| S em estoque, M esgotado | Tamanho M + Em estoque | Oculto |
| S em estoque, M esgotado | Tamanho S ou M + Em estoque | Exibido: S está disponível |
| M listado na aba Atributos (Attributes), mas nenhuma variação M existe | Tamanho M + Em estoque | Exibido: nenhuma variação M pode estar fora de estoque |
| Uma variação definida como Qualquer Tamanho (Any Size), em estoque | Tamanho L + Em estoque | Exibido: uma variação Qualquer Tamanho (Any Size) vale para todos os tamanhos listados no produto |
| M / preto esgotado, M / vermelho e S / preto em estoque | Tamanho M + Cor preto + Em estoque | Exibido: cada valor selecionado tem uma variação em estoque |
| Variação M Em espera (On backorder) | Tamanho M + Em estoque | Exibido: uma variação em espera conta como disponível |
A terceira linha é um problema de dados, não do filtro. Um valor que permanece na aba Atributos (Attributes) do pai depois que você excluiu sua variação, ou que nunca foi usado em uma variação, continua correspondendo e continua sendo contado. Mantenha apenas os valores que têm variações, ou crie a variação e marque-a como Fora de estoque (Out of stock).
As duas últimas linhas são os limites da verificação. Os valores de atributos diferentes são verificados um a um, não como a combinação exata que o cliente escolheu, de modo que um produto ainda pode aparecer quando essa combinação específica está esgotada. As variações em espera podem ser compradas, por isso Em estoque (In stock) as mantém; se elas também não devem corresponder, adicione o elemento Excluir produtos em espera, que tem a mesma configuração Pesquisar em produtos e suas variações (Search in products and their variations). Verifique também o que uma importação realmente gravou: uma variação salva como Em espera (On backorder) em vez de Fora de estoque (Out of stock) permanece nos resultados.
Resultados ainda errados: atualize a tabela de consulta do WooCommerce
A tabela de consulta (wc_product_attributes_lookup) pertence ao WooCommerce. Ela é atualizada quando um produto ou uma variação é salvo pelo WooCommerce, por padrão com um pequeno atraso: o WooCommerce agenda a atualização como uma ação em segundo plano. A tabela fica defasada quando:
- o estoque é alterado por uma importação ou uma ferramenta de sincronização que grava direto no banco de dados, em vez de salvar os produtos pelo WooCommerce;
- as ações em segundo plano não são executadas, por exemplo porque o WP-Cron está desativado sem um cron do servidor para substituí-lo. As ações pendentes com o hook
woocommerce_run_product_attribute_lookup_update_callbackse acumulam então em WooCommerce → Status → Ações agendadas; - uma regeneração completa da tabela foi interrompida.
O filtro passa então a trabalhar com dados de estoque antigos, e os resultados parecem aleatórios. Para reconstruir a tabela, abra WooCommerce → Status → Ferramentas e clique em Regenerar (Regenerate) ao lado de Regenerar a tabela de consulta de atributos de produtos (Regenerate the product attributes lookup table). Ela é executada em segundo plano, em lotes; o botão mostra Preenchimento em andamento (Filling in progress) com um contador até terminar. O FAQ sobre filtros de preço e estoque que não funcionam trata das mesmas ferramentas. Se o estoque muda com frequência, considere WooCommerce → Configurações → Produtos → Avançado → Tabela de consulta de atributos de produtos (Product attributes lookup table) → Atualizações diretas (Direct updates), que atualiza a tabela no momento em que um produto é salvo.
Como teste, ou quando a tabela não pode ser mantida atualizada, defina Usar novo BD. (Use new DB.) como Não (No). O HUSKY então lê as próprias variações (seus valores _stock_status e attribute_pa_…). Isso é mais lento com muitas variações e segue uma regra mais rígida: um produto é removido quando qualquer variação com um valor selecionado está fora de estoque, de modo que "Tamanho S ou M" oculta a camiseta da tabela acima. Para obter a mesma regra da tabela de consulta, adicione:
/*
* HUSKY, In stock with "Use new DB." = No: keep a variable product when at least
* one variation with a selected value is in stock.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_exclude_existing_variations', '__return_true');
Contagens que incluem variações fora de estoque
Os números ao lado dos tamanhos vêm das mesmas consultas que os resultados, portanto seguem as mesmas regras.
- Sem Em estoque (In stock) na busca, a contagem de M inclui todos os produtos que têm M no pai, esgotados ou não. Com Em estoque (In stock) ativo (marcado, ou forçado com o snippet acima) e a busca por variações ligada, cada tamanho é contado com a verificação de variações para esse tamanho.
- Some a isso Recontagem dinâmica (Dynamic recount) e Ocultar termos vazios (Hide empty terms) (aba Opções (Options)), e um tamanho cuja contagem cai a zero desaparece do filtro, de modo que os tamanhos esgotados deixam de ser oferecidos.
- Se o WooCommerce oculta itens fora de estoque, mantenha Respeitar a visibilidade do catálogo (Listen catalog visibility) (Avançado → Opções) em Sim (Yes). Com Não (No), os contadores também incluem os produtos que o WooCommerce oculta, e um termo pode mostrar uma contagem enquanto seus resultados estão vazios.
- Com Cache do número de recontagem dinâmica para cada item no filtro (Cache dynamic recount number for each item in filter) (Avançado → Opções), as contagens ficam armazenadas e não acompanham as mudanças de estoque até que o cache seja limpo automaticamente ou com o botão limpar cache (clear cache). Um cache de página também pode servir números antigos.
Velocidade: o custo de verificar variações
Toda busca que combina um atributo com Em estoque (In stock) executa consultas extras: duas na tabela de consulta com Usar novo BD. (Use new DB.) em Sim (Yes), ou uma sobre todas as variações correspondentes com Não (No). Com Recontagem dinâmica (Dynamic recount), a verificação também é executada para cada valor que recebe uma contagem, de modo que um filtro com 40 tamanhos e cores a repete 40 vezes por página. Com dezenas de milhares de variações, isso é perceptível.
- Mantenha Usar novo BD. (Use new DB.) em Sim (Yes) e a tabela de consulta atualizada; é o método mais rápido.
- Ative Cache do número de recontagem dinâmica para cada item no filtro (Cache dynamic recount number for each item in filter) e escolha um intervalo de limpeza automática que corresponda à velocidade com que seu estoque muda.
- Mais opções estão em como acelerar a filtragem de produtos em catálogos grandes.
O Modo Turbo não é um atalho aqui. Ele filtra no navegador do visitante a partir de um arquivo pré-gerado, e sua verificação de Em estoque (In stock) considera apenas o status de estoque do próprio produto: a configuração de variações não tem efeito ali, e as mudanças de estoque só aparecem depois que o arquivo é reconstruído. Se os tamanhos esgotados não devem corresponder, mantenha o Modo Turbo desativado; seus demais limites estão listados em solução de problemas do Modo Turbo.
Checklist
- Em estoque (In stock) → engrenagem → Pesquisar em produtos e suas variações (Search in products and their variations) selecionado e salvo.
- Em estoque (In stock) faz parte da busca: marcado pelo cliente ou forçado com
woof_get_request_data. - Os produtos variáveis listam apenas os valores de atributo que têm variações.
- As variações esgotadas têm o status Fora de estoque (Out of stock), não Em espera (On backorder).
- A tabela de consulta foi regenerada após as importações, e nenhuma atualização da tabela está travada em Ações agendadas.
- Cache de recontagem e cache de página limpos após mudanças de estoque; Modo Turbo desativado.
Se o filtro ainda retornar um produto cujo tamanho selecionado está esgotado, abra um tópico no fórum de suporte do HUSKY com o link do filtro, o produto e o status de estoque de suas variações.