Filters

Interfaz de filtros #

Los filtros se pueden usar para cada Content para limitar los resultados según los atributos de tus productos.

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

Cada parte del filtro consiste en 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 decide 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 estás filtrando.

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 la cadena de filtro generada.

Filtros simples #

Estos contienen un solo atributo y comparación. Por ejemplo, establece price en menor que €400 para mostrar solo productos por debajo de esa cantidad.

Conjuntos de filtros #

Estos te permiten limitar la selección de productos añadiendo múltiples filtros dentro del mismo conjunto. Puedes hacer esto haciendo clic en el ícono "+" dentro de un filtro existente y añadiendo uno nuevo.

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

• AND solo muestra productos que coinciden con todos los filtros del conjunto.
• OR muestra productos que coinciden con 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 trabajen juntos bajo diferentes condiciones. En vez de agregar filtros dentro de un conjunto existente, haz clic en "+ Add filter" para iniciar un nuevo conjunto.

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

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

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

• El primer conjunto asegura que los productos cumplan las condiciones de precio y oferta.
• El segundo conjunto permite flexibilidad incluyendo productos de cualquier proveedor o categoría específica.

Cadena de filtro #

La Interfaz de Filtros crea automáticamente la sintaxis correcta basada en los datos disponibles en tus atributos. Por ejemplo, si tus SKU están formateados como cadenas tipo “GT-1234”, las comillas se agregan automáticamente a la cadena de filtro.

sku = "GT-1234"

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

price < 300

Si tienes problemas con el filtrado, revisa la cadena de filtro para asegurarte de que se usa la sintaxis correcta, y haz los ajustes necesarios.

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

Siempre puedes ajustar manualmente la cadena de filtro según tus necesidades haciendo clic en el ícono de lápiz junto a Filter expression.

Valores dinámicos de atributos #

Al crear filtros para campañas de Merchandising o Content que utilizan lógicas basadas en productos, puedes referenciar los atributos del producto visualizado como valores dinámicos escribiendo {{ attribute_name }}.

En el momento de la evaluación, el placeholder se reemplaza por el valor real del producto que se está visualizando. Por ejemplo, un filtro como type = {{ type }} asegura que los resultados solo incluyan productos con el mismo type que el que el visitante está viendo actualmente.

Esto es especialmente útil cuando quieres que los filtros se adapten automáticamente sin codificar valores específicos. Puedes combinar valores dinámicos con otros filtros, por ejemplo, type = {{ type }} junto con price < 500 para coincidir solo con productos del mismo tipo por debajo de €500.

Los valores dinámicos de atributos solo funcionan cuando la solicitud incluye uno o más IDs de producto, como Best Cross-Sell y Best Alternatives en Recommendations.

Filtrado dinámico #

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

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

Límite de envío gratuito #

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 gratuito. Usa esto como un filtro dinámico para mostrar solo productos por encima de ese precio:

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

Coincidir género #

Si tus productos contienen 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 del 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 producto, que podría definirse como $available_categories = [1,2,3,4,5]. Úsala para filtrar los sliders y mostrar solo productos de esas categorías:

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