Introducción

El módulo Filters te permite crear conjuntos de filtros: colecciones con nombre que reúnen datos de distintos módulos del sistema en una sola lista gestionable.

Un filtro es, en esencia, un conjunto de opciones listo para usar. Lo creas una vez en el panel de administración y luego lo reutilizas en la aplicación cliente: en listas desplegables, paneles de filtrado del catálogo, selectores y cualquier otro lugar donde el usuario tenga que elegir un valor de una lista preparada de antemano.

La idea clave del módulo es que no tienes que duplicar datos a mano. Al conjunto de filtros le agregas enlaces a entidades que ya existen (productos, páginas, descuentos, etc.) y, si hace falta, los completas con tus propios valores personalizados.

Creación de un conjunto de filtros

Para crear un conjunto de filtros:

1. Abre el módulo Filters en el menú de la izquierda.
2. Debajo de la lista de conjuntos está el formulario Create Filter. Completa sus dos campos:
   • Name: el nombre del conjunto de filtros.
   • Marker: un identificador único con el que el código de la aplicación obtiene el conjunto.
3. Haz clic en Add. El conjunto aparece en la lista.
4. Abre el conjunto con el botón de edición. Ahora puedes elegir los tipos de elementos que formarán parte del filtro.

Tipos de elementos

Después de crear el conjunto, elige qué tipos de datos usará el filtro. Cada tipo es una tabla de datos formada por registros que ya existen en el módulo correspondiente 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 elegir un tipo, obtienes una tabla con los registros actuales de ese módulo, y en ella marcas los elementos que deben entrar en el conjunto de filtros. Así, el filtro siempre se basa en datos reales del sistema.

info

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

Configure Filter: elementos personalizados

Además de los datos de otros módulos, puedes agregar al conjunto de filtros tus propios valores personalizados. Es útil cuando el elemento que necesitas no existe en ningún módulo, por ejemplo, opciones como "Todos", "Sin categoría" o cualquier valor auxiliar.

La vista Configure Filter abre una tabla con los datos seleccionados del conjunto. En ella no eliges registros nuevos: configuras cómo se ordenan y agrupan en el filtro final los elementos que ya seleccionaste.

Para activar la vista, marca la casilla Configure Filter, situada sobre la lista de elementos. La elección se recuerda: si activas la vista en un conjunto, seguirá activada al abrir otros conjuntos de filtros en el mismo navegador.

En la tabla Configure Filter puedes:

• Arrastrar y soltar (drag-and-drop): arrastra las filas para cambiar su orden. Así defines en qué orden verá el usuario los elementos.

• Crear jerarquías: arrastra una fila dentro de otra para crear elementos anidados. Así puedes agrupar los filtros por niveles, por ejemplo, una categoría principal con los valores que contiene.

• Mover los elementos seleccionados: una segunda forma de crear jerarquías, práctica para varias filas a la vez:

  1. Haz clic en Select items. Aparecen casillas junto a las filas. Marca los elementos que necesites; Select All los marca todos y el contador Selected indica cuántos hay seleccionados.
  2. Haz clic en Attach to parent.
  3. En la ventana Choose parent for transfer, haz clic en el elemento que será el padre, o elige To root (top level) para llevar los elementos al nivel superior, y confirma con Move. Los elementos seleccionados se mueven junto con sus elementos anidados.

  Cancel sale del modo de selección sin mover nada.

Agregar elementos personalizados

En esta misma tabla puedes agregar tus propios valores personalizados. Es útil cuando el elemento que necesitas no existe en ningún módulo (por ejemplo, opciones como "Todos", "Sin categoría" o valores auxiliares).

1. Haz clic en Add Custom Item.
2. Completa dos campos:
   • Title: el nombre visible del elemento (lo que ve el usuario).
   • Value: el valor del elemento (lo que se envía como opción seleccionada).

Los elementos personalizados se suman a los datos ya seleccionados y también se pueden arrastrar y anidar. Se guardan dentro del conjunto de filtros y no dependen de otros módulos.