> For the complete documentation index, see [llms.txt](https://lunaris-1.gitbook.io/untitled/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lunaris-1.gitbook.io/untitled/script/ls-vipshop/ajouter-une-categorie.md).

# Ajouter une catégorie

Les catégories du catalogue sont définies dans **config.lua** sous `Config.Categories`. Chaque entrée est une table avec les champs suivants.

#### Structure d’une catégorie

| Clé       | Type    | Description                                                                                  |
| --------- | ------- | -------------------------------------------------------------------------------------------- |
| `key`     | string  | Identifiant unique (ex. `"daily"`, `"vehicle"`, `"vip"`). Utilisé en BDD et dans la logique. |
| `label`   | string  | Nom affiché dans l’interface (ex. "Daily", "Véhicules", "VIP").                              |
| `icon`    | string  | Classe d’icône (ex. Font Awesome : `"fa-car"`, `"fa-star"`).                                 |
| `enabled` | boolean | `true` = catégorie visible et utilisable, `false` = masquée.                                 |
| `order`   | number  | Ordre d’affichage (plus le nombre est petit, plus la catégorie apparaît en premier).         |
| `special` | string  | (Optionnel) Valeur spéciale, ex. `"fidelite"` pour la catégorie fidélité.                    |

#### Exemple : ajouter une catégorie « Animaux »

Dans **config.lua**, ajoute une entrée dans `Config.Categories` :

```lua
Config.Categories = {
  -- ... catégories existantes ...
  { key = "pets", label = "Animaux", icon = "fa-paw", enabled = true, order = 90 },
}
```

* Pour **masquer** une catégorie sans la supprimer : mets `enabled = false`.
* Pour **changer l’ordre** : modifie `order` (ex. 5, 10, 20…).

Les produits déjà en base avec un `category_key` égal à `key` s’afficheront dans cette catégorie. Assure-toi d’avoir au moins un **type de produit** qui correspond à ce que tu vends (item, vehicle, etc.) dans `Config.ProductTypes`.
