Rotozoom Product Filter — Manual
Filtragem de produtos AJAX ultrarrápida para WooCommerce. O Product Filter permite que seus clientes restrinjam o catálogo por categoria, preço, atributos, estoque e avaliação — os resultados são atualizados na hora, sem recarregar a página. É uma substituição direta e sem dependências do WBW Product Filter.
- Versão gratuita: filtragem AJAX completa, controle deslizante de preço, filtros de estoque/avaliação, contexto de categoria, até 4 atributos ativos.
- Versão Pro: atributos ilimitados e compatibilidade total com o tema XStore.
- Preço Pro: 47 € / ano por site.
Para iniciantes: o que este plugin faz
Quando uma loja tem mais do que um punhado de produtos, os clientes precisam de uma forma de encontrar rapidamente o que querem. Um filtro é o painel — geralmente à esquerda da página da loja — com caixas de seleção e controles deslizantes como Preço, Cor ou Marca. À medida que o cliente marca caixas, a grade de produtos se estreita.
O Product Filter adiciona esse painel à sua loja e o torna instantâneo: a grade é atualizada no momento em que uma caixa é marcada, sem recarregar a página. Ele também mantém os filtros escolhidos no endereço da web (a URL), para que um cliente possa salvar nos favoritos ou compartilhar uma visualização filtrada.
Configuração
1. Prepare seus dados
Os filtros valem tanto quanto os seus dados de produto, então primeiro certifique-se de que seus produtos tenham:
- Categorias atribuídas (em cada produto ou em Produtos → Categorias).
- Atributos como Cor, Tamanho, Potência, Soquete (definidos em Produtos → Atributos e depois atribuídos aos produtos).
Dica: mantenha os slugs dos atributos em letras ASCII simples (por exemplo
socket,wattage). Slugs não latinos podem ser codificados incorretamente na URL.
2. Posicione o filtro
Adicione o filtro à sua loja com o shortcode [avs_filter]. Coloque-o em uma área de widgets (como uma barra lateral da loja) ou diretamente em uma página ou modelo de categoria, dependendo do seu tema. O filtro respeita automaticamente a página em que está — em uma página de categoria, ele filtra dentro dessa categoria.
3. Escolha quais filtros mostrar
Nas configurações do plugin você escolhe quais controles aparecem — categorias, faixa de preço, atributos individuais, status de estoque e avaliação — e em que ordem aparecem.
Referência de recursos
Filtragem AJAX com sincronização da URL
Cada alteração em um filtro dispara uma requisição AJAX — uma chamada em segundo plano ao servidor que retorna apenas os produtos correspondentes e os insere na grade, sem recarregar toda a página. Os filtros ativos são gravados na URL, de modo que:
- O botão Voltar do navegador funciona como esperado.
- Uma visualização filtrada pode ser salva nos favoritos ou compartilhada.
- Chegar diretamente a uma URL filtrada exibe os resultados corretos, já filtrados.
Controle deslizante de faixa de preço
Um controle deslizante de duas alças permite que os clientes definam um preço mínimo e máximo. A faixa se adapta aos produtos atualmente visíveis.
Filtros de atributos
Cada atributo do WooCommerce pode se tornar um grupo de filtros (caixas de seleção). Os clientes podem combinar vários — por exemplo Soquete: E27 e Temperatura de cor: Branco quente — para restringir os resultados com precisão.
- Free: até 4 filtros de atributos ativos por vez.
- Pro: filtros de atributos ilimitados — ideal para catálogos técnicos com muitas propriedades.
Filtros de estoque, avaliação e especiais
Filtros integrados além dos atributos:
- Em estoque — ocultar itens esgotados.
- Avaliação — mostrar apenas produtos a partir de uma avaliação por estrelas.
- Em promoção / em destaque — destacar promoções.
Contexto de página de categoria
Quando o filtro fica em um arquivo de categoria, ele restringe automaticamente os resultados a essa categoria, de modo que os clientes refinam dentro da seção que estão navegando, em vez de em toda a loja.
Free vs Pro num relance
| Recurso | Free | Pro |
|---|---|---|
| Filtragem AJAX com sincronização da URL | ✓ | ✓ |
| Controle deslizante de faixa de preço | ✓ | ✓ |
| Filtros de estoque, avaliação e especiais | ✓ | ✓ |
| Contexto de página de categoria | ✓ | ✓ |
| Filtros de atributos ativos | até 4 | ilimitados |
| Compatibilidade com o tema XStore | — | ✓ |
Notas avançadas
- Compatibilidade com XStore (Pro): o XStore gera as páginas da loja com sua própria marcação; o Pro inclui uma integração específica para que o filtro se conecte corretamente à grade de produtos e ao AJAX do XStore. Em temas padrão/genéricos, o filtro funciona sem isso.
- Consultas orientadas pela URL: os filtros modificam a consulta principal de produtos, então os resultados são consultas reais do WooCommerce (paginação, ordenação e contagens corretas) em vez de um truque de mostrar/ocultar do lado do cliente.
- Desempenho: a filtragem usa o contexto de categoria para manter as consultas focadas e rápidas mesmo em catálogos grandes.
Resolução de problemas
- Um atributo não é oferecido como filtro — confirme que é um atributo global (em Produtos → Atributos) e que está atribuído a produtos; no Free, lembre-se do limite de 4 atributos.
- As URLs filtradas parecem quebradas ou codificadas duas vezes — verifique se os slugs dos atributos estão em ASCII simples.
- O filtro aparece sem estilo no XStore — o XStore precisa da integração Pro; conecte sua licença Pro.
Para conectar uma licença Pro, consulte Instalar e atualizar plugins.