Introduction

Le module Filters permet de créer des ensembles de filtres : des collections nommées qui réunissent des données de différents modules du système en une seule liste gérée.

Un filtre est un ensemble d'options de sélection prêt à l'emploi. Vous le constituez une fois dans l'interface d'administration, puis vous le réutilisez dans l'application cliente pour construire des listes déroulantes, des panneaux de filtrage du catalogue, des sélecteurs et tout autre endroit où l'utilisateur choisit une valeur dans une liste préparée à l'avance.

Le principe du module est que vous n'avez pas à dupliquer les données à la main. Vous ajoutez à l'ensemble de filtres des liens vers des entités existantes (produits, pages, remises, etc.) et, si besoin, vous les complétez par vos propres valeurs arbitraires.

Création d'un ensemble de filtres

Pour créer un ensemble de filtres :

1. Ouvrez le module Filters dans le menu de gauche.
2. Sous la liste des ensembles se trouve le formulaire Create Filter. Remplissez ses deux champs :
   • Name : nom de l'ensemble de filtres ;
   • Marker : identifiant unique qui permet de récupérer l'ensemble dans le code de l'application.
3. Cliquez sur Add. L'ensemble apparaît dans la liste.
4. Ouvrez l'ensemble avec le bouton de modification. Vous pouvez alors choisir les types d'éléments qui feront partie du filtre.

Types d'éléments

Une fois l'ensemble créé, choisissez les types de données qui composeront le filtre. Chaque type est une table de données constituée des enregistrements déjà créés dans les modules correspondants du système :

• Pages : pages du projet.
• Products : produits du catalogue.
• Admins : administrateurs du système.
• Attribute : attributs des ensembles d'attributs.
• Discounts : remises.
• Personal Discounts : remises personnelles (individuelles).
• Bonuses : bonus.
• Payment Methods : méthodes de paiement.

Lorsque vous choisissez un type, une table affiche les enregistrements actuels de ce module. Cochez-y les éléments à inclure dans l'ensemble de filtres. Le filtre s'appuie ainsi toujours sur les données réelles du système.

info

Les éléments des tables de types sont des liens vers des enregistrements existants d'autres modules. Si l'enregistrement d'origine (un produit ou une remise, par exemple) est modifié, l'ensemble de filtres affiche ses données à jour.

Configure Filter : éléments personnalisés

En plus des données des autres modules, vous pouvez ajouter à l'ensemble de filtres vos propres valeurs arbitraires. C'est utile lorsque l'élément voulu n'existe dans aucun module, par exemple les options « Tous », « Sans catégorie » ou toute autre valeur technique.

La vue Configure Filter affiche une table des données sélectionnées de l'ensemble. Dans cette vue, vous ne choisissez pas de nouveaux enregistrements : vous définissez comment les éléments déjà retenus sont disposés et regroupés dans le filtre final.

Activez cette vue avec la case Configure Filter au-dessus de la liste des éléments. Le choix est mémorisé : si vous l'activez dans un ensemble, elle reste activée à l'ouverture des autres ensembles de filtres dans ce navigateur.

Dans la table Configure Filter, vous pouvez :

• Glisser-déposer (drag-and-drop) les lignes pour changer leur ordre. Vous définissez ainsi l'ordre dans lequel les éléments s'affichent pour l'utilisateur.

• Créer une imbrication : en faisant glisser une ligne dans une autre, vous créez des éléments imbriqués (une hiérarchie). Vous pouvez ainsi regrouper les filtres par niveaux, par exemple une catégorie parente et les valeurs qu'elle contient.

• Déplacer les éléments sélectionnés : une autre façon de créer une imbrication, pratique pour plusieurs lignes à la fois :

  1. Cliquez sur Select items : des cases à cocher apparaissent sur les lignes. Cochez les éléments voulus. Select All les coche tous, et le compteur Selected indique combien sont sélectionnés.
  2. Cliquez sur Attach to parent.
  3. Dans la fenêtre Choose parent for transfer, cliquez sur l'élément qui deviendra le parent, ou choisissez To root (top level) pour placer les éléments au niveau supérieur, puis confirmez avec Move. Les éléments sélectionnés sont déplacés avec leurs éléments imbriqués.

  Cancel quitte le mode de sélection sans rien déplacer.

Ajout d'éléments personnalisés

Vous pouvez ajouter vos propres valeurs arbitraires directement dans cette table. C'est utile lorsque l'élément voulu n'existe dans aucun module (par exemple les options « Tous », « Sans catégorie » ou des valeurs techniques).

1. Cliquez sur Add Custom Item pour ajouter un élément.
2. Remplissez ses deux champs :
   • Title : nom affiché de l'élément (ce que voit l'utilisateur) ;
   • Value : valeur de l'élément (ce qui est transmis comme option sélectionnée).

Les éléments personnalisés s'ajoutent aux données déjà sélectionnées et participent eux aussi au glisser-déposer et à l'imbrication. Ils sont stockés dans l'ensemble de filtres et ne dépendent d'aucun autre module.