Aller au contenu principal

Introduction

Construisez une navigation et un filtrage par facettes à partir d'un seul arbre de filtres de contenu localisé.

Plus d'informations sur l'interface utilisateur du module https://doc.oneentry.cloud/docs/category/filters

🎯 Que fait ce module ?​

Le module Filters vous permet de récupérer un filtre de contenu par son marqueur. Un filtre de contenu est un arbre d'éléments localisé et organisé - il peut mélanger des pages, des produits, des attributs, des remises, des bonus, des méthodes de paiement et des entrées personnalisées dans une seule structure.

Considérez-le comme un menu configurable de "choses à filtrer" - vous définissez l'arbre une fois dans le panneau d'administration OneEntry et l'intégrez dans votre application pour rendre la navigation, les filtres par facettes ou les listes organisées.

📖 Explication Simple​

Un filtre de contenu est un arbre où chaque nœud pointe vers quelque chose dans votre projet :

  • 📄 page - un lien vers une page (a un url)
  • 🛍️ produit - une entrée de produit
  • 🏷️ attribut - un attribut à filtrer
  • 💸 remise / remise-personnelle - une entrée de remise
  • 🎁 bonus - une entrée de bonus
  • 💳 méthode-de-paiement - une méthode de paiement
  • ✏️ personnalisé - une entrée personnalisée que vous avez définie

Chaque nœud contient des informations localisées et peut contenir des enfants imbriqués, vous permettant de rendre des filtres et des menus multi-niveaux directement à partir de la réponse.

✨ Concepts Clés​

Marqueur​

Chaque filtre a un marqueur unique (par exemple main). Vous demandez un filtre par marqueur, et la réponse est localisée selon le code de langue demandé.

Arbre des éléments​

Le tableau items est un arbre : les éléments réguliers et personnalisés vivent dans le même tableau, et chaque nœud peut avoir des enfants. Parcourez l'arbre pour rendre votre interface utilisateur.

📋 Ce Que Vous Devez Savoir​

  • Passez un langCode pour obtenir le filtre localisé dans une langue spécifique (par défaut en_US).
  • Les nœuds de page (type: "page") exposent un url ; les autres types de nœuds utilisent marker pour référencer leur entité.
  • Le champ value porte une valeur de nœud unifiée (par exemple une valeur de remise ou un titre d'attribut) lorsque cela est applicable.

📊 Tableau de Référence Rapide​

MéthodeDescription
getFilterByMarker()Obtenez un filtre de contenu par son marqueur

❓ Questions Fréquemment Posées (FAQ)​

D'où viennent les filtres de contenu ?​

Les filtres de contenu sont configurés dans le panneau d'administration OneEntry. Le SDK les récupère en lecture seule par marqueur.

Comment rendre un filtre multi-niveaux ?​

Parcourez récursivement le tableau items - chaque nœud peut contenir un tableau enfants avec la même structure de nœud.

🎓 Meilleures Pratiques​

  • Référez-vous aux filtres par marqueur, jamais par un titre d'affichage.
  • Demandez le filtre dans la langue actuelle de l'utilisateur via langCode.
  • Mettez en cache les filtres - ils changent rarement.

Définition du module Filters​


const { Filters } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 Documentation Connexe​