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.

• Versão gratuita: filtragem AJAX completa em todos os atributos de produto (sem limite), controle deslizante de preço, filtros de estoque/em promoção/novidade/avaliação, contexto de categoria, e funciona com temas clássicos, de blocos e XStore.
• Versão Pro: corresponde a todos os valores selecionados de um atributo (lógica AND), suas próprias escolhas de produtos por página, uma cor exata para cada valor de amostra e uma cache de resultados para filtragem repetida mais rápida. O Pro precisa da edição transferida de rotozoom.com, que instala o Rotozoom Connect automaticamente — onde inicia sessão com a sua conta Rotozoom.
• Preço Pro: 47 € / ano por site, IVA incl.

---

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

O filtro aparece automaticamente nas páginas da sua loja, categoria, etiqueta e pesquisa. Para colocá-lo noutro lugar — em qualquer página ou publicação — utilize o shortcode [rotozoom_filter] (opções: category, per_page, columns, orderby, sidebar="0", bar="0"); [rotozoom_filter_bar] apresenta a barra de ordenação/por página por si só. O filtro respeita automaticamente a página em que está — numa página de categoria, ele filtra dentro dessa categoria.

3. Escolha quais filtros mostrar

Nas definições do plugin (Rotozoom → Product Filter) escolhe quais os controlos que aparecem — categorias, intervalo de preços, atributos individuais, estado de stock e avaliação — e a ordem em que 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 controlo de deslize com duas pegas permite aos clientes definir um preço mínimo e máximo. O intervalo abrange os preços de toda a categoria atual (incluindo as respetivas subcategorias), ou de toda a loja nas páginas de loja e pesquisa; não se estreita à medida que outros filtros são selecionados.

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: cada atributo pode ser um filtro — não há limite. Os produtos correspondem se tiverem pelo menos um dos valores selecionados de um atributo (OR).
• Pro: por atributo, pode escolher Todos (AND) em Secções, para que os produtos tenham de ter todos os valores selecionados — 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 com uma classificação por estrelas igual ou superior (desativado por predefinição; ative-o em Secções → Visibilidade da secção).
• Em promoção — destacar promoções.
• Novo — mostrar produtos recentemente adicionados.

Contexto de página de categoria

Quando o filtro se encontra num arquivo de categoria, restringe automaticamente os resultados a essa categoria, para que os clientes afinem dentro da secção que estão a consultar e não em toda a loja.

Extras Pro

• Correspondência AND — exige todos os valores selecionados de um atributo.
• Produtos por página — oferece aos clientes as suas próprias escolhas por página.
• Cores exatas de amostra — define a cor exata apresentada para cada valor de cor.
• Cache de resultados — os resultados de filtros repetidos para visitantes com sessão encerrada são fornecidos a partir de uma cache no seu próprio site, atualizada quando os produtos ou o stock mudam.

Free vs Pro num relance

Recurso	Free	Pro
Filtragem AJAX com sincronização da URL	✓	✓
Controle deslizante de faixa de preço	✓	✓
Filtros de stock, em promoção, novos e avaliação	✓	✓
Contexto de página de categoria	✓	✓
Filtros de todos os atributos de produto (sem limite)	✓	✓
Temas clássicos, de blocos e XStore	✓	✓
Correspondência AND por atributo	—	✓
Escolhas personalizadas de produtos por página	—	✓
Cor exata por valor de amostra	—	✓
Cache de resultados	—	✓

Notas avançadas

• Compatibilidade com o XStore (Free e Pro): O XStore apresenta as páginas da loja com a sua própria marcação; o plugin inclui integração específica para que o filtro se ligue corretamente à grelha de produtos e ao AJAX do XStore. Em temas padrão/genéricos, o filtro funciona sem isto.
• 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 se trata de um atributo global (em Produtos → Atributos) e que está atribuído a produtos.
• As URLs filtradas parecem quebradas ou codificadas duas vezes — verifique se os slugs dos atributos estão em ASCII simples.
• O filtro parece sem estilo no XStore — certifique-se de que o filtro está numa página de loja ou categoria do WooCommerce e limpe qualquer cache de página.

Para ativar o Pro (descarregar de rotozoom.com e iniciar sessão através do Rotozoom Connect), consulte Instalar e atualizar plugins.