Introducción

El módulo Filters permite crear conjuntos de filtros — colecciones nombradas que combinan datos de diferentes módulos del sistema en una lista gestionada.

Un filtro es, en esencia, un conjunto predefinido de opciones que se configura una vez en la administración y luego se reutiliza en la aplicación del cliente: para construir listas desplegables, paneles de filtrado en el catálogo, selectores y en cualquier otro lugar donde el usuario necesite seleccionar un valor de una lista previamente preparada.

La idea clave del módulo es que no necesitas duplicar datos manualmente. En el conjunto de filtros, agregas enlaces a entidades ya existentes (productos, páginas, descuentos, etc.), y si es necesario, los complementas con tus propios valores arbitrarios.

Creación de un conjunto de filtros

Para crear un nuevo conjunto de filtros:

1. Abre el módulo Filters en el menú de la izquierda.
2. Debajo de la lista de conjuntos hay un formulario Create Filter. Completa los dos campos:
   • Name — el nombre del conjunto de filtros;
   • Marker — un identificador único, que se puede utilizar para acceder al conjunto en el código de la aplicación.
3. Haz clic en Add — el conjunto aparecerá en la lista.
4. Abre el conjunto con el botón de edición: se habilitará la selección de tipos de elementos que formarán parte del filtro.

Tipos de elementos

Después de crear el conjunto, eliges qué tipos de datos participarán en el filtro. Cada tipo es una tabla de datos, formada a partir de registros que ya han sido creados en los módulos correspondientes del sistema:

• Pages — páginas del proyecto.
• Products — productos del catálogo.
• Admins — administradores del sistema.
• Attribute — atributos de los conjuntos de atributos.
• Discounts — descuentos.
• Personal Discounts — descuentos personales (individuales).
• Bonuses — bonificaciones.
• Payment Methods — métodos de pago.

Al seleccionar un tipo, obtienes una tabla con los registros actuales de ese módulo y marcas en ella los elementos que deben formar parte del conjunto de filtros. De esta manera, el filtro siempre se basa en datos reales del sistema.

info

Los elementos en las tablas de tipos son enlaces a registros existentes de otros módulos. Si el registro original (por ejemplo, un producto o un descuento) se modifica, el conjunto de filtros mostrará sus datos actualizados.

Configure Filter — elementos personalizados

Además de los datos de otros módulos, se pueden agregar valores arbitrarios propios al conjunto de filtros. Esto es útil cuando el elemento deseado no está en ningún módulo — por ejemplo, opciones como "Todos", "Sin categoría" o cualquier valor de servicio.

Al cambiar a la vista Configure Filter, se abre una tabla con los datos seleccionados del conjunto. En esta vista no seleccionas nuevos registros, sino que configuras cómo se dispondrán y agruparán los elementos ya seleccionados en el filtro final.

La vista se activa con la casilla Configure Filter sobre la lista de elementos. La selección se recuerda: si activas la vista en un conjunto, permanecerá activada al abrir otros conjuntos de filtros en este navegador.

En la tabla Configure Filter están disponibles las siguientes acciones:

• Arrastrar y soltar (drag-and-drop) — las filas se pueden arrastrar, cambiando su orden. Así defines en qué secuencia se mostrarán los elementos al usuario.

• Construcción de jerarquía — arrastrando una fila dentro de otra se pueden crear elementos anidados (jerarquía). Esto permite agrupar filtros por niveles — por ejemplo, una categoría principal y los valores anidados en ella.

• Mover elementos seleccionados — una segunda forma de construir jerarquía, conveniente para varias filas a la vez:

  1. Haz clic en Select items — las filas mostrarán casillas de verificación. Marca los elementos deseados; el botón Select All marca todos, el contador Selected muestra cuántos han sido seleccionados.
  2. Haz clic en Attach to parent.
  3. En la ventana Choose parent for transfer, haz clic en el elemento que se convertirá en padre, o selecciona To root (top level) para llevar los elementos al nivel superior, y confirma con el botón Move. Los elementos seleccionados se trasladan junto con sus anidados.

  El botón Cancel sale del modo de selección sin mover.

Agregar elementos personalizados

Directamente en esta tabla se pueden agregar valores arbitrarios propios — esto es útil cuando el elemento deseado no está en ningún módulo (por ejemplo, opciones como "Todos", "Sin categoría" o valores de servicio).

1. Haz clic en Add Custom Item para agregar un nuevo elemento.
2. Completa dos campos:
   • Title — el nombre que se mostrará del elemento (lo que verá el usuario).
   • Value — el valor del elemento (lo que se enviará como opción seleccionada).

Los elementos personalizados se agregan a los datos ya seleccionados y también participan en el arrastre y la construcción de jerarquía. Se almacenan dentro del conjunto de filtros y no dependen de otros módulos.