Principes de base de la modélisation de contenu
Lorsque vous vous connectez à Contentful pour la première fois et que vous créez votre premier espace, vous êtes invité à configurer votre modèle de contenu. Vous vous dites peut-être : « Mon contenu... quoi ? » Si vous êtes nouveau sur Contentful, vous n’êtes peut-être pas familier avec le monde de la modélisation de contenu.
Un modèle de contenu solide est la base de tout grand projet numérique. Votre modèle est l’ossature de votre projet ; il indique à nos API quel type de contenu envoyer à votre application finale.
Dans ce guide, nous passerons en revue les principes de la modélisation de contenu et la façon de configurer votre modèle avec Contentful. À la fin, vous serez prêt à commencer votre parcours sur Contentful en toute confiance !
L’essentiel
En bref, un modèle de contenu donne une structure et une organisation à votre contenu. Dans votre modèle de contenu, vous définirez des types de contenu individuels. Chaque type de contenu peut être vu comme un plan de votre contenu : il définit quelles données figurent dans chaque entrée. On peut aussi voir le type de contenu comme le pochoir qui sert à créer le dessin : votre entrée.
Chaque type de contenu est constitué de champs qui indiquent le type de données qui seront incluses dans l'entrée. Par exemple, le titre d’une page web ou d’un article aurait un champ de texte dédié, le corps en aurait un autre, et d’autres champs permettraient d’ajouter des fichiers multimédias. C’est ainsi que vous passez —comme le dit notre amie Karen McGrane— d’une grosse masse de contenu à des morceaux modulaires ou à un contenu structuré.
La conception de votre modèle de contenu est une étape cruciale dans la création d’une application solide, efficace et à l’épreuve du temps avec Contentful. L’objectif est de créer un modèle qui répondra aux besoins de toute votre équipe, des créateurs de contenu aux concepteurs et aux développeurs. C’est pourquoi nous recommandons toujours d’organiser une session avec chaque équipe pour déterminer ce dont elle a besoin sur notre plateforme de contenu composable, et de structurer votre contenu en conséquence.
Adopter le bon état d’esprit
Avant de commencer à concevoir votre modèle de contenu Contentful, prenez une grande inspiration et gardez l’esprit ouvert. Oubliez ce que vous savez sur les systèmes de gestion de contenu traditionnels qui limitent votre modélisation à des types de contenu prédéfinis, et arrêtez de penser au contenu en termes de chaînes de texte individuelles. La modélisation de contenu dans Contentful fonctionne un peu différemment, nous dirions même, elle fonctionne mieux.
Avec Contentful, votre contenu n’a pas besoin de s’adapter à notre modèle. Au lieu de cela, vous faites en sorte que le modèle s’adapte à vos éléments de contenu. Vous pouvez définir un modèle de contenu totalement unique, soit via notre application Web, soit via notre API de gestion de contenu Content Management API, que vous adaptez à votre projet. Pensez la modélisation de contenu en fonction des besoins de votre projet, tant pour la conception que pour les fonctionnalités. Si votre blog doit afficher des métadonnées sur les articles, assurez-vous d'inclure des champs à cet effet. De plus, si cet article a besoin d’une fonction « en coulisses », comme l’option de mise en avant, vous devrez ajouter un champ pour la gérer. Restez flexible et adaptez Contentful à vos besoins !
La modélisation dans Contentful diffère également de l’architecture de bases de données traditionnelle. Si vous avez déjà configuré une modélisation de contenu à l’aide d’une feuille de calcul, comme Excel ou Google Sheets, vous avez probablement modélisé d’un élément enfant à un élément parent. Dans Contentful, nous aimons copier Mère Nature et modéliser notre contenu de parent à enfant. Cela vous permet de tenir compte de toutes les exigences d'apparence dès le début de votre processus de modélisation.
Commencez par les grandes questions : que doit faire l’application finale et quelles informations doivent être affichées à nos utilisateurs ?
Décomposez
Avec ces deux questions à l’esprit, vous pouvez commencer à réfléchir à la manière de structurer votre modèle de contenu. Comme indiqué précédemment, votre modèle global est composé de types de contenu individuels. Chaque type de contenu représentera une seule unité ou un seul module de contenu dans votre application finale. Mais où se termine un type de contenu et où commence un autre ?
La réponse à cette question dépend de la structure ou de la flexibilité de votre modèle de contenu. Vos content strategists saisiront-ils toujours les mêmes types de données ? Ou cela changera-t-il en fonction de certains critères ? Pour les éléments de contenu prévisibles, comme un carnet d'adresses, vous pouvez probablement utiliser un seul type de contenu pour contenir toutes les informations. Une entrée de carnet d'adresses aura toujours besoin d'un nom, d'une adresse e-mail, d'un numéro de téléphone, etc.
Cependant, le site de portfolio d’un concepteur peut nécessiter un modèle plus flexible pouvant accueillir différents types de contenu. L’une de vos publications peut être une image, mais la suivante doit être une vidéo, et chaque type de média nécessite des métadonnées différentes. Dans ce cas, vous devez créer deux types de contenu distincts, un pour les images et un pour les vidéos, et les lier à votre publication si nécessaire.
Il est également bon d’identifier les éléments de contenu réutilisables. Un exemple classique est la biographie d'un auteur. Au lieu de taper le nom de l’auteur et le texte de présentation de sa biographie dans chaque article, vous pouvez créer un bloc de contenu réutilisable contenant les informations de l’auteur qui peuvent être utilisées encore et encore. La réutilisation de contenu peut simplifier considérablement votre flux de travail de création de contenu.
Mettre en place un système
Dès que vous savez ce que votre modèle de contenu doit permettre, vous pouvez commencer à le créer dans Contentful ! Dans le cadre de ce guide, nous allons parler de la modélisation au sein de notre application Web. Vous avez plusieurs options pour le faire : soit de manière visuelle et collaborative avec notre Visual Modeler, soit via l’interface de l’éditeur de type de contenu, dans l’onglet « Modèle de contenu ».
Vous pouvez bien sûr aussi configurer votre modèle de contenu de manière programmatique, en utilisant l’API de gestion de contenu Content Management API.
Si vous êtes nouveau sur Contentful, il est bon de jeter un coup d’œil rapide à notre guide de démarrage en 5 minutes afin de vous familiariser avec le jargon de notre plateforme.
Réitérer les changements
Lorsqu'elles travaillent sur un modèle de contenu, les équipes collaborent pour s'assurer qu'il fonctionne pour tout le monde et qu'il sert son objectif. Les développeurs conçoivent le modèle de contenu, tandis que les éditeurs sont ses utilisateurs finaux. Il est important que le modèle de contenu leur convienne à tous, c'est-à-dire qu'il corresponde à la fois aux besoins des éditeurs et à la configuration de l'application front-end.
Pour créer un modèle de contenu vraiment robuste et évolutif, une équipe procède par itérations : les développeurs conçoivent et construisent, tandis que leurs collègues non techniques testent et donnent leur retour. Avec notre Visual Modeler, vous pouvez rédiger, visualiser, partager et recueillir des commentaires sur votre modèle de contenu, le tout dans le contexte de l’application Web Contentful.
Utiliser les espaces à bon escient
Une fois que vous êtes à l’intérieur de l’application Web, vous commencez par créer les espaces pour votre modèle de contenu. Chaque espace représente une base de données de contenu distincte et contient des types de contenu, des entrées et des ressources média uniques, ainsi que des appartenances utilisateur et des clés API propres. En règle générale, nous vous conseillons de conserver tout votre contenu dans un seul espace, bien qu’il existe certaines situations où l’utilisation de plusieurs espaces est appropriée. Voici quelques lignes directrices pour travailler avec les espaces :
Quand utiliser plusieurs espaces :
Pour travailler sur des projets distincts ; par exemple, des travaux pour des clients ou des projets multipartites.
Pour créer un « terrain de jeu » pour les tests ; par exemple, essayer des fonctionnalités et des paramètres avec un contenu fictif lors de la première exploration de Contentful.
Quand NE PAS utiliser plusieurs espaces :
Pour la gestion des flux de travail ; par exemple, pour restreindre les autorisations de publication.
Pour créer plusieurs environnements de mise en scène (l'API de prévisualisation de contenu - Content Preview API - doit être utilisée pour tester le contenu provisoire).
Principes de base du champ de référence
Contentful utilise des champs de référence pour créer des relations entre les types de contenu. Un exemple basique d'utilisation d'un champ de référence est de lier un article à son auteur. Vous commencez par créer deux types de contenu : un pour la publication et un pour l'auteur. Dans la publication, vous incluez les champs nécessaires : un titre, un emplacement pour le corps de la publication et toute autre métadonnée. Le type de contenu de l’auteur peut inclure des champs pour le nom de l’auteur, une courte biographie et une photo. Une fois que vous avez configuré les deux types de contenu, il vous suffit de rouvrir le type de contenu de la publication et d'ajouter un nouveau champ de référence. Donnez-lui un nom descriptif comme « Informations sur l’auteur » et vous avez terminé ! Désormais, les entrées incluront toujours un champ à lier à l'auteur.
Type de contenu de publication (à gauche) et une entrée de ce type dans l’éditeur (à droite).
C'est un exemple très simple de création d'une relation de type parent-enfant, mais les champs de référence peuvent également être utilisés pour une modélisation beaucoup plus complexe. Dans notre article de blog sur la création d'un lookbook numérique, nous avons montré comment vous pouvez utiliser plusieurs types de contenu et champs de référence pour créer des conteneurs afin de garder votre modèle flexible et modulaire. Notre autre article de blog sur la création de modèles de contenu flexibles décrit le cas d'un client qui utilise des champs de référence et des types de contenu « conteneur » pour créer un modèle de contenu personnalisable pour la création de landing pages.
Un exemple d'utilisation créative des champs de référence est une liste ordonnée de contenus liés. En créant d’abord un type de contenu qui servira de conteneur, vous pouvez ajouter un champ pour les éléments liés qui fonctionnera comme une liste de type glisser-déposer dans l’éditeur d’entrées. Cela fonctionne à la fois pour les champs de référence et les champs de média. Outre la commodité d'avoir une liste facilement triable, cela vous permet également d'obtenir tout le contenu référencé en un seul appel d'API.
Champ de </em>référence<em> appelé « Entrées » pour créer une liste triable.
Gardez toujours à l’esprit que Contentful est conçu pour être flexible. Les possibilités sont nombreuses, selon votre stratégie de contenu, votre écosystème de contenu et vos besoins spécifiques. Si vous ne voyez pas immédiatement comment modéliser quelque chose, n’abandonnez pas ! Envoyez-nous un message et nous vous aiderons trouver une solution.
Paramètres de champ et validations
Chaque type de champ propose divers paramètres que vous pouvez configurer, notamment des options d’apparence et de validation. Tous les paramètres peuvent être modifiés ultérieurement, à l'exception du type de champ et de l'ID.
L'onglet validations
L’onglet validations dans les paramètres de votre champ est l’endroit où vous pouvez définir les spécifications et les exigences. Vous voulez vous assurer que le titre de votre article de blog est toujours rempli à 100 % ? Marquez simplement le champ comme obligatoire et vous serez tranquille.
Selon le type de champ, vous pourrez définir d'autres validations, comme spécifier un nombre de caractères requis ou définir des valeurs prédéfinies. L’une des validations utiles pour les champs de référence vous permet de spécifier le type de contenu des entrées qui peuvent être référencées. Il en va de même pour le champ des médias : vous ne voudriez pas mettre accidentellement une vidéo à la place d’une image !
Nous vous recommandons d'attendre d'avoir configuré tous vos types de contenu avant d'ajouter des validations.
L'onglet apparence
Accédez à l’onglet Apparence pour indiquer à Contentful comment vous souhaitez que le champ apparaisse dans l’éditeur d’entrées. L’option d’apparence que vous choisissez n’affecte pas la façon dont le contenu apparaît dans votre application finale, elle change simplement la façon dont il apparaît dans notre application Web.
Utilisez les options d’apparence pour faciliter la vie de vos créateurs de contenu. Au lieu de leur demander de taper dans un champ de texte vide, en espérant qu’il corresponde à l’une des valeurs prédéfinies, donnez-leur une liste déroulante afin qu’ils aient un modèle à choisir. Vous pouvez également créer des cases à cocher afin qu'ils puissent sélectionner plusieurs valeurs.
Champs de texte court.
Il est également recommandé de définir un texte d’aide personnalisé qui apparaîtra sous le champ afin de guider vos créateurs de contenu vers la réussite de leur marketing de contenu.
Gérer votre modèle de contenu
Il est très peu probable que vous configuriez votre modèle de contenu une fois et que vous ne le changiez plus jamais. Heureusement, Contentful permet à votre modèle de contenu d’évoluer avec votre projet. Lorsque le moment est venu de modifier votre modèle, vous pouvez modifier, désactiver ou supprimer des champs selon vos besoins.
Dupliquer et supprimer des types de contenu
Si vous devez apporter des modifications à un type de contenu, mais que vous ne voulez pas modifier votre modèle actuel, faites-en une copie ! Ouvrez votre type de contenu dans notre application Web et sélectionnez « dupliquer » dans le menu des actions.
Menu Actions dans le générateur de type de contenu.
Une fois que vous êtes prêt à supprimer l’ancienne version de votre type de contenu, il y a quelques étapes à suivre. Tout d'abord, vous devez supprimer toutes les entrées à l'aide du type de contenu. Cela garantit que vous ne supprimez pas le type de contenu par accident et que le contenu de votre application finale ne sera pas affecté. Sans les informations sur le type de contenu, votre application ne peut pas savoir comment l’entrée est structurée, et le résultat ne sera pas concluant.
Après avoir supprimé toutes les entrées de ce type de contenu (y compris les éléments archivés), vous pouvez supprimer complètement le type de contenu.
Gestion des champs
Il est facile d’apporter de petites modifications à votre modèle de contenu, comme l’ajout et la suppression de champs. Lorsque vous ajoutez des champs à un type de contenu existant, le nouveau champ sera automatiquement ajouté aux entrées existantes. Si le nouveau champ est obligatoire, les entrées existantes ne seront pas retenues pour la validation tant que l’entrée n’aura pas été mise à jour. Cela signifie que les anciennes entrées de ce type de contenu resteront publiées, malgré le champ obligatoire vide, jusqu'à ce que vous apportiez des modifications à cette entrée. À ce stade, vous devrez remplir le champ obligatoire avant de republier.
Masquer les champs lors de la modification
Masquer le champ lors de la modification signifie qu’un champ est masqué dans l’éditeur d’entrées, mais que son contenu reste présent dans la réponse de l’API. Utilisez ce statut pour masquer un champ spécifique aux éditeurs.
REMARQUE : un utilisateur a toujours la possibilité d’afficher un champ masqué et de modifier son contenu dans l’éditeur d’entrées. Pour empêcher un utilisateur de modifier le champ masqué, configurez le rôle d’espace de l’utilisateur en conséquence. Par exemple, ajoutez une règle de refus empêchant l’utilisateur de modifier ce champ.
Omettre de la réponse de l’API
L’omission de champs dans la réponse de l’API signifie que le contenu ne peut pas être récupéré par Content Delivery API (l’API de diffusion de contenu) et Content Preview API (l’API de prévisualisation de contenu(, et n’est donc pas disponible pour votre application finale. Ces champs sont toujours modifiables dans l’éditeur d’entrées. Un cas d’usage serait celui de champs qui ne sont pertinents que dans l’application web Contentful, comme les champs indiquant le statut d’une entrée dans votre flux de travail. Ces informations n’ont pas besoin d’être disponibles dans votre application finale, alors pourquoi ne pas gagner en efficacité en les excluant de la réponse ? L’optimisation, on est pour !
Supprimer des champs
Avant de supprimer un champ, vous devez d’abord le désactiver dans la réponse de l’API. Ce processus en deux étapes vous offre une protection supplémentaire contre les champs supprimés par erreur, ce qui pourrait être désastreux pour votre application finale ! De plus, en désactivant d’abord le champ dans la réponse, vous pouvez prévisualiser à quoi ressembleront vos réponses API après la suppression du champ. Assurez-vous toujours de tester vos réponses avant de supprimer des champs !
Obtenir de l’aide
La modélisation de contenu est un sujet vaste et parfois compliqué, alors ne vous inquiétez pas si vous vous sentez encore un peu perdu. Ce guide n'a fait qu'effleurer la surface. Si vous êtes bloqué pendant votre processus de modélisation, n’hésitez pas à nous contacter. Vous pouvez toujours nous envoyer un message par chat ou, pour des questions plus complexes, envoyer une demande d'assistance.
Ressources supplémentaires
Pour en savoir plus sur la modélisation de contenu avec Contentful, suivez les cours de formation de notre centre d’apprentissage :