Filters

Interfaz de filtros #

Los filtros se pueden usar para cada Content para acotar los resultados según los atributos de tu producto.

Encontrarás esta opción en cada Content que crees para Recommendations, Search o Email, bajo Content type > Product filters.

Cada parte del filtro consta de lo siguiente:

• Un atributo por el cual filtrar
• Una comparación que decide cómo se debe comparar el atributo con el valor
• Un valor que determina con qué se debe comparar el atributo

Puedes crear filtros basados en cualquier atributo de producto que envíes a Clerk. Los operadores de comparación disponibles dependen del tipo de atributo por el que filtres.

Por ejemplo, price contiene un número, lo que significa que puedes usar tanto mayor que, menor que y otras comparaciones numéricas, mientras que los atributos de texto/cadena como name solo permiten comparaciones booleanas como es o no es.

Al crear filtros, la interfaz te mostrará cuántos productos coinciden con el filtro y el string del filtro generado.

Filtros simples #

Estos contienen solo un atributo y una comparación. Un ejemplo es mostrar solo productos por debajo de €400:

Conjuntos de filtros #

Estos te permiten acotar la selección de productos agregando múltiples filtros dentro del mismo conjunto. Puedes hacerlo haciendo clic en el icono "+" dentro de un filtro existente y agregando uno nuevo.

Dentro de un conjunto, puedes elegir entre dos lógicas de filtrado:

• AND solo muestra productos que cumplen todos los filtros del conjunto.
• OR muestra productos que cumplen al menos uno de los filtros del conjunto.

Ejemplo: Quieres mostrar solo productos que estén por debajo de €400 y también en oferta.

Combinando conjuntos #

Puedes combinar conjuntos de filtros para que funcionen juntos mediante diferentes condiciones. En lugar de agregar filtros dentro de un conjunto existente, haz clic en "+ Add filter" para iniciar un nuevo conjunto.

Cada conjunto de filtros funciona por separado, y puedes elegir cómo interactúan:

• AND solo muestra productos que cumplen todos los conjuntos.
• OR muestra productos que cumplen al menos uno de los conjuntos.

Ejemplo: Quieres mostrar productos que estén por debajo de €400 Y en oferta, pero también que sean de Vendor A O de una categoría específica.

• El primer conjunto garantiza que los productos cumplan con las condiciones de precio y oferta.
• El segundo conjunto permite flexibilidad al incluir productos de ya sea un vendedor específico o una categoría específica.

String del filtro #

La interfaz de filtros crea automáticamente la sintaxis correcta según los datos disponibles en tus atributos. Por ejemplo, si tus SKU tienen formato de cadenas como “GT-1234”, las comillas se agregan automáticamente al string del filtro.

sku = "GT-1234"

Si un atributo es un número, se agrega sin comillas.

price < 300

Si tienes problemas con el filtrado, revisa el string del filtro para asegurarte de que la sintaxis sea correcta y haz ajustes si es necesario.

Si tienes dudas, puedes ver qué tipo de dato tiene un atributo (string, number, list, boolean) yendo a Data > Products y revisando cualquier producto.

Siempre puedes ajustar manualmente el string del filtro para que se adapte a tus necesidades haciendo clic en el icono de lápiz junto a Filter expression.

Filtrado dinámico #

Filters se pueden añadir directamente a los códigos de inserción usando el atributo data-filter. Esto te permite hacer filtros dinámicos cambiando los valores según la lógica del frontend.

A continuación, varios ejemplos comunes de cómo puedes usar el filtrado dinámico.

Límite de envío gratis #

Define una variable, por ejemplo, $free_shipping_limit, que contenga la cantidad restante que el cliente necesita para alcanzar el límite de envío gratis. Usa esto como filtro dinámico para mostrar solo productos por encima de este precio:

<span class="clerk"
      data-template="@complementary-to-basket"
      data-filter="price > $free_shipping_limit">
</span>

Coincidencia de género #

Si tus productos tienen un atributo como gender que contiene female, male, kids, unisex, etc., puedes hacer que los elementos de Clerk muestren productos para el mismo género.

Define una variable, por ejemplo, $product_gender, que contenga el género del producto que se está viendo actualmente y úsala para mostrar productos para el mismo género:

<span class="clerk"
      data-template="@Bestsellers"
      data-filter="gender = $product_gender">
</span>

Categoría específica #

En este caso necesitas una lista en tu tienda que contenga las categorías de productos, que podría definirse como $available_categories = [1,2,3,4,5]. Usa esto para filtrar sliders y mostrar solo productos de esas categorías:

<span class="clerk"
      data-template="@type-slider"
      data-filter="categories in $available_categories">
</span>