Introduction

🎯 Que fait ce module ?

Le module ProductStatuses permet des conditions de filtrage supplémentaires pour les articles du catalogue en plus des filtres basés sur les attributs existants. Les Statuts de Produit vous permettent de créer des étiquettes et des filtres de produit personnalisés - comme "Nouvelle Arrivée", "Meilleure Vente", "En Vente", "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 articles 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.

Pensez-y comme à votre système de balisage de produits - vous définissez des étiquettes de statut dans le panneau d'administration de OneEntry (Catalogue > Statuts de Produit), les assignez aux produits, et les utilisez pour filtrer, étiqueter 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 Vente - Produits à prix réduit
• ⭐ En Vedette - Produits mis en avant
• 📦 Rupture de Stock - Articles non disponibles
• 🎁 É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 d'étiquettes 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
• 🎨 Consistant - Rendu uniforme des étiquettes

---

✨ 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", "En Vente")
• 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 des Statuts de Produit

1. Créer un statut dans le panneau d'administration
   (ex. : "Nouvelle Arrivée")
   ↓
2. Assigner le statut aux produits
   (Sélectionner des produits dans l'administration)
   ↓
3. Récupérer les statuts via SDK
   (ProductStatuses.getProductStatuses())
   ↓
4. Afficher les étiquettes de statut sur les produits
   (Rendre les étiquettes dans les listes de produits)
   ↓
5. Filtrer les produits par statut
   (Products.getProducts({ statusId }))

Pourquoi utiliser le module ProductStatuses ?

Avantage	Description
Filtrage Flexible	Filtrer les produits par plusieurs critères personnalisés
Étiquettes Dynamiques	Afficher des étiquettes visuelles 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 des couleurs et des styles par statut

---

📋 Ce que vous devez savoir

Les Statuts de Produit 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 de OneEntry :

Panneau d'Administration OneEntry → Catalogue → Statuts de Produit → Créer un Statut → Définir le Nom/Marqueur → Enregistrer

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 :

• Seulement 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 destiné à récupérer les statuts et filtrer les produits, pas à créer des statuts.

Attribution de Statut

Les statuts sont attribués aux produits dans le panneau d'administration :

Panneau d'Administration OneEntry → Produits → Modifier le Produit → Assigner des Statuts → Enregistrer

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] - IDs de Statut

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 destiné à récupérer les statuts, pas à 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 :

• Seulement 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 Vente")

---

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", "En Vente", "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, En Vente, 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 Vente" 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 Products 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 étiquettes de statut ?

Récupérez tous les statuts, créez une correspondance des marqueurs de statut avec des classes CSS ou des styles en ligne dans votre code frontend. Appliquez ces styles lors du rendu des étiquettes de produit en fonction du tableau statusIds du produit.

---

🎓 Meilleures Pratiques

• Utilisez des marqueurs descriptifs - nouvelle_arrivée, pas statut1
• 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 d'étiquettes
• Gardez les noms de statut courts - "En Vente" est mieux que "Produits en Vente"
• 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 toutes les étiquettes pertinentes sur les produits
• Utilisez le statut pour le tri - Triez d'abord par statut "En Vedette"

---

Plus d'informations sur les statuts de produit dans le panneau d'administration de OneEntry : https://doc.oneentry.cloudhttps://doc.oneentry.cloud/docs/catalog/product-statuses/

---

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 de Produit permettent des conditions de filtrage supplémentaires pour les articles 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 de Produit - 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

---