Définir les modèles produits et catégories dans Strapi

Définir le modèle de catégorie de produit

Dans Strapi, chaque Content Type correspond à un schéma JSON qui décrit sa structure et ses relations. Ici, on va créer un type categorie-de-produit pour organiser les produits de ta boutique.

1. Schéma JSON de la catégorie

api/categorie-de-produit/schema.json

1{
2  "kind": "collectionType",
3  "collectionName": "categorie_de_produits",
4  "info": {
5    "singularName": "categorie-de-produit",  // ^? Identifiant unique
6    "pluralName": "categorie-de-produits",
7    "displayName": "Catégorie de produit"
8  },
9  "options": {
10    "draftAndPublish": true          // ^? Permet le mode brouillon
11  },
12  "attributes": {
13    "name": {
14      "type": "string",
15      "required": true                // @callout: Chaque catégorie doit avoir un nom
16    },
17    "products": {
18      "type": "relation",
19      "relation": "manyToMany",
20      "target": "api::produit.produit",   // ^? Cible le modèle produit
21      "inversedBy": "categories"          // @callout: Inverse the mapping
22    }
23  }
24}

Tip

Le mode draftAndPublish te donne la flexibilité de travailler en mode brouillon avant de rendre une catégorie visible en production.

Explications clés

kind: "collectionType" indique que tu gères plusieurs entrées.
name est un champ simple string.
products établit une relation many-to-many avec le modèle produit.
inversedBy doit correspondre au champ categories du modèle cible.

Définir le modèle de produit

Passons au cœur de ton e-commerce : le modèle Produit. Il regroupe toutes les infos (nom, description, prix, image) et les relations vers les catégories.

api/produit/schema.json

1{
2  "kind": "collectionType",
3  "collectionName": "produits",
4  "info": {
5    "singularName": "produit",
6    "pluralName": "produits",
7    "displayName": "Produit",
8    "description": "Contient les infos d’un article"
9  },
10  "options": {
11    "draftAndPublish": true
12  },
13  "attributes": {
14    "name": {
15      "type": "string",
16      "required": true
17    },
18    "description": {
19      "type": "text"
20    },
21    "price": {
22      "type": "integer",
23      "min": 0,
24      "default": 0
25    },
26    "image": {
27      "type": "media",
28      "multiple": false,
29      "allowedTypes": ["images"]
30    },
31    "slug": {
32      "type": "uid",
33      "targetField": "name",
34      "required": true
35    },
36    "categories": {
37      "type": "relation",
38      "relation": "manyToMany",
39      "target": "api::categorie-de-produit.categorie-de-produit",
40      "mappedBy": "products"          // ^? Renvoie à la clé inversée
41    },
42    "stock": {
43      "type": "integer",
44      "default": 0,
45      "required": true
46    },
47    "devStripeProductId": {
48      "type": "string",
49      "unique": true,
50      "private": true
51    },
52    "stripeProductId": {
53      "type": "string",
54      "unique": true,
55      "private": true
56    }
57  }
58}

À retenir

UID pour le champ slug : génère une URL friendly à partir du nom.
Media pour l’image : stocke la référence vers le fichier téléchargé.
Champs private sont invisibles via l’API publique.

Comprendre la relation many-to-many

manyToMany côté catégorie : products inversedBy categories.
manyToMany côté produit : categories mappedBy products.

Cette configuration crée une table de jonction automatique dans la base de données, sans que tu aies à gérer manuellement la migration SQL.

Tip

Si tu veux ajouter des métadonnées à cette relation (ex. addedAt), tu bascules sur un component ou créés explicitement un composant de liaison dans Strapi.

Points clés de la leçon

Chaque Content Type est un fichier JSON dans src/api/<type>/schema.json.
draftAndPublish active le cycle vie brouillon/publication.
Les relations manyToMany produisent une table de liaison transparente.
Utilise uid pour générer automatiquement un slug basé sur un champ cible.
Les attributs private ne sont pas exposés dans l’API publique.

Exercices rapides

Crée un Content Type marque avec un champ name (string) et une relation one-to-many vers produit.
Modifie le modèle produit pour ajouter un champ rating (decimal, min 0, max 5, default 0).
Dans l’interface Strapi Admin, teste la création d’une catégorie et associe-y deux produits.

Liens utiles :