Systèmes de gestion de contenu

Utilisez cette compétence quand l'utilisateur travaille sur un système de gestion de contenu ou sur un logiciel qui se comporte comme tel.

Cette compétence se concentre sur les points d'articulation importants du travail CMS :

• thèmes et templates
• plugins, apps, modules et extensions
• interfaces d'administration et d'édition
• gestion des médias et téléchargements
• modèles de contenu, taxonomies et métadonnées
• pipelines de rendu et flux d'export statique

Quand utiliser cette compétence

• L'utilisateur mentionne une plateforme CMS telle que WordPress, Shopify, Drupal, Joomla, Webflow, Squarespace, Wix, WooCommerce, HubSpot CMS Hub ou Adobe Experience Manager.
• La tâche concerne le développement de thèmes, les modifications de templates ou le travail de design system dans un CMS.
• La tâche concerne les plugins, modules, apps ou points d'extension.
• La tâche touche à l'UX de l'éditeur, aux aperçus, aux taxonomies, aux slugs, aux champs SEO ou au comportement de publication.
• La tâche implique des téléchargements, des bibliothèques de médias, des ressources créées, du rendu markdown ou de l'export statique.

Premier passage

1. Identifiez la catégorie de plateforme : CMS auto-hébergé, constructeur SaaS, plateforme e-commerce ou système hybride/headless.
2. Localisez le point d'articulation propriétaire avant d'éditer :
   • couche de thème ou template
   • couche plugin, app, module ou extension
   • surface d'administration ou d'édition
   • modèle de contenu ou couche de stockage
   • pipeline de médias
   • pipeline d'export, de déploiement ou de rendu
3. Vérifiez les contraintes de la plateforme avant de choisir une approche :
   • ce qui est éditable localement
   • ce qui est du contenu créé versus du code
   • où appartiennent les médias
   • si le site final est rendu côté serveur, exporté statiquement ou hébergé à distance

Règles CMS

• Respectez les conventions de nommage et de dossiers de la plateforme pour les thèmes, modules, parties de template ou sections.
• Gardez les ressources de thème séparées des médias téléchargés par les utilisateurs, sauf si la plateforme les combine explicitement.
• Préférez les champs de contenu structuré au stockage de métadonnées importantes dans le markup de présentation.
• Traitez les aperçus, slugs, taxonomies, extraits, champs de métadonnées et états de publication comme des préoccupations CMS de première classe.
• Privilégiez les paramètres par défaut sûrs et le comportement de fallback gracieux quand la configuration, la sélection de thème ou l'entrée de contenu est invalide.
• Quand vous changez le comportement de l'éditeur ou de l'administration, tracez ensemble le champ stocké, les règles de validation, le chemin d'aperçu et le chemin de rendu final.

Flux de travail courants

Thèmes et templates

• Commencez au chargeur de template ou au runtime du thème, pas à un include en aval.
• Préservez la hiérarchie de templates et les conventions de nommage des partiels de la plateforme.
• Gardez les changements de présentation proches des templates et des helpers de thème partagés.

Plugins, apps et modules

• Ajoutez le comportement au point d'extension de la plateforme au lieu de disperser la logique dans les templates.
• Gardez les migrations, données de seed et mises à jour de configuration explicites et versionnées.
• Documentez les hypothèses de configuration de l'extension quand la plateforme requiert une activation ou un enregistrement.

UX d'administration et d'édition

• Gardez les formulaires alignés avec le modèle de contenu stocké.
• Préférez les aperçus côté auteur quand les transformations de contenu sont non triviales.
• Gardez la validation, les protections CSRF ou équivalentes et les permissions cohérentes avec le code d'administration environnant.

Médias et téléchargements

• Utilisez un chemin de téléchargement dédié pour les médias créés.
• Gardez les images décoratives ou propriétaires au thème dans le dossier de thème actif.
• Utilisez par défaut des emplacements conventionnels comme uploads/ pour les médias créés et img/ pour les ressources de thème, sauf si la plateforme impose une convention plus forte.
• Quand un CMS supporte des répertoires de médias configurables, exposez le paramètre avec un fallback sûr.

Modèles de contenu et migrations

• Distinguez clairement les entités de contenu : pages, posts, produits, entrées, collections, taxonomies et paramètres.
• Préférez les fichiers de migration ou les définitions de schéma exportables aux mutations runtime ad hoc.
• Gardez les slugs, dates de publication, extraits, métadonnées canoniques et relations de taxonomie structurés.

Markdown, HTML et export statique

• Décidez si markdown est une entrée créée, du contenu intermédiaire ou une sortie de build avant de changer le renderer.
• Associez les changements de renderer avec un aperçu ou une validation quand c'est possible.
• Pour les systèmes CMS exportés statiquement, validez les permaliens réécrits et les chemins d'assets après les changements de build.

Identifier le point d'articulation propriétaire

Indépendamment de la plateforme, localisez le point d'articulation propriétaire avant d'éditer en mappant la codebase à ces rôles CMS :

• Bootstrap runtime et routage des requêtes
• Contrôleurs d'administration ou d'édition et leurs templates de vue
• Chargement de thème, hiérarchie de templates et helpers de template partagés
• Repositories, modèles ou fichiers de schéma/migration pour le contenu, les taxonomies et les paramètres
• Utilitaires de transformation de contenu ou markdown
• Points d'entrée du pipeline d'export statique, de déploiement ou de rendu

Allez au point d'articulation propriétaire d'abord, puis faites le plus petit changement qui préserve la structure du CMS.

Notes de plateforme

Consultez references/cms-platform-workflows.md pour un mapping compact des plateformes CMS courantes, des surfaces d'extension et des conventions de médias.