Configuration de Collection CMS

Créez une nouvelle collection CMS avec des champs personnalisés, des relations et une configuration appropriée.

Note Importante

UTILISEZ TOUJOURS les outils Webflow MCP pour toutes les opérations :

• Utilisez webflow_guide_tool de Webflow MCP pour obtenir les meilleures pratiques avant de commencer
• Utilisez data_sites_tool de Webflow MCP avec l'action list_sites pour identifier les sites disponibles
• Utilisez data_sites_tool de Webflow MCP avec l'action get_site pour récupérer les détails du site et les limites du plan
• Utilisez data_cms_tool de Webflow MCP avec l'action get_collection_list pour vérifier les conflits de noms
• Utilisez data_cms_tool de Webflow MCP avec l'action create_collection pour créer la collection
• Utilisez data_cms_tool de Webflow MCP avec l'action create_collection_static_field pour créer des champs statiques
• Utilisez data_cms_tool de Webflow MCP avec l'action create_collection_option_field pour créer des champs d'options
• Utilisez data_cms_tool de Webflow MCP avec l'action create_collection_reference_field pour créer des champs de référence/multi-référence
• Utilisez data_cms_tool de Webflow MCP avec l'action get_collection_details pour vérifier que la collection a été créée correctement
• N'UTILISEZ PAS d'autres outils ou méthodes pour les opérations Webflow
• Tous les appels d'outils doivent inclure le paramètre context requis (15-25 mots, perspective à la troisième personne)

Instructions

Phase 1 : Sélection et Découverte du Site

1. Obtenir les informations du site : Utilisez data_sites_tool de Webflow MCP avec l'action list_sites pour identifier le site cible
2. Confirmer le site : Demandez à l'utilisateur de sélectionner un site s'il y en a plusieurs disponibles
3. Vérifier les limites du plan : Utilisez data_sites_tool de Webflow MCP avec l'action get_site pour vérifier les limites de collections
4. Lister les collections existantes : Utilisez data_cms_tool de Webflow MCP avec l'action get_collection_list pour vérifier les conflits
5. Valider le nommage : Assurez-vous que le nouveau nom de collection n'entre pas en conflit avec les noms existants

Phase 2 : Collecte des Exigences

6. Obtenir les détails de la collection : Demandez à l'utilisateur :
   • Nom d'affichage de la collection (ex. « Blog Posts »)
   • Nom au singulier (ex. « Blog Post »)
   • Optionnel : Slug personnalisé (par défaut : généré automatiquement à partir du nom d'affichage)
7. Obtenir les définitions de champs : Pour chaque champ, rassemblez :
   • Nom du champ (ex. « Author Name », « Publish Date »)
   • Type de champ (Text, Rich Text, Image, Option, Reference, etc.)
   • Requis ou optionnel
   • Toutes les règles de validation ou textes d'aide
8. Identifier les relations : Déterminez si la collection a besoin de :
   • Champs de référence (relations un-à-plusieurs)
   • Champs de multi-référence (relations plusieurs-à-plusieurs)
   • Champs d'options (vocabulaire contrôlé)

Phase 3 : Validation du Schéma et Planification

9. Valider les types de champs : Vérifiez que tous les types de champs sont supportés
10. Vérifier les limites des champs : Assurez-vous que vous êtes dans les limites Webflow :
    • Champs max par collection : varie selon le plan
    • Max 5 champs de multi-référence par collection
11. Planifier l'ordre de création : Organisez les champs par dépendance :
    • Créez les collections dans l'ordre s'il y a des références
    • Créez d'abord les collections référencées
    • Créez les champs d'options avant les champs de référence
12. Générer un aperçu : Affichez le schéma complet avec tous les champs

Phase 4 : Approbation de l'Utilisateur

13. Afficher l'aperçu complet : Affichez :
    • Nom et slug de la collection
    • Tous les champs avec les types et propriétés
    • Toutes les relations avec d'autres collections
    • Vérification des limites du plan
14. Valider le schéma : Vérifiez les problèmes courants :
    • Champs requis manquants (name, slug toujours requis)
    • Types de champs invalides
    • Référence à des collections inexistantes
    • Dépassement des limites du plan
15. Demander la confirmation : Attendez l'approbation explicite « créer »

Phase 5 : Création de Collection

16. Créer la collection : Utilisez data_cms_tool de Webflow MCP avec l'action create_collection avec :
    • Nom d'affichage
    • Nom au singulier
    • Slug optionnel
17. Capturer l'ID de collection : Enregistrez-le pour la création de champs
18. Afficher la progression : Signalez que la collection a été créée avec succès

Phase 6 : Création de Champs

19. Créer les champs dans l'ordre : Pour chaque champ :
    • Utilisez l'outil de création approprié en fonction du type
    • Champs statiques : data_cms_tool avec l'action create_collection_static_field
    • Champs d'options : data_cms_tool avec l'action create_collection_option_field
    • Champs de référence : data_cms_tool avec l'action create_collection_reference_field
20. Définir les propriétés du champ :
    • Nom d'affichage
    • Drapeau requis
    • Texte d'aide (le cas échéant)
    • Règles de validation (le cas échéant)
21. Afficher la progression : Signalez que chaque champ a été créé
22. Gérer les erreurs : Si la création d'un champ échoue, signalez-le et continuez

Phase 7 : Vérification et Rapport

23. Vérifier la collection : Utilisez data_cms_tool de Webflow MCP avec l'action get_collection_details pour récupérer le schéma complet
24. Confirmer tous les champs : Vérifiez que tous les champs demandés ont été créés
25. Générer un rapport : Affichez :
    • ID de collection
    • Nom et slug de la collection
    • Tous les champs créés avec les IDs
    • Tous les échecs ou avertissements
26. Fournir les étapes suivantes : Suggérez :
    • Utilisez bulk-cms-update pour ajouter des éléments initiaux
    • Créez des pages de collection dans Designer
    • Configurez les relations le cas échéant

Référence des Types de Champs

Types de Champs Statiques

PlainText - Texte court (max 256 caractères) ou texte long

• Utiliser pour : Titres, noms, descriptions, extraits
• Propriétés : Validation maxLength (256 pour court texte)
• Exemple : « Title », « Author Name », « Excerpt »

RichText - Texte formaté avec HTML

• Utiliser pour : Contenu de blog, bios, articles, longues descriptions
• Propriétés : Pas de limite de longueur
• Exemple : « Post Content », « Bio », « Description »

Email - Adresse email

• Utiliser pour : Emails de contact, emails d'auteur
• Propriétés : Validation du format email
• Exemple : « Contact Email », « Author Email »

Phone - Numéro de téléphone

• Utiliser pour : Numéros de contact
• Propriétés : Format E.164
• Exemple : « Phone Number », « Mobile »

Link - URL externe ou lien interne

• Utiliser pour : Liens de site web, réseaux sociaux, ressources externes
• Propriétés : Validation URL
• Exemple : « Website », « LinkedIn Profile »

Number - Valeurs numériques

• Utiliser pour : Prix, évaluations, comptes, numéros de commande
• Propriétés : Entier ou décimal
• Exemple : « Price », « Rating », « Order »

Image - Image unique

• Utiliser pour : Images en avant, photos, miniatures
• Propriétés : Max 4MB par image
• Exemple : « Featured Image », « Photo », « Thumbnail »

MultiImage - Plusieurs images (jusqu'à 25)

• Utiliser pour : Galeries, photos de produits
• Propriétés : Max 25 images, 4MB chacune
• Exemple : « Gallery », « Product Photos »

File - Upload de fichier

• Utiliser pour : PDFs, documents, téléchargements
• Propriétés : Max 4MB par fichier
• Exemple : « Resume PDF », « Brochure », « Manual »

Video - Intégration vidéo (YouTube/Vimeo)

• Utiliser pour : Contenu vidéo
• Propriétés : URL d'intégration
• Exemple : « Tutorial Video », « Demo »

DateTime - Date et/ou heure

• Utiliser pour : Dates de publication, dates d'événements, délais
• Propriétés : Format ISO 8601
• Exemple : « Publish Date », « Event Date »

Switch - Booléen (vrai/faux)

• Utiliser pour : Drapeaux en avant, bascules de visibilité
• Propriétés : Valeur booléenne
• Exemple : « Featured », « Published », « Active »

Color - Valeur de couleur

• Utiliser pour : Couleurs de thème, accents, couleurs de marque
• Propriétés : Format hexadécimal
• Exemple : « Brand Color », « Accent Color »

Type de Champ d'Options

Option - Choix unique dans une liste prédéfinie

• Utiliser pour : Statut, catégorie, type, priorité
• Propriétés : Liste de noms d'options
• Exemple : « Status » (Draft, Review, Published)
• Création : Utilisez data_cms_tool avec l'action create_collection_option_field avec tableau d'options

Exemple :

{
  "type": "Option",
  "displayName": "Status",
  "metadata": {
    "options": [
      {"name": "Draft"},
      {"name": "In Review"},
      {"name": "Published"}
    ]
  }
}

Types de Champs de Référence

Reference - Lien vers un élément dans une autre collection (un-à-plusieurs)

• Utiliser pour : Author → Post, Category → Post, Brand → Product
• Propriétés : ID de collection de la collection référencée
• Exemple : « Author » (référence à la collection Authors)
• Création : Utilisez data_cms_tool avec l'action create_collection_reference_field avec collectionId

MultiReference - Lien vers plusieurs éléments dans une autre collection (plusieurs-à-plusieurs)

• Utiliser pour : Post → Tags, Product → Features, Project → Technologies
• Propriétés : ID de collection de la collection référencée
• Limite : Max 5 champs de multi-référence par collection
• Exemple : « Tags » (référence à la collection Tags)
• Création : Utilisez data_cms_tool avec l'action create_collection_reference_field avec collectionId

Exemple de Champ de Référence :

{
  "type": "Reference",
  "displayName": "Author",
  "metadata": {
    "collectionId": "abc123..."
  }
}

Exemple de Champ de Multi-Référence :

{
  "type": "MultiReference",
  "displayName": "Tags",
  "metadata": {
    "collectionId": "xyz789..."
  }
}

Exemples

Exemple 1 : Collection Simple de Blog

Prompt utilisateur :

Créer une collection Blog Posts avec titre, contenu, auteur et date de publication

Étape 1 : Découverte

🔍 Configuration de Collection CMS

Sites disponibles :
1. Company Website
2. Blog Site

Quel site ? (1/2)

Étape 2 : Après la Sélection du Site par l'Utilisateur

📊 Collections Existantes sur Company Website :

Actuellement : 0 collections
Limite du plan : 20 collections (CMS Plan)

✅ Vous avez la capacité de créer de nouvelles collections.

---

📋 Exigences de Collection

Nom d'affichage : Blog Posts
Nom au singulier : Blog Post
Slug : blog-posts (généré automatiquement)

Champs à créer :
1. Title - Text (requis)
2. Content - Rich Text (requis)
3. Author - Text
4. Publish Date - Date/Time (requis)

Est-ce correct ? (oui/non)
Si vous voulez ajouter/modifier des champs, décrivez les modifications.

Étape 3 : Aperçu

📋 Aperçu : Créer la Collection « Blog Posts »

Collection :
├── Nom d'affichage : Blog Posts
├── Nom au singulier : Blog Post
├── Slug : blog-posts
└── Site : Company Website

Champs (6 au total) :
├── name (PlainText, requis) ← Auto-créé
├── slug (PlainText, requis) ← Auto-créé
├── title (PlainText, requis)
├── content (RichText, requis)
├── author (PlainText)
└── publish-date (DateTime, requis)

✅ Validation Réussie :
- Nom de collection disponible
- Dans les limites du plan (0/20 collections)
- Tous les types de champs valides
- Pas de problèmes de dépendance

⚠️ Tapez « create » pour continuer.

Étape 4 : Création

🔄 Création de la Collection...

✅ Collection créée : Blog Posts (ID: 64f1a2b3...)

Ajout des champs...
├── ✅ title (PlainText)
├── ✅ content (RichText)
├── ✅ author (PlainText)
└── ✅ publish-date (DateTime)

Progression : ████████████████████ 100% (4/4 champs)

🎉 Configuration de Collection Terminée !

Collection : Blog Posts
ID : 64f1a2b3...
Champs : 6 (2 auto-créés + 4 personnalisés)

---

💡 Étapes Suivantes :
1. Utilisez bulk-cms-update pour ajouter les articles de blog initiaux
2. Créez une page de modèle de collection dans Designer
3. Configurez une page de liste de collection pour l'index du blog
4. Configurez les paramètres SEO pour les pages dynamiques

Exemple 2 : Collection avec Relations

Prompt utilisateur :

Créer une collection Products avec nom, prix, description, images, marque et tags

Étape 1 : Après la Collecte Initiale

📋 Analyse de Collection

Je vois que vous voulez :
- Brand : Cela devrait être un champ de référence
- Tags : Cela devrait être un champ de multi-référence

Cela nécessite de créer d'abord des collections supplémentaires :
1. Collection Brands
2. Collection Tags

Ensuite, nous pouvons créer Products avec des références à ceux-ci.

Voulez-vous que je :
A) Crée les trois collections (Brands, Tags, Products)
B) Crée juste Products (vous ajouterez les relations plus tard)
C) Modifie les exigences

Votre choix ? (A/B/C)

Étape 2 : Après la Sélection « A » par l'Utilisateur

📋 Aperçu : Créer 3 Collections

---

### 1. Collection Brands

Champs (4 au total) :
├── name (PlainText, requis) ← Auto
├── slug (PlainText, requis) ← Auto
├── logo (Image)
└── description (PlainText)

---

### 2. Collection Tags

Champs (3 au total) :
├── name (PlainText, requis) ← Auto
├── slug (PlainText, requis) ← Auto
└── color (Color)

---

### 3. Collection Products

Champs (9 au total) :
├── name (PlainText, requis) ← Auto
├── slug (PlainText, requis) ← Auto
├── price (Number, requis)
├── description (RichText)
├── images (MultiImage)
├── brand (Reference → Brands)
└── tags (MultiReference → Tags)

---

Ordre de Création :
1. Brands (pas de dépendances)
2. Tags (pas de dépendances)
3. Products (références 1 & 2)

✅ Validation :
- Toutes les collections disponibles
- Dans les limites du plan (0/20 collections)
- Limite de multi-référence : 1/5 ✅
- Toutes les dépendances résolubles

⚠️ Tapez « create » pour continuer avec les 3 collections.

Étape 3 : Création

🔄 Création des Collections...

[1/3] Création de Brands...
✅ Collection Brands créée (ID: abc123...)
├── ✅ logo (Image)
└── ✅ description (PlainText)

[2/3] Création de Tags...
✅ Collection Tags créée (ID: def456...)
└── ✅ color (Color)

[3/3] Création de Products...
✅ Collection Products créée (ID: ghi789...)
├── ✅ price (Number)
├── ✅ description (RichText)
├── ✅ images (MultiImage)
├── ✅ brand (Reference → Brands)
└── ✅ tags (MultiReference → Tags)

Progression : ████████████████████ 100% (3/3 collections)

🎉 Toutes les Collections Créées !

Résumé :
├── Brands (ID: abc123...)
├── Tags (ID: def456...)
└── Products (ID: ghi789...)

---

💡 Étapes Suivantes :
1. Ajouter d'abord les éléments de marque (utilisez bulk-cms-update)
2. Ajouter les éléments de tags (utilisez bulk-cms-update)
3. Ensuite ajouter les produits avec les références de marque/tag
4. Créer les pages de collection dans Designer

Exemple 3 : Membres de l'Équipe avec Champ d'Options

Prompt utilisateur :

Créer une collection Team Members avec nom, rôle (dropdown: Designer, Developer, Manager), bio, photo, email

Étape 1 : Aperçu

📋 Aperçu : Créer la Collection « Team Members »

Collection :
├── Nom d'affichage : Team Members
├── Nom au singulier : Team Member
└── Slug : team-members

Champs (7 au total) :
├── name (PlainText, requis) ← Auto
├── slug (PlainText, requis) ← Auto
├── role (Option, requis)
│   Options :
│   ├── Designer
│   ├── Developer
│   └── Manager
├── bio (RichText)
├── photo (Image)
└── email (Email)

✅ Validation Réussie

⚠️ Tapez « create » pour continuer.

Étape 2 : Création

🔄 Création de la Collection...

✅ Collection créée : Team Members (ID: jkl012...)

Ajout des champs...
├── ✅ role (Option: 3 options)
├── ✅ bio (RichText)
├── ✅ photo (Image)
└── ✅ email (Email)

Progression : ████████████████████ 100% (4/4 champs)

🎉 Configuration de Collection Terminée !

Collection : Team Members
Champs : 6 (2 auto + 4 personnalisés)

Détails des Champs :
- role : Champ d'options avec 3 choix
  • Designer
  • Developer
  • Manager

---

💡 Étapes Suivantes :
1. Ajouter des éléments de membre de l'équipe
2. Créer une page d'équipe dans Designer
3. Envisager d'ajouter :
   - LinkedIn profile (champ Link)
   - Years of experience (champ Number)
   - Specializations (MultiReference à une collection Skills)

Exemple 4 : Configuration E-commerce Complexe

Prompt utilisateur :

Créer une configuration e-commerce avec Products, Categories, Brands et Features

Étape 1 : Clarification des Exigences

📋 Planification de Collection E-commerce

Je vais créer 4 collections :

1. **Categories** - Catégories de produits
2. **Brands** - Marques de produits
3. **Features** - Caractéristiques de produits (ex. « Waterproof », « Wireless »)
4. **Products** - Catalogue de produits principal

Relations :
- Product → Category (Reference)
- Product → Brand (Reference)
- Product → Features (MultiReference)

Champs par collection :

**Categories:**
- Name, Slug (auto)
- Description
- Parent Category (auto-référence pour hiérarchie)
- Icon

**Brands:**
- Name, Slug (auto)
- Logo
- Description

**Features:**
- Name, Slug (auto)
- Icon
- Description

**Products:**
- Name, Slug (auto)
- Price
- Sale Price
- Description
- Images (MultiImage)
- Category (Reference → Categories)
- Brand (Reference → Brands)
- Features (MultiReference → Features)
- In Stock (Switch)
- SKU (PlainText)

Cette structure vous convient-elle ? (oui/modifier/annuler)

Étape 2 : Aperçu (l'Utilisateur dit « oui »)

📋 Aperçu : Créer des Collections E-commerce

---

### Collection 1 : Categories

Champs (5 au total) :
├── name (PlainText, requis)
├── slug (PlainText, requis)
├── description (PlainText)
├── parent-category (Reference → Categories) ← Auto-référence
└── icon (Image)

---

### Collection 2 : Brands

Champs (4 au total) :
├── name (PlainText, requis)
├── slug (PlainText, requis)
├── logo (Image)
└── description (PlainText)

---

### Collection 3 : Features

Champs (4 au total) :
├── name (PlainText, requis)
├── slug (PlainText, requis)
├── icon (Image)
└── description (PlainText)

---

### Collection 4 : Products

Champs (12 au total) :
├── name (PlainText, requis)
├── slug (PlainText, requis)
├── price (Number, requis)
├── sale-price (Number)
├── description (RichText)
├── images (MultiImage)
├── category (Reference → Categories)
├── brand (Reference → Brands)
├── features (MultiReference → Features)
├── in-stock (Switch)
└── sku (PlainText)

---

Ordre de Création :
1. Categories (auto-référence OK)
2. Brands (pas de dépendances)
3. Features (pas de dépendances)
4. Products (références 1, 2, 3)

✅ Validation :
- Dans les limites du plan (0/20 collections)
- Compte de multi-référence : 1/5 ✅
- Tous les types de champs valides
- Toutes les dépendances résolubles

⚠️ Tapez « create » pour continuer avec les 4 collections.

Étape 3 : Création avec Progression

🔄 Création des Collections E-commerce...

[1/4] Création de Categories...
✅ Categories créée (ID: aaa111...)
Progression : ████████░░░░░░░░░░░░ 25%

[2/4] Création de Brands...
✅ Brands créée (ID: bbb222...)
Progression : ████████████░░░░░░░░ 50%

[3/4] Création de Features...
✅ Features créée (ID: ccc333...)
Progression : ████████████████░░░░ 75%

[4/4] Création de Products...
✅ Products créée (ID: ddd444...)
Progression : ████████████████████ 100%

---

🎉 Configuration E-commerce Terminée !

Collections Créées (4) :
├── Categories (ID: aaa111..., 5 champs)
├── Brands (ID: bbb222..., 4 champs)
├── Features (ID: ccc333..., 4 champs)
└── Products (ID: ddd444..., 12 champs)

Relations Configurées :
- Products → Categories (un-à-plusieurs)
- Products → Brands (un-à-plusieurs)
- Products → Features (plusieurs-à-plusieurs)
- Categories → Parent Category (auto-référence)

---

💡 Ordre de Contenu Recommandé :
1. Ajouter d'abord les catégories (incluant les relations parentes)
2. Ajouter les marques
3. Ajouter les caractéristiques
4. Enfin ajouter les produits (avec toutes les références)

💡 Étapes Suivantes :
1. Utilisez bulk-cms-update pour les données initiales
2. Créez une page de modèle de produit
3. Créez une page de liste de produits avec filtres
4. Configurez les pages d'accueil de catégories
5. Configurez l'intégration e-commerce

Directives

Meilleures Pratiques de Phase 1 : Découverte

Sélection du Site :

• Utilisez toujours data_sites_tool avec l'action list_sites pour obtenir les sites disponibles
• Ne supposez jamais l'ID du site
• Vérifiez que l'utilisateur a le site correct sélectionné

Vérification des Limites du Plan :

Vérifiez les limites avant la création :
- Starter : 1 collection, 50 éléments
- Basic : 2 collections, 200 éléments
- CMS : 20 collections, 2 000 éléments
- Business : 40 collections, 10 000 éléments
- Enterprise : Personnalisé

Avertissez l'utilisateur s'il approche des limites.

Prévention des Conflits de Noms :

• Vérifiez les noms de collections existantes
• Suggérez des noms alternatifs en cas de conflit
• Validez la disponibilité du slug

Meilleures Pratiques de Phase 2 : Collecte des Exigences

Nom d'Affichage vs Nom au Singulier :

Nom d'Affichage : Forme plurielle affichée dans le CMS
Nom au Singulier : Forme singulière pour les éléments individuels

Exemples :
- Affichage : « Blog Posts » → Singulier : « Blog Post »
- Affichage : « Team Members » → Singulier : « Team Member »
- Affichage : « Products » → Singulier : « Product »
- Affichage : « Categories » → Singulier : « Category »

Conventions de Nommage des Champs :

✅ Bons noms :
- author-name (descriptif, avec tirets)
- publish-date (objectif clair)
- featured-image (spécifie laquelle)
- main-content (explique l'utilisation)

❌ Mauvais noms :
- text1 (sans sens)
- field (trop générique)
- data (peu clair)
- img (quelle image ?)

Détection des Relations :

Si l'utilisateur dit :
« ... avec author » → Probablement un champ de référence
« ... avec tags » → Probablement un champ de multi-référence
« ... avec category » → Probablement un champ de référence
« ... avec related products » → Probablement un champ de multi-référence

Posez des questions de clarification :
- Le [author] est-il le même pour tous les éléments ? → Reference
- Les éléments peuvent-ils avoir plusieurs [tags] ? → Multi-reference
- Avez-vous une collection [Categories] ? → Vérifiez l'existence

Meilleures Pratiques de Phase 3 : Validation du Schéma

Validation des Types de Champs :

Correspondances courantes de types de champs :

L'utilisateur dit... → Type de champ :
« title », « name » → PlainText
« description », « summary » → PlainText (long)
« content », « bio », « article » → RichText
« photo », « image », « thumbnail » → Image
« gallery », « photos » → MultiImage
« document », « PDF », « file » → File
« video » → Video
« link », « URL », « website » → Link
« email » → Email
« phone », « mobile » → Phone
« price », « cost », « amount » → Number
« date », « published », « deadline » → DateTime
« featured », « active », « published » → Switch
« status », « type », « category » → Option (si choix fixes)
« color », « theme » → Color

Vérification de la Limite de Multi-Référence :

Comptez les champs de multi-référence demandés :

Si > 5 :
⚠️ Avertissement : Limite de Collection Dépassée

Webflow autorise max 5 champs de multi-référence par collection.

Vous en avez demandé : 7

Options :
1. Choisissez les 5 relations les plus importantes
2. Convertissez certaines en champs de référence (un-à-plusieurs)
3. Créez des collections de lien
4. Utilisez des champs d'options pour une catégorisation simple

Laquelle préférez-vous ?

Résolution des Dépendances :

Pour les champs de référence :
1. Vérifiez si la collection référencée existe
2. Si non, ajoutez à la file de création
3. Créez dans le bon ordre

Exemple :
Products a besoin de :
- Collection Categories (créer d'abord)
- Collection Brands (créer d'abord)
Puis créer Products

Meilleures Pratiques de Phase 4 : Aperçu

Format d'Aperçu Complet :

📋 Aperçu : Créer « [Nom de Collection] »

Détails de Collection :
├── Nom d'affichage : [Nom]
├── Nom au singulier : [Singulier]
├── Slug : [slug]
└── Site : [Nom du Site]

Champs ([X] au total) :
├── name (PlainText, requis) ← Auto-créé
├── slug (PlainText, requis) ← Auto-créé
├── [champ-1] ([Type], [requis/optionnel])
├── [champ-2] ([Type], [requis/optionnel])
│   [Info supplémentaire si Option ou Reference]
└── [champ-n] ([Type], [requis/optionnel])

Relations :
├── [champ] → [Collection] (Reference)
└── [champ] → [Collection] (MultiReference)

✅ Résultats de Validation :
- Nom de collection disponible : Oui
- Dans les limites du plan : X/Y collections
- Compte de multi-référence : X/5
- Tous les types de champs valides : Oui
- Dépendances résolues : Oui

⚠️ Tapez « create » pour continuer.

Vérifications de Validation :

Avant d'afficher l'aperçu :
1. ✅ Nom de collection disponible
2. ✅ Dans la limite de collections du plan
3. ✅ Tous les types de champs supportés
4. ✅ Compte de multi-référence ≤ 5
5. ✅ Les collections référencées existent ou sont en file
6. ✅ Pas de dépendances circulaires
7. ✅ Les noms de champs suivent les conventions

Meilleures Pratiques de Phase 5 : Création

Création de Collection :

Champs requis :
- displayName (requis)
- singularName (requis)
- slug (optionnel, auto-généré si omis)

Incluez toujours les deux noms pour la clarté :
✅ {"displayName": "Blog Posts", "singularName": "Blog Post"}
❌ {"displayName": "Blog Posts"} (singulier manquant)

Gestion des Erreurs :

Si la création de collection échoue :
❌ Création de Collection Échouée

Erreur : [Message d'erreur de l'API]

Causes courantes :
- Nom de collection déjà existant
- Caractères invalides dans le nom/slug
- Limite du plan atteinte
- Problème d'authentification API

Voulez-vous :
1. Essayer un nom de collection différent
2. Vérifier les collections existantes
3. Mettre à jour le plan
4. Annuler l'opération

Meilleures Pratiques de Phase 6 : Création de Champs

Ordre de Création des Champs :

Créez les champs dans cet ordre :
1. Champs statiques (Text, Rich Text, Number, etc.)
2. Champs d'options (avec options définies)
3. Champs de référence (après que les collections référencées existent)

Pour chaque champ :
- Définissez displayName
- Définissez le drapeau isRequired
- Ajoutez helpText si fourni par l'utilisateur
- Définissez les règles de validation le cas échéant

Outils de Création de Champs :

Type de Champ → Outil à utiliser :

PlainText, RichText, Email, Phone, Link, Number,
Image, MultiImage, File, Video, DateTime, Switch, Color
→ data_cms_tool avec action create_collection_static_field

Option
→ data_cms_tool avec action create_collection_option_field
   (nécessite le tableau metadata.options)

Reference, MultiReference
→ data_cms_tool avec action create_collection_reference_field
   (nécessite metadata.collectionId)

Rapport de Progression :

Pour chaque champ créé :
✅ [nom-du-champ] ([Type de Champ])

Si le champ échoue :
❌ [nom-du-champ] - [Message d'erreur]

Continuez avec les champs restants même si un échoue.
Signalez tous les échecs à la fin.

Création de Champ d'Options :

{
  "type": "Option",
  "displayName": "Status",
  "isRequired": false,
  "metadata": {
    "options": [
      {"name": "Draft"},
      {"name": "Published"},
      {"name": "Archived"}
    ]
  }
}

Notes :
- Les options ont une propriété name
- Les options ne peuvent pas avoir d'ID (auto-généré)
- Minimum 2 options requis
- Maximum : illimité

Création de Champ de Référence :

{
  "type": "Reference",
  "displayName": "Author",
  "isRequired": true,
  "metadata": {
    "collectionId": "abc123..."
  }
}

Pour MultiReference :
{
  "type": "MultiReference",
  "displayName": "Tags",
  "metadata": {
    "collectionId": "def456..."
  }
}

Notes :
- Vous devez fournir le collectionId de la collection référencée
- La collection référencée doit déjà exister
- Max 5 champs de multi-référence par collection

Meilleures Pratiques de Phase 7 : Vérification

Vérification Post-Création :

Après la création de la collection et des champs :
1. Appelez data_cms_tool avec l'action get_collection_details avec l'ID de collection
2. Vérifiez que tous les champs sont présents
3. Vérifiez que les propriétés des champs correspondent à la demande
4. Confirmez que les relations sont configurées correctement

Format du Rapport Final :

🎉 Configuration de Collection Terminée !

Collection : [Nom]
ID : [collection-id]
Slug : [slug]

Champs Créés ([X]) :
├── name (PlainText, requis) ← Auto
├── slug (PlainText, requis) ← Auto
├── [champ-1] ([Type])
├── [champ-2] ([Type])
└── [champ-n] ([Type])

[Si relations existent]
Relations :
├── [champ] → [Collection]
└── [champ] → [Collection]

[Si des échecs]
⚠️ Champs Échoués ([Y]) :
├── [champ] : [erreur]
└── [champ] : [erreur]

---

💡 Étapes Suivantes :
[Suggestions pertinentes basées sur le type de collection]

Suggestions pour Étapes Suivantes :

Pour toute collection :
1. Utilisez bulk-cms-update pour ajouter les éléments initiaux
2. Créez une page de modèle de collection dans Designer
3. Créez une page de liste de collection
4. Configurez les paramètres SEO

Pour les collections avec relations :
5. Créez d'abord les collections référencées
6. Ajouter les éléments dans l'ordre de dépendance
7. Testez l'affichage des relations

Pour l'e-commerce :
5. Configurez l'intégration de paiement
6. Configurez la gestion des stocks
7. Créez le flux de paiement

Phase 8 : Gestion des Erreurs

Erreurs Courantes :

1. Conflit de Nom de Collection :

❌ Collection Déjà Existante

Une collection nommée « Blog Posts » existe déjà sur ce site.

Collection existante :
- Nom : Blog Posts
- ID : xyz789...
- Créée : 2025-12-15

Voulez-vous :
1. Choisir un nom différent
2. Afficher la collection existante
3. Ajouter des champs à la collection existante
4. Annuler

2. Limite du Plan Atteinte :

❌ Limite du Plan Atteinte

Impossible de créer une collection. Vous avez atteint votre limite de plan.

Actuel : 20/20 collections (CMS Plan)

Options :
1. Mettre à jour vers le Plan Business (40 collections)
2. Supprimer les collections inutilisées
3. Contacter le support Webflow

Voulez-vous que j'affiche vos collections existantes ?

3. Type de Champ Invalide :

❌ Type de Champ Invalide

Le type de champ « dropdown » n'est pas supporté par Webflow.

Vouliez-vous dire :
- « Option » - Choix unique dans une liste
- « Reference » - Lien vers une autre collection
- « MultiReference » - Lien vers plusieurs éléments

Lequel voulez-vous utiliser ?

4. Collection Référencée Non Trouvée :

❌ Collection Référencée Non Trouvée

Impossible de créer un champ de référence vers la collection « Authors ».

Problème : La collection « Authors » n'existe pas encore.

Solutions :
1. Créer d'abord la collection « Authors »
2. Supprimer le champ de référence pour l'instant
3. Créer les deux collections dans l'ordre

Votre choix ? (1/2/3)

5. Limite de Multi-Référence Dépassée :

❌ Trop de Champs de Multi-Référence

Vous avez demandé 6 champs de multi-référence.
Limite Webflow : 5 par collection

Demandés :
1. Tags
2. Categories
3. Related Products
4. Features
5. Certifications
6. Compatible Products ← Dépasse la limite

Choisissez 5 à conserver, ou convertissez un en champ de Reference.

Phase 9 : Scénarios Avancés

Collections Auto-Référencées :

Exemple : Catégories avec catégories parentes

Collection : Categories
Champs :
├── name (PlainText, requis)
├── slug (PlainText, requis)
├── parent-category (Reference → Categories)
└── level (Number) - 1, 2, 3 pour la hiérarchie

Implémentation :
{
  "type": "Reference",
  "displayName": "Parent Category",
  "isRequired": false,
  "metadata": {
    "collectionId": "[id-meme-collection]"
  }
}

Note : Vous devez créer la collection d'abord, puis ajouter le champ auto-référence

Configuration Multi-Collection :

Lors de la création de plusieurs collections liées :

1. Identifiez les dépendances :
   - Quelles collections en référencent d'autres ?
   - Quel est l'ordre de création ?

2. Créez dans l'ordre :
   - Créez d'abord les collections indépendantes
   - Créez les collections dépendantes après

3. Montrez la progression globale :
   [1/4] Création de Categories...
   [2/4] Création de Brands...
   [3/4] Création de Tags...
   [4/4] Création de Products...

4. Signalez collectivement :
   Les 4 collections ont été créées avec succès !

Champs d'Options Complexes :

Pour les dropdowns complexes :

Utilisateur : « Créer un champ statut avec Draft, In Review, Approved, Published, Archived »

Champ d'option avec 5 choix :
{
  "type": "Option",
  "displayName": "Status",
  "isRequired": true,
  "metadata": {
    "options": [
      {"name": "Draft"},
      {"name": "In Review"},
      {"name": "Approved"},
      {"name": "Published"},
      {"name": "Archived"}
    ]
  }
}

Conseil : Utilisez l'ordre du flux de travail pour les options

Liste de Contrôle de Production

Avant de considérer la configuration de collection comme terminée :

✅ Découverte

• [ ] Site sélectionné et confirmé
• [ ] Limites du plan vérifiées
• [ ] Collections existantes listées
• [ ] Pas de conflits de noms
• [ ] L'utilisateur a les permissions appropriées

✅ Exigences

• [ ] Nom d'affichage rassemblé
• [ ] Nom au singulier rassemblé
• [ ] Tous les champs définis avec types
• [ ] Requis vs optionnel spécifié
• [ ] Relations identifiées

✅ Validation

• [ ] Tous les types de champs valides
• [ ] Compte de multi-référence ≤ 5
• [ ] Les collections référencées existent ou sont en file
• [ ] Pas de dépendances circulaires
• [ ] Les noms de champs suivent les conventions
• [ ] Dans les limites du plan

✅ Aperçu

• [ ] Schéma complet affiché
• [ ] Tous les champs listés avec propriétés
• [ ] Relations affichées
• [ ] Résultats de validation affichés
• [ ] Confirmation de l'utilisateur obtenue

✅ Création

• [ ] Collection créée avec succès
• [ ] ID de collection capturé
• [ ] Tous les champs créés
• [ ] Erreurs de création de champs gérées
• [ ] Progression affichée à l'utilisateur

✅ Vérification

• [ ] Collection récupérée et vérifiée
• [ ] Tous les champs présents
• [ ] Propriétés des champs correctes
• [ ] Relations configurées
• [ ] Erreurs signalées

✅ Rapport

• [ ] Résumé final fourni
• [ ] ID de collection partagé
• [ ] Champs listés
• [ ] Échecs signalés (le cas échéant)
• [ ] Étapes suivantes suggérées

✅ Gestion des Erreurs

• [ ] Conflits de collection gérés
• [ ] Limites du plan vérifiées
• [ ] Types de champs invalides détectés
• [ ] Références manquantes détectées
• [ ] Échecs partiels signalés