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 referências a 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. Abaixo da lista de conjuntos, há um formulário Create Filter. Preencha os dois campos:
   • Name — nome do conjunto de filtros;
   • Marker — identificador único, pelo qual o conjunto pode ser acessado no código do aplicativo.
3. Clique em Add — o conjunto aparecerá na lista.
4. Abra o conjunto clicando no botão de edição: a seleção de tipos de elementos que farão parte do filtro ficará 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 referências a 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.

A visualização é ativada pela caixa de seleção Configure Filter acima da lista de elementos. A seleção é lembrada: se você ativar a visualização em um conjunto, ela permanecerá ativada ao abrir outros conjuntos de filtros neste navegador.

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.

• Mover elementos selecionados — uma segunda maneira de construir hierarquia, conveniente para várias linhas de uma só vez:

  1. Clique em Select items — as linhas exibirão 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 se tornará o pai, ou escolha To root (top level) para mover os elementos para o nível superior, e confirme clicando em Move. Os elementos selecionados são movidos junto com seus aninhados.

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

Adicionando elementos personalizados

Diretamente nesta tabela, você pode adicionar valores arbitrários próprios — isso é útil 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 os 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 são adicionados aos dados já selecionados e também participam do arrastar e soltar e da construção de hierarquia. Eles são armazenados dentro do conjunto de filtros e não dependem de outros módulos.