Enfant

Un enfant (Child), dans Jahia, est un contenu placé sous un contenu parent dans l’arbre du référentiel, la base où Jahia stocke tous ses contenus. Le glossaire Academy compare le parent à une branche et l’enfant à une feuille. Une sous-page, un texte déposé dans une zone ou un contenu rangé dans un dossier sont ainsi les enfants de la page ou du dossier qui les contient.

Définition et fonctionnement

La relation parent-enfant n’est pas qu’un détail technique. Elle explique pourquoi un contenu déplacé emporte avec lui tout ce qui se trouve sous lui. Elle explique aussi pourquoi l’adresse d’un contenu dépend de sa place. Le chemin d’un contenu est la suite des noms système (les noms techniques) de ses parents, par exemple /sites/monsite/home/a-propos. Pour les pages et les contenus affichés en pleine page, ce chemin sert aussi d’URL, sauf si une URL personnalisée (vanity URL) est définie.

Techniquement, chaque contenu est un nœud, c’est-à-dire un point de l’arbre, dans un référentiel JCR (la norme Java de stockage de contenus sur laquelle repose Jahia). Il est identifié par un identifiant unique et par son chemin. Un nœud peut avoir de zéro à plusieurs enfants. Un enfant peut donc lui-même être parent. La "feuille" de l’image n’est pas forcément au bout de l’arbre. Lorsque les contenus placés sous un autre peuvent être ordonnés, Content Editor affiche une section dédiée à leur ordre.

Documentation Academy : comprendre la structure des contenus

L’enfant et la référence de contenu : les différences

Un contenu n’a qu’un emplacement dans l’arbre, donc un seul parent. Pour le montrer ailleurs, on ne crée pas un second parent, on utilise une référence.

Position dans l’arbre et notions voisines
Notion	Ce qui la distingue
Référence de contenu	Une référence est un contenu qui pointe vers un autre contenu situé ailleurs dans l’arbre. Le contenu source reste l’enfant de son parent d’origine ; la référence est l’enfant de l’endroit où elle est placée.
Dossier de contenu	Un dossier est un parent destiné à ranger des contenus hors des pages. Les contenus qu’il héberge sont ses enfants, au même titre que ceux d’une page.
Content item	L’élément de contenu désigne l’objet lui-même. "Enfant" ne qualifie pas l’objet mais sa position par rapport à un autre.

L’enfant en pratique

Lors d’une refonte, une équipe déplace la rubrique "Carrières" sous "Entreprise". Toutes les sous-pages et tous les contenus déposés dans leurs zones suivent automatiquement, puisqu’ils sont placés sous la rubrique. En revanche, le chemin de chaque page change. Sans URL personnalisée, l’adresse publique change aussi, ce qui impose de prévoir les redirections.

Les liens posés dans les textes enrichis résistent au déplacement, car Jahia stocke l’identifiant technique du contenu cible en plus de son chemin.

Questions fréquentes

Déplacer une page dans Jahia déplace-t-il aussi ses contenus et ses sous-pages ?

Oui. Les sous-pages et les contenus déposés dans les zones de la page sont ses enfants dans l’arbre du référentiel et suivent donc le déplacement. Le chemin de chacun change, puisqu’il est construit à partir des noms de ses parents. Pour les pages sans URL personnalisée, l’adresse publique change donc aussi. Il faut alors anticiper les redirections.

Un même contenu peut-il avoir deux parents ?

Un contenu n’a qu’un parent, puisqu’il occupe un seul emplacement dans l’arbre. Pour l’afficher à plusieurs endroits sans le dupliquer, on place une référence de contenu à chaque endroit voulu. Cette référence pointe vers la source, qui reste unique. Une modification de la source se voit alors partout où elle est référencée.

Un contenu enfant peut-il avoir lui-même des enfants ?

Sur autant de niveaux que la structure l’exige. Un nœud peut avoir de zéro à plusieurs enfants. Une sous-page porte ainsi ses propres sous-pages et les contenus déposés dans ses zones. La "feuille" de l’image n’est donc pas forcément au bout de l’arbre. En pratique, déplacer un contenu revient à déplacer toute la branche qu’il porte, à tous les niveaux.