Content item

Un élément de contenu (Content item), dans Jahia, est n’importe quel objet stocké dans le référentiel de contenus (Content Repository). Une actualité, une image, une page, un dossier, une catégorie ou même un site sont tous des éléments de contenu, chacun fondé sur une définition qui fixe ses propriétés. Les développeurs parlent aussi de nœud (node, JCR node), un terme qui désigne la même chose.

Définition et fonctionnement

Dans Jahia, les mêmes mécanismes s’appliquent à tous les objets (un emplacement dans l’arbre, un chemin, un identifiant unique et des propriétés). Une page n’est pas un objet à part ; c’est un contenu d’un type particulier qui en contient d’autres. Cette cohérence rend la réutilisation plus simple et l’accès par API homogène, du texte d’un bandeau jusqu’à la structure complète d’un site.

Techniquement, chaque élément est un nœud d’un référentiel JCR (la norme Java de stockage de contenus sur laquelle repose Jahia). Il possède un identifiant unique (UUID), un chemin depuis la racine et des propriétés (un titre, une date, un prix), l’équivalent des colonnes d’un tableau. Les nœuds sont organisés en arbre et peuvent avoir des enfants. Le type du contenu détermine les propriétés disponibles et le formulaire présenté dans Content Editor.

Documentation Academy : comprendre la structure des contenus

L’élément de contenu et le type de contenu : les différences

L’élément de contenu est l’objet réel, enregistré avec ses valeurs. Il se distingue du modèle dont il découle et des attributs qui le composent.

L’élément de contenu et ses voisins
Notion	Ce qui la distingue de l’élément de contenu
Type de contenu	Le type est le modèle : il définit les propriétés communes à une famille de contenus. L’élément de contenu en est une instance, avec ses propres valeurs.
Propriété (contenu)	La propriété est un attribut du contenu, comme un prix ou une date. L’élément de contenu rassemble les valeurs de toutes ses propriétés.
Vue	La vue est le code qui transforme l’élément de contenu en HTML. Le même élément peut avoir plusieurs vues sans changer de valeurs.

L’élément de contenu en pratique

Un recruteur crée une offre d’emploi dans Content Editor. L’offre devient un élément de contenu du type "Offre d’emploi", avec ses valeurs (intitulé, lieu, contrat) et un identifiant unique. Le site carrières l’affiche dans une liste puis en pleine page ; une application tierce la lit via la GraphQL API. Il s’agit du même objet, maintenu à un seul endroit.

Au cadrage, la question à poser porte sur les valeurs que cet objet doit porter pour servir à la fois le site et l’application.

Questions fréquentes

Un contenu Jahia doit-il forcément appartenir à une page ?

La page n’est qu’un emplacement possible. Un élément de contenu peut être créé dans une zone de page, mais aussi dans un dossier de contenu, hors de toute page. Il peut alors être référencé dans plusieurs pages, affiché par une liste ou lu par une application via l’API. Cette souplesse permet de travailler contenu d’abord, sans dupliquer les textes d’une page à l’autre.

Pourquoi les développeurs parlent-ils de nœuds plutôt que de contenus ?

Le mot vient du stockage. Jahia repose sur un référentiel JCR, où chaque objet est stocké comme un nœud d’un arbre. "Nœud" et "élément de contenu" désignent le même objet. Le premier terme est courant dans le code, les API et la documentation technique ; le second dans les interfaces destinées aux contributeurs. Un cahier des charges gagne à fixer le vocabulaire dès le départ.

Une catégorie ou un site entier sont-ils vraiment des contenus comme les autres ?

Pour Jahia, oui. Une page, un dossier, une catégorie ou même un site sont des éléments de contenu. Tous reçoivent les mêmes mécanismes (un emplacement dans l’arbre, un chemin, un identifiant unique et des propriétés). Pour une équipe, cela veut dire une seule logique à apprendre ainsi qu’un accès par API homogène, du texte d’un bandeau jusqu’à la structure complète d’un site.