• A Barra Filtro de Atributos mostra, no topo da página inicial e das categorias, uma barra com campos de seleção — por exemplo Aro, Largura e Altura.
• O cliente escolhe os valores, clica no botão e vê só os produtos que têm aquelas características.
• Você escolhe quais características viram campos, em que ordem eles aparecem e se cada campo deve mostrar só os valores que combinam com a escolha anterior.
• Disponível para lojas Magento 1.

#Passo a Passo por Escrito

#1. Confira os atributos que serão usados no filtro

Os campos da barra são os atributos dos seus produtos (as características que você preenche no cadastro, como cor, tamanho ou medida).

Acesse Catálogo → Atributos → Gerenciar Atributos e confira se os atributos que você quer usar já existem e estão preenchidos nos produtos.

#2. Acesse as configurações do módulo no painel administrativo

No painel, acesse Sistema → Configuração. No menu da esquerda, clique em Catálogo (dentro do grupo Catálogo) e abra o bloco Barra Filtro de Atributos.

#3. Habilite o módulo

No campo Habilitar, selecione Sim.

#4. Escolha os atributos e a ordem dos campos

No campo Atributos do filtro, monte a lista de campos da barra:

1. Clique em Adicionar atributo. Uma nova linha aparece.
2. Na coluna Atributo, escolha a característica (a lista está em ordem alfabética).
3. Na coluna Ordem, digite um número. Na loja, os campos aparecem do menor para o maior número.
4. Repita para cada campo que você quer na barra.

Exemplo para uma loja de pneus:

Na loja, a barra fica: Aro → Largura → Altura.

#5. Defina a Filtragem Condicional (opcional)

No campo Filtragem Condicional, escolha:

• Sim: cada campo mostra só os valores que existem nos produtos já filtrados pelos campos anteriores. Exemplo: ao escolher Aro 15, o campo Largura só mostra as larguras que existem em pneus aro 15. O cliente nunca chega a uma combinação sem produto.
• Não: todos os campos mostram todos os valores do atributo, desde o início.

#6. Personalize o título e o botão (opcional)

Preencha os textos que o cliente vai ver:

1. Título do Filtro: texto que aparece no começo da barra. Padrão: Filtrar por. Exemplo: Busque seu pneu por medidas.
2. Texto do Botão: texto do botão de busca. Padrão: Pesquisar. Exemplo: Buscar pneus.

#7. Salve e atualize o cache

Clique em Salvar Configuração, no topo da tela.

Depois, atualize o cache (memória temporária da loja): acesse Sistema → Gerenciamento de Cache, clique em Marcar Todos, escolha Atualizar em Ações e clique em Enviar.

#Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — A barra aparece na página inicial e nas categorias

Ação: abra a página inicial da loja. Depois, abra uma página de categoria.

Teste 2 — A busca traz os produtos certos

Ação: escolha um valor em cada campo e clique no botão.

Teste 3 — A Filtragem Condicional limita os valores (se ligada)

Ação: na barra, escolha um valor no primeiro campo e abra o segundo.

Teste 4 — A ordem segue a tabela

Ação: no painel, troque a Ordem de dois atributos, salve, atualize o cache e recarregue a página inicial.

Teste 5 — Se algo não funcionar

Se não funcionar, verifique:

• Se Habilitar está em Sim e se o cache foi atualizado depois de salvar.
• Se a tabela Atributos do filtro tem pelo menos um atributo — sem atributos, a barra mostra só o título e o botão.
• Se você está editando a configuração na loja certa: no topo à esquerda, em Escopo da Configuração Atual, escolha a visão da sua loja e confira se os valores são os mesmos.
• Se os produtos estão Habilitados, com Visibilidade em Catálogo ou Catálogo, Busca, e com o atributo preenchido no produto principal.
• Se a busca não trouxe um produto que tem vários valores marcados no mesmo atributo (Múltipla Seleção) — veja as Observações Importantes.

#Observações Importantes

• Onde a barra aparece: na página inicial, nas páginas de categoria e na página de resultados. Ela não aparece em outras páginas de conteúdo nem na página do produto.

• Produtos considerados: só produtos Habilitados e com Visibilidade em Catálogo ou Catálogo, Busca aparecem nos resultados e nos valores da Filtragem Condicional. Produtos sem estoque também aparecem, com o aviso Sem estoque.

• Atributos de Múltipla Seleção: se um produto tiver mais de um valor marcado no mesmo atributo (ex.: serve em Aro 15 e Aro 16), ele não aparece ao buscar por um desses valores. Para filtros, prefira atributos de Seleção (um valor por produto).

• Página 2 dos resultados: a página de resultados mostra 12 produtos por vez. A navegação para as páginas seguintes e a troca da quantidade por página podem apresentar erro — se isso acontecer, fale com o suporte.

• Filtragem Condicional na página de resultados: depois de buscar, só o primeiro campo continua com o valor escolhido; os seguintes voltam a mostrar o nome do campo. Os resultados continuam corretos.

• Ordem dos valores: sem a Filtragem Condicional, os valores de cada campo seguem a ordem do cadastro do atributo. Com ela, a partir do segundo campo, os valores aparecem em ordem de texto — por isso 100 pode aparecer antes de 20.

• Nome do campo: o nome que aparece em cada campo é o nome principal do atributo (o que está em Gerenciar Atributos), o mesmo em todas as visões de loja.

• Escopo: você pode configurar a barra de forma diferente para cada visão de loja, usando o seletor Escopo da Configuração Atual.

• Lista antiga: se a sua loja já usava a barra antes da tabela de ordem, ela continua igual até você cadastrar a tabela. Enquanto a tabela estiver vazia, ao salvar a tela de Catálogo, os campos podem passar para a ordem alfabética. Cadastre a tabela para fixar a ordem que você quer.

#Referências e Relacionados

• Limpeza de cache da loja: toda alteração na barra só aparece depois de atualizar o cache. Aprenda a atualizar o cache da sua loja
• Atributos de produto: os campos da barra são atributos do produto. Esta doc explica como criar atributos do tipo Seleção e cadastrar as opções.
• Cadastro de produtos configuráveis: ajuda a entender onde preencher os atributos em produtos com variações para que eles apareçam no filtro.
• Visibilidade e status do produto: explica as opções de Visibilidade e Status, que definem se o produto entra nos resultados da barra.

• O Universal Finder é uma barra de busca que exibe até 5 menus suspensos em sequência, cada um filtrando por uma característica do produto (marca, modelo, ano, cor, tamanho).
• A cada escolha do cliente, o menu seguinte mostra apenas as opções que realmente têm produtos disponíveis — assim ele nunca chega a uma busca sem resultado.
• É ideal para lojas cujo catálogo se organiza por combinação de características: autopeças, pneus, moda, instrumentos musicais, eletrônicos.
• Disponível para lojas Magento 2.

#Passo a Passo por Escrito

#1. Acesse as configurações do Universal Finder

No painel administrativo, vá em Lojas → Configuração → Catálogo → Universal Finder (em inglês: Stores → Configuration → Catalog → Universal Finder).

A tela está dividida em três blocos: Configurações Gerais (General Settings), Configurações de Exibição (Display Settings) e Configuração dos Filtros (Filter Configuration).

#2. Habilite o módulo

No bloco Configurações Gerais (General Settings), localize o campo Habilitar (Enabled) e selecione Sim (Yes).

#3. Escolha em quais páginas a barra de busca aparece

Ainda em Configurações Gerais, use o campo Exibir nas Páginas (Show on Pages) para selecionar onde a barra de busca deve ser exibida. Você pode marcar mais de uma opção:

• Página Inicial (Home Page)
• Páginas de Conteúdo / CMS (CMS Pages)
• Páginas de Categoria (Category Pages)
• Páginas de Produto (Product Pages)
• Resultados de Busca (Search Results)
• Carrinho de Compras (Shopping Cart)
• Página de Resultados do Universal Finder (Universal Finder Results Page)

#4. Defina o comportamento de produtos sem estoque

No campo Produtos Sem Estoque (Out of Stock Products), escolha como os produtos indisponíveis devem ser tratados:

• Mostrar todos (Show all) — exibe todos os produtos, com ou sem estoque.
• Ocultar sem estoque (Hide out-of-stock) — esconde os produtos sem estoque.
• Mostrar sem estoque por último (Show out-of-stock last) — exibe os sem estoque no final da lista.

#5. Personalize os textos da barra de busca (opcional)

No bloco Configurações de Exibição (Display Settings), ajuste os textos que o cliente vê:

• Título da Barra de Busca (Search Bar Title) — texto exibido à esquerda dos menus. Deixe em branco para ocultar o título.
• Texto do Botão de Busca (Search Button Text) — rótulo do botão que inicia a busca.
• Título da Página de Resultados (Results Page Title) — título exibido na aba do navegador, na página de resultados.

#6. Configure os filtros em cascata

No bloco Configuração dos Filtros (Filter Configuration), defina os menus suspensos. São até 5 filtros, e a ordem importa: o Filtro 1 (Filter 1) é sempre o primeiro menu, e cada filtro libera o próximo.

Para cada filtro que quiser usar:

1. Marque Filtro N — Habilitado (Filter N — Enabled) como Sim (Yes).
2. No campo Filtro N — Código do Atributo (Filter N — Attribute Code), informe o código do atributo de produto que vai alimentar o menu — por exemplo manufacturer, color ou model_year. Você encontra o código de cada atributo em Lojas → Atributos → Produto (Stores → Attributes → Product).
3. No campo Filtro N — Texto Padrão (Filter N — Placeholder Label), informe o texto que aparece como primeira opção do menu, antes de o cliente escolher (ex.: Selecione a marca).

#7. Salve as configurações e limpe o cache

Clique em Salvar Configuração (Save Config) no topo da tela. Em seguida, limpe o cache da loja em Sistema → Gerenciamento de Cache (System → Cache Management).

#Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Exibição da barra de busca

Ação: Acesse, na sua loja, uma das páginas que você marcou em Exibir nas Páginas (por exemplo, a página inicial). Localize a barra de busca do Universal Finder.

Teste 2 — Navegação em cascata

Ação: Selecione uma opção no primeiro menu suspenso e observe o menu seguinte.

Teste 3 — Busca e página de resultados

Ação: Complete as seleções desejadas e clique no botão de busca.

Se não funcionar, verifique:

• Se o campo Habilitar está como Sim e se a página testada está marcada em Exibir nas Páginas.
• Se os filtros usam atributos do tipo Lista Suspensa e se o Código do Atributo está preenchido corretamente.
• Se você limpou o cache da loja em Sistema → Gerenciamento de Cache após salvar.
• Se existem produtos ativos, com estoque (conforme a regra escolhida) e com os atributos preenchidos para a combinação testada.

#Observações Importantes

• Tipo de atributo: os filtros funcionam apenas com atributos do tipo Lista Suspensa. Atributos de texto livre, data ou número não são suportados e geram um menu vazio, sem aviso.
• Atributos de seleção múltipla: não são recomendados. O comportamento previsível só é garantido com atributos de Lista Suspensa simples.
• Atualização das opções: as opções dos menus ficam em cache por até 24 horas e não são atualizadas ao salvar as configurações. Após mudar produtos ou filtros, limpe o cache da loja para ver as mudanças refletidas.
• Produtos sem estoque: a regra escolhida no campo Produtos Sem Estoque afeta tanto os resultados quanto as opções disponíveis nos menus.
• Dependência do navegador: a navegação em cascata funciona com recursos do navegador do cliente. Em navegadores com JavaScript desativado, apenas o primeiro menu aparece preenchido.
• Atributos com muitas opções: menus baseados em atributos com centenas de opções carregam todas de uma vez, sem busca interna ou carregamento progressivo.

#Referências e Relacionados

• Atributos de produto: os filtros do Universal Finder se baseiam em atributos do tipo Lista Suspensa. Esta doc explica como criar e configurar atributos de produto.
• Gerenciamento de cache da loja: após alterar filtros ou produtos, é necessário limpar o cache para que as mudanças apareçam no Universal Finder.
• Controle de estoque dos produtos: a disponibilidade dos produtos influencia o que aparece nos menus e nos resultados. Esta doc complementa o entendimento da regra de estoque.