Référence de contenu
Une référence de contenu (Content Reference), dans Jahia, est un contenu d’un type particulier qui pointe vers un autre contenu, la source, situé ailleurs dans le référentiel. Le glossaire Academy la compare à un alias ou à un raccourci. Pour une équipe, c’est la manière de réutiliser une information sans la dupliquer, puisqu’on corrige la source une fois et que chaque référence affiche la version à jour.
Définition et fonctionnement
Le contributeur crée une référence en collant un contenu "comme référence" ou en déposant un contenu existant dans une zone. Jahia propose alors les types de référence compatibles avec le contenu déposé et avec la zone. Il en existe plusieurs : la référence de contenu générique, la référence de fichier, la référence d’image ainsi que la référence de dossier qui affiche tous les contenus d’un dossier de contenu. Certaines variantes sont traduisibles, ce qui permet de pointer vers une image ou un document différent selon la langue.
Une référence conserve son contexte. Affiché par une référence, le contenu apparaît comme s’il avait été créé à cet endroit, puisque le fil d’Ariane et les composants qui exploitent le chemin le placent sous la page de la référence. Le site retenu, par exemple pour choisir le template, est celui de la référence et non celui de la source.
Documentation Academy : comprendre la structure des contenus
Termes liés : Weak reference · Zone absolue · Content item · Dossier de contenu · Enfant
Ressources sur ce terme
La référence de contenu et la copie : les différences
La référence de contenu ne doit pas être confondue avec la copie (qui crée un nouvel objet) et avec la référence faible (qui n’est qu’une propriété d’un autre contenu).
| Notion | Ce qui la distingue de la référence de contenu |
|---|---|
| Copie | Une copie crée un contenu indépendant : modifier l’original ne change pas la copie. La référence affiche toujours la source, sans double saisie. |
| Weak reference (référence faible) | Une référence faible est une propriété d’un contenu qui pointe vers un autre, par exemple le champ image d’un article. La référence de contenu est un contenu à part entière, déposé dans une zone. |
| Zone absolue | La zone absolue partage automatiquement tout le contenu d’une zone sur une branche du site. La référence réutilise un contenu précis, à un endroit choisi par le contributeur. |
La référence de contenu en pratique
Une entreprise doit afficher le même avertissement réglementaire sur une vingtaine de pages produits. L’équipe crée l’encadré une fois dans un dossier de contenu, puis place une référence sur chaque page concernée. Quand le texte change, le service juridique fait valider une seule modification et toutes les pages suivent après publication.
Pour une fiche PDF dont il existe une version par langue, une référence de fichier traduisible pointe vers le bon document dans chaque langue, depuis un seul emplacement dans la page.
Questions fréquentes
Faut-il copier un contenu ou le référencer pour l’afficher sur plusieurs pages ?
Si le contenu doit rester identique partout, la référence est préférable, car la source est unique et une correction se répercute sur toutes les pages. La copie se justifie quand chaque page doit pouvoir faire évoluer sa version indépendamment, par exemple pour adapter un texte à une audience. Dans le doute, la référence évite les versions divergentes.
Une référence de contenu peut-elle pointer vers un contenu d’un autre site ?
La documentation Academy décrit ce cas avec une contrainte. Les sites concernés doivent avoir des noms de serveur distincts et être consultés avec ces noms. Le contenu affiché prend alors le contexte de la référence, y compris son site pour le choix du template. Ce point se valide avec l’intégrateur avant de bâtir une stratégie de partage entre sites.
Peut-on afficher une image différente selon la langue avec une seule référence ?
Les variantes traduisibles sont faites pour cela. Les références d’image et de fichier existent en version traduisible, où la référence pointe vers un contenu différent pour chaque langue. C’est utile pour des visuels qui contiennent du texte ou pour des documents publiés en plusieurs langues. Le contributeur gère un seul emplacement dans la page et choisit la cible de chaque langue.