Aller au contenu
EnglishFrançais

Propriété (contenu)

Une propriété est un attribut d’un contenu, comme le titre d’un article, la date d’un événement ou le prix d’une annonce. Les développeurs la déclarent dans la définition de type de contenu. Les contributeurs en renseignent la valeur au moyen d’un champ quand ils saisissent le contenu. L’ensemble de ces attributs décide de ce qu’un content item peut porter.

Définition et fonctionnement

Le choix des propriétés engage l’équipe pour longtemps. Ce qui est rangé dans un attribut distinct peut être filtré, trié, réutilisé dans une liste, traduit à part ou servi par API à une autre application. Ce qui est noyé dans un grand champ de texte ne le peut pas. Une date d’événement saisie dans le corps d’un article ne permettra jamais de lister les événements à venir.

Techniquement, chaque attribut a un type (texte, texte riche, date, nombre, oui/non, référence vers un autre contenu...). Il peut être traduisible ou commun à toutes les langues. Il peut accepter une seule valeur ou une liste. Sa déclaration figure dans un fichier au format .cnd livré dans un module, le paquet de code installé sur Jahia.

Documentation Academy : modifier une définition de contenu existante

Termes liés : Type de contenu · Champ · Propriété (jExperience) · Content item · Définition de type de contenu · Content Editor

Ressources sur ce terme

La propriété et le champ : les différences

La propriété est la donnée enregistrée. Le champ est la façon de la saisir. Le type de contenu est l’ensemble des attributs qui décrivent une même famille de contenus.

La propriété de contenu parmi ses voisines
NotionCe qui la distingue
ChampLe champ est le contrôle de saisie affiché dans Content Editor. Il modifie une valeur enregistrée.
Type de contenuLe type de contenu rassemble les attributs d’une famille de contenus, par exemple une offre d’emploi.
Propriété (jExperience)Dans jExperience, le même mot décrit un visiteur, une session ou une interaction, pas un contenu éditorial.

La propriété en pratique

Un type Offre d’emploi porte des attributs distincts pour l’intitulé, le lieu, le type de contrat, la date de publication et le descriptif. Le site peut alors proposer un filtre par lieu et par contrat. Il peut aussi retirer automatiquement de la liste les offres trop anciennes. Si lieu et contrat avaient été saisis dans le descriptif, aucune de ces fonctions ne serait possible sans ressaisie.

En phase de cadrage, demandez pour chaque information si quelqu’un voudra un jour la filtrer, la trier ou la réutiliser ailleurs.

Questions fréquentes

Toutes les propriétés doivent-elles être traduites ?

Non. Une propriété peut être traduisible ou commune à toutes les langues. Ce choix se fait dans la définition du type. Un titre ou un descriptif se traduisent. Un prix, une date ou une référence vers une image peuvent rester communs. Bien trancher évite aux équipes de ressaisir la même valeur dans chaque langue, ou au contraire de bloquer une adaptation locale nécessaire.

Peut-on ajouter une propriété à un type de contenu déjà utilisé ?

Oui, si le nouvel attribut n’impose pas de contrainte, comme une saisie obligatoire. Il est alors ajouté dans la définition du type puis déployé avec le module. Les contenus existants n’ont pas encore de valeur pour lui. Prévoyez qui la renseigne, ou comment l’affichage se comporte quand elle manque. Supprimer un attribut ou changer son type est bien plus risqué. Les contenus concernés peuvent devenir illisibles ou impossibles à modifier, d’où une reprise des données à prévoir avant.