Vocabulaires de taxonomie

🏷️ Comprendre les taxonomies

Qu’est-ce qu’une taxonomie ?

La taxonomie est le système de classification de Drupal. Elle permet d’organiser le contenu en catégories, tags, ou tout autre type de regroupement.

Taxonomie
├── Vocabulaire (= type de classification)
│   ├── Terme 1
│   ├── Terme 2
│   │   ├── Sous-terme 2.1
│   │   └── Sous-terme 2.2
│   └── Terme 3
└── Autre vocabulaire
    ├── Terme A
    └── Terme B

Vocabulaire vs Terme

Concept	Description	Exemple
Vocabulaire	Un type de classification	”Catégories”
Terme	Un élément dans le vocabulaire	”Mode”, “Sport”

Hiérarchie

Les termes peuvent être hiérarchiques (parent/enfant) :

Vêtements
├── Hommes
│   ├── T-shirts
│   ├── Pantalons
│   └── Vestes
└── Femmes
    ├── Robes
    ├── Jupes
    └── Blouses

🔧 Créer un vocabulaire

1. Vocabulaire “Catégorie Produit”

Naviguez vers Structure → Taxonomy
Cliquez sur Add vocabulary

Cliquez sur Save

2. Vocabulaire “Marque”

Répétez le processus :

Champ	Valeur
Name	`Marque`
Description	`Marques disponibles`
Machine name	`brands`

3. Vocabulaire “Taille”

Champ	Valeur
Name	`Taille`
Description	`Tailles disponibles (S, M, L, XL...)`
Machine name	`sizes`

4. Vocabulaire “Couleur”

Champ	Valeur
Name	`Couleur`
Description	`Couleurs des produits`
Machine name	`colors`

Ce vocabulaire nécessite un champ supplémentaire pour le code couleur. Nous l’ajouterons après.

5. Vocabulaire “Catégorie Blog”

Champ	Valeur
Name	`Catégorie Blog`
Description	`Classification des articles de blog`
Machine name	`blog_categories`

🎨 Ajouter des champs aux vocabulaires

Certains vocabulaires nécessitent des champs supplémentaires.

Champ “Code couleur” pour le vocabulaire Couleur

Allez dans Structure → Taxonomy
Cliquez sur Manage fields à côté de “Couleur”
Cliquez sur Create a new field

Paramètre	Valeur
Add a new field	`Text (plain)`
Label	`Code couleur`
Machine name	`field_color_code`
Maximum length	`7`
Required	`Yes`
Help text	`Code hexadécimal (ex: #FF0000)`

Sauvegardez

Champ “Image” pour le vocabulaire Marque (optionnel)

Si vous souhaitez afficher les logos des marques :

Manage fields sur le vocabulaire “Marque”
Create a new field → Image

Paramètre	Valeur
Label	`Logo`
Machine name	`field_brand_logo`
Required	`No`
Allowed file extensions	`png jpg svg`
File directory	`brands`
Alt text	`Required`

📋 Vérification

À ce stade, vous devriez avoir 5 vocabulaires :

# Via Drush
drush ev "foreach(\Drupal::entityTypeManager()->getStorage('taxonomy_vocabulary')->loadMultiple() as \$v) { echo \$v->id() . ' - ' . \$v->label() . PHP_EOL; }"

Résultat attendu :

blog_categories - Catégorie Blog
brands - Marque
colors - Couleur
product_categories - Catégorie Produit
sizes - Taille

Utilisez l’interface d’administration comme décrit ci-dessus.

# Créer les vocabulaires
drush php-eval "
\$vocabs = [
  ['vid' => 'product_categories', 'name' => 'Catégorie Produit'],
  ['vid' => 'brands', 'name' => 'Marque'],
  ['vid' => 'sizes', 'name' => 'Taille'],
  ['vid' => 'colors', 'name' => 'Couleur'],
  ['vid' => 'blog_categories', 'name' => 'Catégorie Blog'],
];
foreach (\$vocabs as \$vocab) {
  \Drupal\taxonomy\Entity\Vocabulary::create(\$vocab)->save();
  echo \"Created: \" . \$vocab['name'] . PHP_EOL;
}
"

📋 Exemple illustratif : Créer une taxonomie “Saison”

Pour illustrer la création via Drush, voici comment créer une taxonomie “Saison” :

# Créer le vocabulaire "Saison"
drush php-eval "
\$vocab = \Drupal\taxonomy\Entity\Vocabulary::create([
  'vid' => 'season',
  'name' => 'Saison',
  'description' => 'Saisons des collections',
]);
\$vocab->save();
echo 'Vocabulaire \"Saison\" créé avec succès !' . PHP_EOL;
"

# Créer les termes de la taxonomie
drush php-eval "
use Drupal\taxonomy\Entity\Term;

\$terms = [
  ['vid' => 'season', 'name' => 'Printemps-Été 2025'],
  ['vid' => 'season', 'name' => 'Automne-Hiver 2024'],
  ['vid' => 'season', 'name' => 'Collection Capsule'],
];
foreach (\$terms as \$data) {
  \$term = Term::create(\$data);
  \$term->save();
  echo 'Terme créé: ' . \$term->label() . PHP_EOL;
}
"

# Vérifier la création
drush taxonomy:vocabulary-list | grep season
drush taxonomy:term-list season

💾 Exporter la configuration

Après avoir créé tous les vocabulaires :

# Exporter
drush cex -y

# Vérifier les fichiers créés
ls -la config/sync/taxonomy.vocabulary.*.yml

Fichiers générés :

taxonomy.vocabulary.product_categories.yml
taxonomy.vocabulary.brands.yml
taxonomy.vocabulary.sizes.yml
taxonomy.vocabulary.colors.yml
taxonomy.vocabulary.blog_categories.yml

📁 Structure d’un fichier de configuration

Exemple de taxonomy.vocabulary.product_categories.yml :

langcode: fr
status: true
dependencies: {  }
name: 'Catégorie Produit'
vid: product_categories
description: 'Classification des produits'
weight: 0

✅ Points de validation

Avant de passer à la suite, vérifiez :

5 vocabulaires créés
Champ field_color_code ajouté au vocabulaire Couleur
(Optionnel) Champ field_brand_logo ajouté au vocabulaire Marque
Configuration exportée

🔜 Prochaine étape

Maintenant que les vocabulaires sont créés, passons à l’ajout des Termes de taxonomie.

Champ	Valeur
Name	`Catégorie Produit`
Description	`Classification des produits`
Machine name	`product_categories`