L'identifiant relatif (relativeId) d'un document

Dans un site ParoiCMS, les documents et les parties appartiennent à une arborescence. Dans cette arborescence, chaque document ou partie est relié à une feuille (leaf). Pour chaque feuille, ParoiCMS stocke un identifiant relatif en plus de son identifiant.

Voici un exemple de contenu de la table PaLeaf dans la base data/main.sqlite :

sqlite> select id, typeName, relativeId from PaLeaf;
id  typeName     relativeId
--  -----------  ----------
1   _site        q34
2   home         u6d
3   pages        8e4
4   posts        u2b
5   tags         c46
6   aboutPage    z2i
7   contactPage  9t0
8   searchPage   i9v

Chaque enfant du même parent doit avoir un identifiant relatif différent. Cet identifiant est visible par l'utilisateur lorsque le document est de type normal (regular) puisqu'il est alors présent dans l'URL :

Par défaut, il s'agit de trois caractères générés aléatoirement. Il est possible d'augmenter le nombre de caractères pour cet identifiant. Cela peut être utile, par exemple, lorsqu'il est prévu d'avoir de très nombreux enfants dans le même document parent.

Voici comment faire. Éditez le fichier site-schema.json, positionnez-vous dans le type de document à amender, et ajoutez :

      "relativeIdGenerator": ["default", 6],

Cela aura pour effet de générer désormais, pour les futurs documents, des identifiants relatifs à six caractères.