- 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).
Resultado esperado: A tela de configuração do Universal Finder será exibida, com os três blocos de configuração disponíveis para preenchimento.
2. Habilite o módulo
No bloco Configurações Gerais (General Settings), localize o campo Habilitar (Enabled) e selecione Sim (Yes).
Por padrão, o campo Habilitar já vem como Sim. Você só precisa alterar se quiser desativar a barra de busca temporariamente.
Com o campo Habilitar em Não, a barra de busca não aparece em nenhuma página da loja.
Resultado esperado: O campo Habilitar fica definido como Sim.
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)
Por padrão, a barra já vem habilitada na Página Inicial, nas Páginas de Conteúdo, nas Páginas de Categoria, nas Páginas de Produto e na Página de Resultados do Universal Finder.
Resultado esperado: As páginas selecionadas ficam marcadas no campo Exibir nas Páginas.
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.
A opção Produtos Sem Estoque afeta tanto a lista de resultados quanto as opções dos menus suspensos. Com Ocultar sem estoque, uma característica que só existe em produtos sem estoque deixa de aparecer no filtro — o que costuma ser percebido como "a opção sumiu".
Resultado esperado: O campo Produtos Sem Estoque fica definido com o comportamento escolhido.
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.
Resultado esperado: Os textos personalizados ficam salvos e passam a aparecer na barra de busca e 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:
- Marque Filtro N — Habilitado (Filter N — Enabled) como Sim (Yes).
- 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,coloroumodel_year. Você encontra o código de cada atributo em Lojas → Atributos → Produto (Stores → Attributes → Product). - 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).
Use apenas atributos do tipo Lista Suspensa (Dropdown / select). Atributos de texto, data ou número não são suportados e resultam em um menu vazio, sem mensagem de erro.
Um filtro marcado como habilitado, mas sem o código do atributo preenchido, é ignorado. Preencha sempre o código do atributo de cada filtro que ativar.
Resultado esperado: Os filtros ficam configurados na ordem desejada, cada um vinculado a um atributo de produto e com seu texto padrão.
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).
As opções dos menus ficam guardadas em cache por até 24 horas. Esse cache não é atualizado automaticamente ao salvar as configurações dos filtros. Sempre que mudar os atributos, os textos ou a regra de estoque dos filtros, limpe o cache da loja para que as alterações apareçam.
Resultado esperado: Uma mensagem de confirmação de que a configuração foi salva é exibida no topo da tela, e a barra de busca passa a refletir as configurações após a limpeza do cache.
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.
Resultado esperado: A barra de busca aparece na página, com o primeiro menu suspenso já preenchido com as opções disponíveis.
Teste 2 — Navegação em cascata
Ação: Selecione uma opção no primeiro menu suspenso e observe o menu seguinte.
Resultado esperado: O segundo menu é liberado e exibe apenas as opções que têm produtos disponíveis para a primeira escolha. A cada nova seleção, o próximo menu é liberado da mesma forma.
Teste 3 — Busca e página de resultados
Ação: Complete as seleções desejadas e clique no botão de busca.
Resultado esperado: O cliente é levado a uma página de resultados que lista os produtos compatíveis com a combinação escolhida.
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.
Pronto! Dessa forma realizamos a configuração do Universal Finder em sua loja virtual Magento 2.
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.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br