Introdução

O módulo Filters permite criar conjuntos de filtros: coleções nomeadas que reúnem dados de diferentes módulos do sistema em uma única lista gerenciável.

Em essência, um filtro é um conjunto pronto de opções que você monta uma vez no painel de administração e reutiliza no aplicativo cliente: em listas suspensas, painéis de filtragem do catálogo, seletores e em qualquer outro lugar onde o usuário precise escolher um valor de uma lista preparada com antecedência.

A ideia central do módulo é que você não precisa duplicar dados manualmente. Você adiciona ao conjunto de filtros referências a entidades que já existem (produtos, páginas, descontos etc.) e, se necessário, complementa a lista com seus próprios valores arbitrários.

Criando um conjunto de filtros

Para criar um conjunto de filtros:

1. Abra o módulo Filters no menu à esquerda.
2. No formulário Create Filter, abaixo da lista de conjuntos, preencha dois campos:
   • Name: nome do conjunto de filtros;
   • Marker: identificador único usado para obter o conjunto no código do aplicativo.
3. Clique em Add. O conjunto aparece na lista.
4. Abra o conjunto pelo botão de edição. Agora você pode escolher os tipos de elementos que farão parte do filtro.

Tipos de elementos

Depois de criar o conjunto, escolha os tipos de dados que o filtro vai usar. Cada tipo é uma tabela de dados formada pelos registros já criados no módulo correspondente:

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

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

info

Os elementos das tabelas de tipos são referências a registros existentes de outros módulos. Se o registro original (por exemplo, um produto ou um desconto) for alterado, o conjunto de filtros exibirá os dados atualizados.

Configure Filter: elementos personalizados

Além dos dados de outros módulos, você pode adicionar ao conjunto de filtros seus próprios valores arbitrários. Isso é útil quando o elemento necessário não existe em nenhum módulo, como as opções "All", "No category" ou outros valores de serviço.

A visualização Configure Filter mostra uma tabela com os dados selecionados do conjunto. Nela, você não escolhe novos registros: você define como os elementos já selecionados serão ordenados e agrupados no filtro final.

Para ativar essa visualização, marque a caixa de seleção Configure Filter acima da lista de elementos. A escolha fica salva: se você ativá-la em um conjunto, ela continuará ativada ao abrir outros conjuntos de filtros neste navegador.

Na tabela Configure Filter, você pode:

• Arrastar e soltar (drag-and-drop): arraste as linhas para mudar a ordem delas. É assim que você define a sequência em que os elementos aparecem para o usuário.

• Criar uma hierarquia: arraste uma linha para dentro de outra para criar nested elements (uma hierarquia). Isso permite agrupar filtros em níveis, por exemplo, uma categoria pai e os valores aninhados nela.

• Mover os elementos selecionados: outra forma de criar a hierarquia, prática para várias linhas de uma vez:

  1. Clique em Select items. As linhas passam a exibir caixas de seleção. Marque os elementos desejados; o botão Select All marca todos, e o contador Selected mostra quantos foram selecionados.
  2. Clique em Attach to parent.
  3. Na janela Choose parent for transfer, clique no elemento que será o pai ou escolha To root (top level) para mover os elementos para o nível superior. Confirme com Move. Os elementos selecionados são movidos junto com os elementos aninhados a eles.

  O botão Cancel sai do modo de seleção sem mover nada.

Adicionando elementos personalizados

Nesta mesma tabela, você pode adicionar seus próprios valores arbitrários, úteis quando o elemento necessário não existe em nenhum módulo (por exemplo, as opções "All", "No category" ou valores de serviço).

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

Os elementos personalizados se somam aos dados já selecionados e também podem ser arrastados e aninhados. Eles ficam armazenados dentro do conjunto de filtros e não dependem de outros módulos.