Filtro de marca, modelo e ano no WooCommerce com listas suspensas dependentes
Um filtro de marca, modelo e ano para WooCommerce pede primeiro a marca, depois oferece apenas os modelos dessa marca, em seguida apenas os anos desse modelo e mostra as peças compatíveis. O HUSKY faz isso com o tipo de filtro Lista suspensa hierárquica (Hierarchy drop-down). Se funciona ou não depende menos das configurações do que de como os dados dos veículos são armazenados: as listas suspensas só conseguem seguir uma estrutura de pai e filho que já exista em uma única taxonomia. A seguir: como funcionam as listas suspensas dependentes, como estruturar os dados, a configuração e o que verificar quando a segunda lista continua vazia.
Como funciona um filtro de marca, modelo e ano no HUSKY
A Lista suspensa hierárquica lê uma única taxonomia hierárquica, o mesmo tipo de árvore das categorias de produtos. A primeira lista mostra os termos de nível superior (as marcas). Quando o visitante escolhe Audi, o formulário é desenhado de novo e a segunda lista mostra as filhas de Audi (os seus modelos), depois as filhas do modelo escolhido (os seus anos), até onde a árvore chegar.
A dependência vem da própria árvore, não dos produtos. Depois de Audi, a segunda lista mostra os modelos da Audi e nada mais, mesmo que algumas peças também sirvam em um BMW. É exatamente o que um seletor de veículo precisa, e isso tem três consequências:
- Marca, modelo e ano devem ser níveis da mesma taxonomia. Uma taxonomia de marcas e uma taxonomia de modelos não podem ser encadeadas, e categorias de produtos e tags também não.
- Os atributos de produto (
pa_make,pa_model) não podem ser encadeados, porque os atributos do WooCommerce não têm termos pai e filho. - Os campos personalizados (campos do ACF, valores meta de uma importação) não podem ser usados, porque o tipo só funciona com termos de taxonomia.
Cada escolha substitui a anterior na busca: depois de Audi → A4 → 2015, a busca contém apenas o último termo, por exemplo vehicle=2015-a4. Na página de resultados, o plugin reconstrói a cadeia inteira a partir desse termo, e as listas voltam a mostrar Audi, A4 e 2015.
Estruture primeiro os dados dos veículos
Categorias de produtos ou uma taxonomia separada
Você pode montar a árvore nas categorias de produtos (Marca → Modelo → Ano), e funciona. Em uma loja de peças, porém, as categorias costumam descrever a peça (freios, filtros, iluminação) e os visitantes querem filtrar pelas duas coisas. Nesse caso, crie uma taxonomia hierárquica separada para os produtos, por exemplo Veículos (Vehicles), com o Custom Post Type UI ou com o seu próprio código. Criar uma taxonomia personalizada mostra os passos; o importante é definir Hierárquica (Hierarchical) como verdadeiro e associá-la a Produtos.
Um ramo por modelo
Escolha a ordem em que os seus clientes pensam; Marca → Modelo → Ano é a mais comum. Cada modelo recebe os seus próprios termos de ano, de modo que o termo 2015 existe uma vez sob A4 e uma vez sob Golf. Isso está correto: o WordPress permite o mesmo nome sob pais diferentes e torna único o segundo slug acrescentando o slug do pai (por exemplo 2015-a4). Para faixas de anos, dê a um termo o nome “2012–2016” e mantenha um slug como 2012-2016. Se você usa a extensão de requisição com URL de SEO, evite -and-, -or- e -to- dentro dos slugs: o plugin os usa como separadores nas URLs do filtro.
Atribua os produtos a todos os veículos em que servem
Uma peça que serve no Audi A3 2012–2016 e no BMW X5 2016–2018 é atribuída aos dois termos de ano. Com a lógica padrão OU (OR), basta atribuir apenas o último nível: quando o visitante escolheu somente a marca, o WordPress inclui os termos filhos na busca. Se você definir Lógica de filtragem (Logic of filtering) como E (AND) para essa taxonomia, o plugin deixa de incluir os termos filhos, e o produto também precisa estar atribuído à marca e ao modelo. O FAQ sobre filtragem da hierarquia de categorias traz um trecho que marca os termos pai automaticamente quando um produto é salvo.
Para milhares de produtos, atribua os termos por importação. O importador de produtos padrão do WooCommerce entende caminhos na coluna Categorias: Audi > A4 > 2015 cria os termos que faltam e atribui o produto ao último, e vários caminhos são separados por vírgulas. Para uma taxonomia personalizada, você precisa de uma ferramenta de importação que ofereça suporte a taxonomias personalizadas.
Produtos universais
Não existe uma configuração que faça um produto corresponder a todos os veículos. Ou você atribui os produtos universais a todos os termos do último nível, aceitando que nenhum ano jamais parecerá vazio, ou os mantém fora da árvore de veículos e coloca ao lado do seletor um link para uma categoria “Acessórios universais”.
Configure a lista suspensa hierárquica
- Em WooCommerce → Configurações → Products Filter → Extensões (WooCommerce → Settings → Products Filter → Extensions), ative Lista suspensa hierárquica (Hierarchy drop-down) e salve.
- Na aba Estrutura (Structure), ative a sua taxonomia de veículos e escolha Lista suspensa hierárquica (Hierarchy drop-down) como o tipo dela.
- Abra as opções adicionais da taxonomia (o ícone de engrenagem) e preencha Rótulo personalizado da taxonomia (Taxonomy custom label), por exemplo
Make+Model+Year^Find parts for your car. - Na mesma janela, defina Mostrar rótulo do título (Show title label) como Sim (Yes) se quiser o título do bloco e Mostrar sempre a cadeia (Show chain always) como Sim (Yes) se as três listas devem estar visíveis desde o início.
- Na aba Opções (Options), ative Mostrar contagem (Show count), Recontagem dinâmica (Dynamic recount) e Ocultar termos vazios (Hide empty terms) se marcas, modelos e anos sem produtos não devem ser oferecidos (mais em como ocultar termos vazios).
No rótulo, as partes separadas por + são os placeholders das listas, em ordem: a primeira lista mostra “Make” (Marca), a segunda “Model” (Modelo), a terceira “Year” (Ano). O texto depois de ^ é o título do bloco. Sem o ^, o título do bloco seria a cadeia inteira, com os sinais de mais. Com Mostrar sempre a cadeia (Show chain always), o plugin desenha tantas listas quantas forem as partes; as que ainda não podem ser usadas ficam desativadas e mostram o seu placeholder até que o nível anterior seja escolhido.
Faça a lista seguinte aparecer sem recarregar a página
A lista seguinte é montada pelo servidor a partir da escolha atual, por isso, depois de cada escolha, o navegador precisa pedir um novo formulário. Duas configurações decidem como: autosubmit e ajax_redraw no shortcode [woof], ou Envio automático (Autosubmit) e Redesenho do formulário por AJAX (Form AJAX redrawing) no widget. Quando uma lista suspensa muda, o plugin só reage se o envio automático estiver ativado.
| autosubmit | ajax_redraw | O que acontece depois de cada escolha |
|---|---|---|
| 0 | 0 ou 1 | Nada. A lista seguinte só aparece depois que o visitante clica em Filtrar (Filter) e os resultados são carregados. |
| 1 | 0 | Cada escolha executa a busca: os produtos são atualizados e a lista seguinte chega junto com eles. Bom para a barra lateral da loja. |
| 1 | 1 | Cada escolha apenas redesenha o formulário em segundo plano, sem buscar produtos. O botão Filtrar (Filter) executa a busca. Bom para um seletor de veículo. |
Um seletor que mostra apenas as listas de veículos fica assim (troque vehicle pelo slug da sua taxonomia):
[woof tax_only="vehicle" by_only="none" autosubmit=1 ajax_redraw=1]
tax_only limita o formulário à taxonomia de veículos e by_only="none" oculta o preço, a busca por texto e os outros filtros que não são de taxonomia. O plugin lê autosubmit e ajax_redraw do primeiro formulário de filtro da página, de modo que um segundo formulário do HUSKY (uma busca no cabeçalho, um widget da barra lateral) pode sobrescrever o comportamento do seletor. Mantenha um formulário por página sempre que possível.
Uma caixa de busca de veículo na página inicial
Coloque o shortcode acima na página inicial. Em uma página que não é um arquivo da loja, o botão Filtrar (Filter) abre a página da loja com o veículo escolhido; adicione redirect="https://example.com/parts/" para enviar os visitantes a outra página de resultados. A página da loja pode manter o seu filtro habitual na barra lateral; se ela também mostrar a taxonomia de veículos como uma lista suspensa hierárquica, a cadeia chega pré-selecionada. As regras de redirecionamento, o modo AJAX e a página inicial estática são tratados em o filtro de produtos na página inicial ou em uma página personalizada.
Quando os dados são atributos: o que funciona no lugar
Se marca, modelo e ano já estão armazenados como atributos, as listas suspensas não podem depender umas das outras por meio de uma árvore. Duas opções chegam perto:
- Recontagem dinâmica com termos vazios ocultos. Com as mesmas configurações
autosubmiteajax_redraw, depois que o visitante escolhe Ford, todo modelo que não tem produtos entre os resultados da Ford fica oculto. O limite: o plugin só oculta valores com zero produtos nos resultados atuais. Uma peça que serve em um Ford Focus e em um Toyota Yaris mantém o Yaris na lista de modelos depois de escolhida a Ford, e uma peça vendida para 1994–2024 mantém todos os anos visíveis. O plugin não tem como saber qual ano pertence a qual modelo, porque os atributos não têm relação entre si. - O filtro passo a passo (Step by step filter) (
[woof_step]) mostra os filtros um de cada vez, como um assistente. Ele funciona com quaisquer filtros, inclusive atributos, mas usa a mesma regra de relevância, de modo que os mesmos vazamentos permanecem.
Para uma compatibilidade exata, mova os dados para uma única taxonomia hierárquica; é uma importação feita uma só vez.
Listas suspensas em uma única linha
Por padrão, as listas suspensas ficam empilhadas. Para colocá-las lado a lado em uma área larga (acima dos produtos ou na página inicial), adicione este CSS em Aparência → Personalizar → CSS adicional (Appearance → Customize → Additional CSS) ou na folha de estilos do seu tema filho. Ele funciona com os skins de lista suspensa nativo, Chosen e SelectWoo e quebra em linhas separadas em telas estreitas:
/* HUSKY: hierarchy drop-downs side by side */
.woof_container_select_hierarchy .woof_block_html_items {
display: flex;
flex-wrap: wrap;
gap: 10px;
}
.woof_container_select_hierarchy .woof_block_html_items > select,
.woof_container_select_hierarchy .woof_block_html_items > .chosen-container,
.woof_container_select_hierarchy .woof_block_html_items > .select2-container {
flex: 1 1 180px;
min-width: 0;
}
Se a lista seguinte continua vazia ou desativada
- O envio automático está desativado. Com
autosubmit=0, uma escolha não faz nada até que Filtrar (Filter) seja clicado, mesmo comajax_redraw=1. Use as combinações da tabela. - Outro formulário controla a página. Remova os outros formulários do HUSKY da página e teste de novo.
- O termo escolhido não tem filhos. Confira a árvore na tela de administração da taxonomia. Um modelo sem termos de ano termina a cadeia ali; com Mostrar sempre a cadeia (Show chain always), a lista de anos permanece desativada.
- Os filhos não têm produtos. Com Ocultar termos vazios (Hide empty terms) ativado, modelos e anos sem produtos não são oferecidos. Se nenhuma opção do primeiro nível tem produtos, o plugin oculta o bloco inteiro depois que a página carrega, de modo que o seletor aparece por um instante e some.
- Faltam os termos novos. Com Cache de termos (Cache terms) ativado, clique em limpar cache de termos (clear terms cache) em Avançado → Opções (Advanced → Options) depois de importar novos veículos.
- O modo Turbo está ativado. Ele substitui a requisição de busca normal pela sua própria. Se a cadeia não abre, teste uma vez com o modo Turbo desativado.
- A árvore está nas categorias de produtos e você está em uma página de categoria. Ali a cadeia começa na categoria atual e, em uma categoria do último nível (um ano), o bloco não é exibido; veja por que o filtro mostra apenas subcategorias em uma página de categoria.
Se a cadeia ainda não abrir, abra um tópico no fórum de suporte do HUSKY com um link para a página, as configurações do shortcode ou do widget que você usa e o rótulo personalizado da taxonomia.