Nom affiché
Le nom affiché (Displayable Name), dans Jahia, est l’étiquette qui identifie un contenu dans les interfaces. Les contributeurs le lisent quand ils parcourent les contenus dans jContent, suivent un fil d’Ariane, lancent un rapport ou utilisent un sélecteur. Un bon nom affiché se reconnaît tout de suite dans une liste ; un mauvais oblige à ouvrir chaque élément pour savoir ce qu’il contient.
Définition et fonctionnement
Jahia déduit le nom affiché d’autres champs. Il cherche d’abord le titre du contenu (jcr:title, apporté par le mixin mix:title, un ensemble de propriétés ajouté au type), puis la propriété que le développeur a désignée comme primaire dans la définition de type de contenu, et retient enfin le nom système, un identifiant technique.
Le nom système est l’identifiant interne d’un contenu, unique à son emplacement. Il accepte 32 caractères par défaut. La suite des noms système des parents forme le chemin du contenu, qui sert aussi d’adresse aux pages sans URL personnalisée. À la création d’un contenu doté d’un titre, Content Editor aligne automatiquement le nom système sur ce titre (minuscules, tirets à la place des espaces et des caractères spéciaux).
Documentation Academy : noms système, noms affichés et titres
Termes liés : URL personnalisée · Content item · Définition de type de contenu · Type de contenu · Content Repository · Content Editor
Ressources sur ce terme
Le nom affiché et le nom système : les différences
Un même contenu porte plusieurs noms qui ne jouent pas le même rôle. Les confondre conduit à modifier une URL en croyant changer un libellé.
| Notion | Ce qui la distingue |
|---|---|
| Nom système | Le nom système est l’identifiant interne, qui compose le chemin et, pour une page, l’URL. Le nom affiché est un libellé destiné aux personnes, sans effet sur l’adresse. |
| Titre (jcr:title) | Le titre est une propriété du contenu, qui peut être affichée aux visiteurs. Quand elle existe, elle sert aussi de nom affiché dans les interfaces. |
| URL personnalisée | L’URL personnalisée remplace l’adresse issue du chemin par une adresse choisie. Elle ne change ni le nom affiché ni le nom système. |
Le nom affiché en pratique
Dans un dossier de témoignages clients, jContent affiche une liste de noms système illisibles, car le type "Témoignage" n’a ni titre ni propriété primaire. L’intégrateur désigne la propriété "Nom du client" comme primaire dans la définition. La liste affiche désormais des noms lisibles, tout comme les sélecteurs de contenu.
Ce réglage se décide à la conception du type de contenu. Il coûte une ligne dans la définition et fait gagner du temps à chaque recherche.
Questions fréquentes
Pourquoi certains contenus apparaissent-ils sous un nom technique dans jContent ?
Un contenu apparaît sous un nom technique quand son type ne désigne aucune propriété comme primaire et ne comporte pas de titre. Jahia affiche alors le nom système, l’identifiant interne du contenu. La correction relève du développeur : désigner dans la définition la propriété qui doit servir de nom affiché, par exemple un nom, un intitulé ou une référence produit.
Modifier le titre d’un contenu change-t-il son URL ?
Pas automatiquement pour un contenu existant. Le nom système n’est aligné sur le titre qu’à la création. Ensuite, le bouton Copy Title de Content Editor permet de recopier le titre dans le nom système, mais changer le nom système d’une page publiée modifie son URL et peut casser des liens externes. Il faut alors prévoir une redirection ou une URL personnalisée.
Le nom affiché est-il visible des visiteurs du site ?
Le nom affiché est un libellé des interfaces de Jahia, pas un texte du site. Ce que voient les visiteurs dépend de la vue qui rend le contenu. Lorsque le nom affiché provient du titre, la même valeur apparaît sur le site dès lors que la vue affiche ce titre. Une propriété primaire purement interne, elle, peut rester invisible des visiteurs.