Introdução

O módulo Filters permite criar conjuntos de filtros — coleções nomeadas que combinam dados de diferentes módulos do sistema em uma única lista gerenciada.

Um filtro é, essencialmente, um conjunto pronto de opções de seleção que você monta uma vez no painel de administração e depois reutiliza no aplicativo do cliente: para construir listas suspensas, painéis de filtragem no catálogo, seletores e quaisquer outros lugares onde o usuário precise escolher um valor de uma lista previamente preparada.

A ideia principal do módulo é que você não precisa duplicar dados manualmente. No conjunto de filtros, você adiciona links para entidades já existentes (produtos, páginas, descontos, etc.), e, se necessário, complementa com seus próprios valores arbitrários.

Criando um conjunto de filtros

Para criar um novo conjunto de filtros:

1. Abra o módulo Filters no menu à esquerda.
2. Clique no botão de criação do conjunto e dê um nome a ele.
3. Após a criação do conjunto, a seleção de tipos de elementos que farão parte do filtro estará disponível.

Tipos de elementos

Após criar o conjunto, você escolhe quais tipos de dados participarão do filtro. Cada tipo é uma tabela de dados, formada a partir de registros que já foram criados nos módulos correspondentes do sistema:

• Pages — páginas do projeto.
• Products — produtos do catálogo.
• Admins — administradores do sistema.
• Attribute — atributos de conjuntos de atributos.
• Discounts — descontos.
• Personal Discounts — descontos pessoais (individuais).
• Bonuses — bônus.
• Payment Methods — métodos de pagamento.

Ao escolher um tipo, você obtém uma tabela com os registros atuais desse módulo e marca os elementos que devem fazer parte do conjunto de filtros. Assim, o filtro sempre se baseia em dados reais do sistema.

info

Os elementos nas tabelas de tipos são links para registros existentes de outros módulos. Se o registro original (por exemplo, um produto ou desconto) for alterado, o conjunto de filtros exibirá seus dados atualizados.

Configure Filter — elementos personalizados

Além dos dados de outros módulos, você pode adicionar valores arbitrários próprios ao conjunto de filtros. Isso é útil quando o elemento desejado não está em nenhum módulo — por exemplo, opções como "Todos", "Sem categoria" ou quaisquer valores de serviço.

Ao alternar para a visualização Configure Filter, uma tabela com os dados selecionados do conjunto é aberta. Nessa visualização, você não escolhe novos registros, mas configura como os elementos já selecionados serão dispostos e agrupados no filtro final.

Na tabela Configure Filter, as seguintes ações estão disponíveis:

• Arrastar e soltar (drag-and-drop) — as linhas podem ser arrastadas, alterando sua ordem. Assim, você define em que sequência os elementos serão exibidos para o usuário.
• Construção de hierarquia — arrastando uma linha para dentro de outra, você pode criar elementos aninhados (hierarquia). Isso permite agrupar filtros por níveis — por exemplo, uma categoria pai e os valores aninhados a ela.

Adicionando elementos personalizados

Diretamente nesta tabela, você pode adicionar valores arbitrários próprios — isso é conveniente quando o elemento desejado não está em nenhum módulo (por exemplo, opções como "Todos", "Sem categoria" ou valores de serviço).

1. Clique em Add Custom Item para adicionar um novo elemento.
2. Preencha dois campos:
   • Title — o nome exibido do elemento (o que o usuário verá).
   • Value — o valor do elemento (o que será enviado como a opção selecionada).

Os elementos personalizados são adicionados aos dados já selecionados e também participam do arrasto e da construção de hierarquia. Eles são armazenados dentro do conjunto de filtros e não dependem de outros módulos.