Types de contenu

Les types de contenu (content types ou node types) sont la base de la modélisation dans Drupal. Chaque type définit une structure de données réutilisable.

🤔 Qu’est-ce qu’un type de contenu ?

Un type de contenu est un modèle pour créer du contenu. Il définit :

• Les champs disponibles (titre, image, prix…)
• Les paramètres de publication
• Les modes d’affichage
• Les permissions associées

Exemples concrets

Type de contenu	Utilisation
Article	Actualités, blog
Page	Pages statiques
Produit	Articles à vendre
Événement	Calendrier
Témoignage	Avis clients

Types par défaut dans Drupal

Drupal installe deux types par défaut :

• Article : Pour les contenus chronologiques (blog, actualités)
• Page de base : Pour les pages statiques (À propos, Contact)

📝 Conventions de nommage importantes

Machine names en anglais obligatoire

RÈGLE ABSOLUE : Tous les machine names (noms système) dans Drupal doivent être en anglais.

Pourquoi ?

• Drupal est un CMS international
• Les développeurs du monde entier utilisent l’anglais
• Cela limite les accents et caractères spéciaux dans les noms de machine
• Cela facilite le partage de code et de configurations

Comment ça marche :

1. Le nom d’affichage peut être en français : “Produit”, “Article de Blog”
2. Drupal génère automatiquement un machine name à partir du nom
3. Vous DEVEZ corriger ce machine name s’il n’est pas en anglais

Exemples de correction

Nom d’affichage	Machine name généré	Machine name correct
Produit	produit ❌	product ✅
Article de Blog	article_de_blog ❌	blog_article ✅
Slide	slide ✅	slide ✅
Témoignage	témoignage ❌	testimonial ✅

Comment corriger le machine name

Quand Drupal génère automatiquement un machine name incorrect :

1. Vérifiez toujours le champ “Nom système” (machine name)
2. Corrigez-le si nécessaire (minuscules, anglais, pas d’accents)
3. Relisez-vous avant de sauvegarder

Exemple concret :

• Vous tapez “Produit” comme nom
• Drupal propose produit comme machine name
• Changez-le immédiatement en product

🏗️ Créer un type de contenu

Via l’interface

1. Aller à Structure > Types de contenu (/admin/structure/types)

2. Cliquer sur Ajouter un type de contenu

3. Remplir les informations de base :

   • Nom : Produit
   • Nom système (machine name) : product (généré automatiquement - corrigez si nécessaire)
   • Description : Articles de la boutique TailStore

4. Configurer les paramètres de soumission :

   • Instructions de soumission (optionnel)
   • Aperçu avant envoi : Optionnel

5. Configurer les paramètres de publication :

   • Publié (par défaut)
   • Promu en page d’accueil
   • Épinglé en haut des listes

6. Configurer les paramètres d’affichage :

   • Afficher les informations de l’auteur
   • Afficher la date de publication

7. Configurer les options de menu :

   • Menus disponibles : (selon besoin)

8. Cliquer sur Enregistrer et gérer les champs

Important

N’oubliez pas de corriger le machine name si Drupal génère un nom français !

Configuration YAML

Après création, le fichier config/sync/node.type.product.yml ressemble à :

langcode: fr
status: true
dependencies: {  }
name: Produit
type: product
description: 'Articles de la boutique TailStore'
help: ''
new_revision: true
preview_mode: 1
display_submitted: false

🛍️ Créer le type “Produit”

Créons le type de contenu principal de TailStore :

1. Accéder à la création

   /admin/structure/types/add

2. Informations de base

   Champ	Valeur
   Nom	Produit
   Nom système (Machine name)	product
   Description	Articles de la boutique TailStore

3. Paramètres de publication

   • ✅ Publié
   • ❌ Promu en page d’accueil
   • ✅ Créer une nouvelle révision

4. Paramètres d’affichage

   • ❌ Afficher les informations de l’auteur
   • ❌ Afficher la date de publication

5. Enregistrer

📝 Créer le type “Article de Blog”

1. Accéder à la création

   /admin/structure/types/add

2. Informations de base

   Champ	Valeur
   Nom	Article de Blog
   Nom système (Machine name)	blog_article
   Description	Articles du blog TailStore

3. Paramètres de publication

   • ✅ Publié
   • ✅ Promu en page d’accueil (pour le bloc blog)
   • ✅ Créer une nouvelle révision

4. Paramètres d’affichage

   • ✅ Afficher les informations de l’auteur
   • ✅ Afficher la date de publication

5. Enregistrer

🎠 Créer le type “Slide”

1. Accéder à la création

   /admin/structure/types/add

2. Informations de base

   Champ	Valeur
   Nom	Slide
   Nom système (Machine name)	slide
   Description	Slides du carrousel de la page d’accueil

3. Paramètres de publication

   • ✅ Publié
   • ❌ Promu en page d’accueil
   • ❌ Créer une nouvelle révision

4. Paramètres d’affichage

   • ❌ Afficher les informations de l’auteur
   • ❌ Afficher la date de publication

5. Enregistrer

🔧 Modifier un type existant

Pour modifier un type de contenu :

1. Aller à /admin/structure/types
2. Cliquer sur Modifier à côté du type
3. Effectuer les changements
4. Enregistrer

Via Drush

# Voir les informations d'un type
drush config:get node.type.product

# Modifier une propriété
drush config:set node.type.product description "Nouvelle description"

🗑️ Supprimer un type de contenu

⚠️ DANGER : Suppression via modification directe des YAML

NE SUPPRIMEZ JAMAIS un type de contenu en supprimant directement ses fichiers YAML s’il contient du contenu !

Cela provoquera une erreur fatale lors de l’import de configuration (drush cim).

Workflow sûr :

1. Supprimer le contenu via interface ou drush entity:delete
2. Supprimer le type via interface
3. Exporter la configuration avec drush cex

Suppression manuelle

Supprimer un type de contenu supprime aussi tous les contenus de ce type !

Méthode sûre : Suppression manuelle

Pour supprimer un type de contenu en toute sécurité :

1. Vérifiez s’il y a du contenu :

   # Compter les contenus par type
   drush sql-query "SELECT type, COUNT(*) as count FROM node GROUP BY type;"

2. Supprimez le contenu au préalable :

   # Via l'interface : /admin/content
   # OU via Drush (supprime TOUS les contenus du type) :
   drush entity:delete node --bundle=product

3. Supprimez le type :

   • Aller à /admin/structure/types
   • Cliquer sur Supprimer dans le menu déroulant

4. Exportez la configuration :

   drush cex -y

❌ Méthode dangereuse : Suppression manuelle des fichiers YAML

NE FAITES PAS ÇA :

# Supprimer manuellement le fichier de config
rm config/sync/node.type.product.yml

# Importer (❌ PLANTE si contenu existe)
drush cim -y

Pourquoi ça plante ?

• Vous supprimez directement le fichier YAML
• Drupal essaie de supprimer le type de contenu à l’import
• Mais il y a encore des nœuds qui référencent ce type
• Contrainte de base de données violée → erreur fatale

Note : Si vous faites les modifications via l’interface et exportez (drush cex), il n’y a aucun danger.

💡 Solution de secours

Si vous avez déjà fait l’erreur :

# Recréer temporairement le type
drush php-eval "
\Drupal\node\Entity\NodeType::create([
  'type' => 'product',
  'name' => 'Product',
])->save();
"

# Supprimer le contenu
drush entity:delete node --bundle=product

# Maintenant supprimer le type normalement

📋 Propriétés communes

Tous les types de contenu partagent des propriétés de base :

Propriété	Description
title	Titre du contenu (obligatoire)
body	Corps du texte (optionnel, peut être supprimé)
nid	ID du nœud (auto)
uuid	Identifiant universel unique (auto)
created	Date de création (auto)
changed	Date de modification (auto)
uid	Auteur (référence utilisateur)
status	Publié/non publié
promote	Promu en page d’accueil
sticky	Épinglé

📊 Architecture de notre projet

Après cette section, vous aurez créé :

Types de contenu
├── product          # Produits de la boutique
│   └── (champs à ajouter)
├── blog_article     # Articles du blog
│   └── (champs à ajouter)
└── slide           # Carrousel page d'accueil
    └── (champs à ajouter)

💾 Exporter la configuration

N’oubliez pas d’exporter après chaque création :

drush cex -y
git add config/sync/node.type.*.yml
git commit -m "feat: add product, blog_article and slide content types"

⚠️ Import de configuration dangereux

Scénarios :

• ✅ Sûr : Modifications via interface → drush cex → OK
• ❌ Dangereux : Suppression directe du fichier YAML → drush cim → PLANTE

💡 RÈGLE D’OR

Ne supprimez jamais manuellement les fichiers YAML de types contenant du contenu !

✅ Vérification

Vérifiez que vos types sont créés :

drush entity:type:list --group=content | grep -E "product|blog|slide"

Ou dans l’interface : /admin/structure/types

🚀 Étape suivante

Passez aux Champs pour ajouter les champs personnalisés à nos types de contenu.