Introduction
Récupérez les étiquettes de statut des produits ("Nouveau", "Promotion", "Rupture de Stock") pour badge et filtrer les éléments du catalogue.
Plus d'informations sur les statuts des produits dans le panneau d'administration OneEntry : https://doc.oneentry.cloud/docs/category/catalog
🎯 Que fait ce module ?
Le module ProductStatuses permet des conditions de filtrage supplémentaires pour les éléments du catalogue en plus des filtres basés sur les attributs existants. Les statuts des produits vous permettent de créer des étiquettes et des filtres personnalisés - comme "Nouvelle Arrivée", "Meilleure Vente", "Promotion", "Rupture de Stock" - pour organiser et filtrer les produits dans votre catalogue e-commerce.
Les statuts servent de mécanismes de filtrage supplémentaires pour les éléments du catalogue, travaillant en conjonction avec le filtrage basé sur les attributs pour fournir des options d'organisation et de catégorisation plus granulaires pour la gestion des produits.
Considérez-le comme votre système de balisage de produits - vous définissez les étiquettes de statut dans le panneau d'administration OneEntry (Catalogue > Statuts des Produits), les assignez aux produits, et les utilisez pour filtrer, badge et catégoriser les produits de manière dynamique.
📖 Explication Simple
Chaque boutique e-commerce doit mettre en avant des produits spéciaux :
- 🆕 Nouvelle Arrivée - Produits récemment ajoutés
- 🔥 Meilleure Vente - Articles populaires
- 💰 En Promotion - Produits à prix réduit
- ⭐ En Vedette - Produits mis en avant
- 📦 Rupture de Stock - Articles indisponibles
- 🎁 Édition Limitée - Produits exclusifs
- 🚚 Livraison Gratuite - Produits avec livraison gratuite
Problèmes :
- 🔒 Rigide - Nécessite des modifications de code pour ajouter de nouveaux statuts
- 📊 Difficile à gérer - Plusieurs champs booléens
- 🔄 Pas de réutilisabilité - Impossible de réutiliser la logique de statut
- 🎨 Incohérent - Styles de badge différents partout
La solution ProductStatuses :
Avantages :
- 🔒 Flexible - Ajouter/retirer des statuts dans le panneau d'administration
- 📊 Facile à gérer - Définitions de statut centralisées
- 🔄 Réutilisable - Même statut pour de nombreux produits
- 🎨 Cohérent - Rendu uniforme des badges
✨ Concepts Clés
Qu'est-ce qu'un Statut de Produit ?
Un Statut de Produit est une étiquette/tag personnalisée pour les produits :
- Nom du Statut - Nom affiché (ex. : "Nouvelle Arrivée", "Promotion")
- Marqueur de Statut - Identifiant unique pour le filtrage
- Couleur/Style - Représentation visuelle (configurée dans l'administration)
- Association de Produit - Quels produits ont ce statut
- Filtrage - Interroger les produits par statut
Flux de Travail du Statut de Produit
1. Create status in admin panel
(e.g., "New Arrival")
↓
2. Assign status to products
(Select products in admin)
↓
3. Fetch statuses via SDK
(ProductStatuses.getProductStatuses())
↓
4. Display status badges on products
(Render badges in product listings)
↓
5. Filter products by status
(Products.getProducts({ statusId }))
Pourquoi Utiliser le Module ProductStatuses ?
| Avantage | Description |
|---|---|
| Filtrage Flexible | Filtrer les produits par plusieurs critères personnalisés |
| Badges Dynamiques | Afficher des badges visuels sans codage dur |
| Gestion Facile | Ajouter/retirer des statuts dans le panneau d'administration |
| Étiquettes Réutilisables | Appliquer le même statut à de nombreux produits |
| Multi-Langue | Noms de statut localisés par langue |
| Style Personnalisé | Définir les couleurs et styles par statut |
📋 Ce Que Vous Devez Savoir
Les Statuts de Produits sont Créés dans le Panneau d'Administration
Vous ne pouvez pas créer de statuts via le SDK - ils sont créés dans le panneau d'administration OneEntry :
OneEntry Admin Panel → Catalog → Product Statuses → Create Status → Set Name/Marker → Save
Processus de Création :
- Fournir un Nom - Désignation du statut (obligatoire)
- Fournir un Marqueur - Identifiant unique (obligatoire, lettres/numéros latins/'_'/'-' uniquement)
- Cliquez sur "Créer" pour finaliser
Contraintes de Marqueur :
- Uniquement des lettres latines (a-z, A-Z)
- Chiffres (0-9)
- Symboles de soulignement (_) et de tiret (-)
- Aucun caractère spécial ou espace autorisé
Gestion des Statuts :
- Voir la Liste - Tableau avec les colonnes Nom, Marqueur et Actions
- Modifier le Statut - Modifier les champs Nom et Marqueur
- Supprimer le Statut - Retirer les statuts inutilisés
- Réorganiser - Glisser-déposer pour changer l'ordre d'affichage (affecte le champ
sortOrder)
Le SDK est pour récupérer les statuts et filtrer les produits, pas pour créer des statuts.
Attribution de Statut
Les statuts sont attribués aux produits dans le panneau d'administration :
OneEntry Admin Panel → Products → Edit Product → Assign Statuses → Save
Dans le SDK : Les produits ont un tableau statusIds avec les ID de statut attribués :
const product = await Products.getProductById(123);
console.log(product.statusIds); // [1, 2] - Status IDs
Filtrage par Statut
Utilisez l'ID de statut pour filtrer les produits
Support Multi-Langue
Les noms de statut sont automatiquement localisés
💡 Notes Importantes
Les Statuts sont Créés dans le Panneau d'Administration
Rappelez-vous : Le SDK est pour récupérer les statuts, pas pour les créer.
Pour créer/modifier des statuts : Utilisez le Panneau d'Administration OneEntry.
Interface de Liste des Statuts
Le panneau d'administration affiche tous les statuts dans un tableau avec trois colonnes :
- Nom - Désignation du statut
- Marqueur - Identifiant unique
- Actions - Opérations de modification et de suppression, plus réorganisation par glisser-déposer
Validation de Marqueur
Important : La méthode validateMarker() aide à vérifier si un marqueur existe déjà avant de le créer/de l'utiliser.
Contraintes de Marqueur :
- Uniquement des caractères alphanumériques latins (a-z, A-Z, 0-9)
- Soulignement (_) et tiret (-) autorisés
- Pas d'espaces ou de caractères spéciaux
- Doit être unique parmi tous les statuts
Plusieurs Statuts par Produit
Les produits peuvent avoir plusieurs statuts simultanément (ex. : "Nouvelle Arrivée" + "En Promotion")
Statut vs Attributs
ProductStatuses sont différents des attributs de produit :
| Fonctionnalité | ProductStatuses | Attributs |
|---|---|---|
| Objectif | Étiquettes/badges/filtres | Propriétés du produit |
| Exemples | "Nouveau", "Promotion", "En Vedette" | Couleur, Taille, Matériau |
| Valeurs multiples | Oui (plusieurs statuts) | Oui (plusieurs attributs) |
| Filtrage | Simple (par ID de statut) | Complexe (plages, valeurs) |
| Cas d'utilisation | Étiquettes marketing | Spécifications du produit |
Meilleure pratique : Utilisez des statuts pour les étiquettes marketing, des attributs pour les propriétés du produit.
📊 Tableau de Référence Rapide
| Méthode | Description | Cas d'utilisation |
|---|---|---|
| getProductStatuses() | Obtenir tous les statuts de produit | Lister tous les statuts disponibles |
| getProductsByStatusMarker() | Obtenir le statut de produit par marqueur | Récupérer le statut par identifiant |
| validateMarker() | Vérifier si le marqueur existe | Valider le marqueur avant utilisation |
❓ Questions Fréquemment Posées (FAQ)
Quelle est la différence entre les statuts de produit et les attributs de produit ?
Les statuts de produit sont des étiquettes marketing (Nouveau, Promotion, En Vedette) pour le filtrage et le balisage, tandis que les attributs sont des spécifications de produit (Couleur, Taille, Matériau). Utilisez des statuts pour des étiquettes promotionnelles et des attributs pour des propriétés de produit.
Un produit peut-il avoir plusieurs statuts en même temps ?
Oui ! Les produits peuvent avoir plusieurs statuts simultanément. Par exemple, un produit peut être à la fois "Nouvelle Arrivée" et "En Promotion" en même temps. Le tableau statusIds dans l'objet produit contient tous les ID de statut attribués.
Comment filtrer les produits par statut ?
Utilisez les méthodes du module Produits avec des filtres de statut. Passez l'ID ou le marqueur de statut dans votre requête pour récupérer des produits avec des statuts spécifiques. Vous pouvez également combiner plusieurs filtres de statut.
Comment valider un marqueur avant de créer un statut ?
Utilisez la méthode validateMarker() pour vérifier si un marqueur existe déjà. Cela aide à prévenir les marqueurs en double et garantit que votre marqueur suit les conventions de nommage (lettres latines, chiffres, soulignement, tiret uniquement).
Puis-je changer l'ordre des statuts affichés ?
Oui ! Dans le panneau d'administration, vous pouvez glisser-déposer les statuts pour les réorganiser. Cela affecte le champ sortOrder et détermine la priorité d'affichage dans votre application.
Comment ajouter un style personnalisé aux badges de statut ?
Récupérez tous les statuts, créez une correspondance des marqueurs de statut aux classes CSS ou styles en ligne dans votre code frontend. Appliquez ces styles lors du rendu des badges de produit en fonction du tableau statusIds du produit.
🎓 Meilleures Pratiques
- Utilisez des marqueurs descriptifs -
nouvelle_arrivée, passtatut1 - Définissez les couleurs de manière cohérente - Utilisez la palette de couleurs de la marque
- Limitez les statuts actifs - Ne submergez pas les utilisateurs avec trop de badges
- Gardez les noms de statut courts - "Promotion" est mieux que "Produits en Promotion"
- Utilisez le statut pour le filtrage - Rendez les statuts filtrables dans l'interface utilisateur
- Mettez en cache les statuts - Ils changent rarement, mettez-les en cache pour la performance
- Affichez plusieurs statuts - Montrez tous les badges pertinents sur les produits
- Utilisez le statut pour le tri - Triez d'abord par statut "En Vedette"
Définition du module ProductStatuses
Le module ProductStatuses gère les statuts qui servent de filtres supplémentaires en plus des conditions définies par les attributs. Les statuts des produits permettent des conditions de filtrage supplémentaires pour les éléments du catalogue dans la plateforme OneEntry, travaillant en conjonction avec le filtrage basé sur les attributs.
const { ProductStatuses } = defineOneEntry( "your-project-url", { "token": "your-app-token" });
🔗 Documentation Connexe
- Panneau d'Administration OneEntry - Statuts des Produits - Documentation officielle du panneau d'administration
- Module Produits - Gérer les produits avec des statuts
- Module Attributs - Attributs de produit vs statuts
- Module GeneralTypes - Types et catégories de produits
- Module Locales - Noms de statut en plusieurs langues