Dossier de contenu
Un dossier de contenu (Content Folder), dans Jahia, est un dossier qui héberge des contenus indépendamment de l’arborescence des pages. Il permet de travailler "contenu d’abord", en créant une fiche produit, une actualité ou une biographie une seule fois, dans un dossier, pour l’afficher ensuite là où elle est utile. Une même source peut alimenter plusieurs pages, plusieurs sites ou une application.
Définition et fonctionnement
Les contenus d’un dossier peuvent être référencés dans des pages, affichés automatiquement par une liste qui interroge le dossier, ou lus par une application via la GraphQL API. Publier une page qui référence un contenu de dossier lance aussi la publication de ce contenu s’il n’est pas encore publié. Ils se gèrent dans jContent, dans la section Content Folders, où l’on crée dossiers et sous-dossiers, puis les contenus eux-mêmes avec Content Editor. Un dossier peut recevoir un nom alternatif traduisible, affiché dans jContent, distinct de son nom système (son nom technique).
Un dossier peut être limité à certains types de contenu. Un dossier "Actualités" n’accepte alors que des actualités. Ce réglage se fait dans les options avancées du dossier, par défaut réservé aux administrateurs du site. Il ne s’applique qu’aux contenus créés après coup. Les contenus d’un dossier peuvent aussi être exportés et importés (XML ou ZIP).
Documentation Academy : introduction aux dossiers de contenu
Termes liés : Content Repository · Content Editor · GraphQL API · Enfant · Référence de contenu
Ressources sur ce terme
Le dossier de contenu et le dossier de médias : les différences
Le dossier de contenu se distingue à la fois des dossiers de fichiers et des pages, qui peuvent elles aussi porter des contenus.
| Notion | Ce qui le distingue |
|---|---|
| Dossier de médias | Les dossiers de la section Media rangent des fichiers (images, documents). Le dossier de contenu range des contenus structurés, saisis dans Content Editor. |
| Page | Un contenu créé dans une zone de page appartient à cette page. Un contenu créé dans un dossier n’appartient à aucune page et peut être affiché dans plusieurs. |
| Content Repository | Le référentiel est l’espace de stockage de tous les contenus. Le dossier n’en est qu’un emplacement, choisi pour organiser les contenus réutilisables. |
Le dossier de contenu en pratique
Une organisation publie les biographies de ses experts. Plutôt que de les saisir dans chaque page, l’équipe crée un dossier "Experts" limité au type "Biographie". Les pages de rubrique affichent les experts concernés par une liste filtrée ; un article cite un expert par référence de contenu ; une application mobile lit le même dossier via l’API.
Une biographie corrigée l’est partout à la fois. Le dossier devient la source unique. La limitation de type empêche d’y glisser par erreur un autre contenu.
Questions fréquentes
Faut-il créer une actualité Jahia dans un dossier de contenu ou dans une page ?
Si l’actualité ne doit apparaître qu’à un endroit, la créer dans une zone de page est le plus simple. Si elle doit être reprise dans plusieurs pages, listée automatiquement par thème ou lue par une autre application, le dossier de contenu est préférable, car la source reste unique et chaque page l’affiche à sa façon. Les deux approches coexistent dans un même site.
Peut-on empêcher de créer n’importe quel type de contenu dans un dossier ?
Les options avancées du dossier le permettent, grâce à la restriction des types de contenu qui limite ce que les contributeurs peuvent y créer. Ce réglage est par défaut réservé aux administrateurs du site. Il ne s’applique qu’aux nouveaux contenus, sans déplacer ceux déjà présents dans le dossier. Mieux vaut donc poser les restrictions dès la création du dossier.