Modèles de fragment de contenu

Les modèles sont sélectionnés lors de la création d’un fragment de contenu. Ils fournissent au nouveau fragment la structure de base, les éléments et la variation. Les modèles utilisés pour les fragments de contenu sont soumis au gestionnaire de configuration Granite.

Les modèles prêts à l’emploi sont stockés sous :

• /libs/settings/dam/cfm/templates

Vous pouvez créer des modèles spécifiques à vos sites pour les fragments de contenu sous :

• /apps/settings/dam/cfm/templates
  Emplacement pour l’incrustation de modèles prêts à l’emploi ou la fourniture de modèles spécifiques à l’application à l’utilisateur qui ne sont pas destinés à être étendus/modifiés au moment de l’exécution.

• /conf/global/settings/dam/cfm/templates
  Emplacement des modèles spécifiques au client à l’échelle de l’instance qui doivent être modifiés au moment de l’exécution.

L'ordre de priorité est (dans l'ordre décroissant) /conf, /apps, /libs.

La structure de base d’un modèle est stockée sous :

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

La structure spécifique étant :

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

Plus de détails sur les nœuds et leurs propriétés :

• Template

  Nom	Type	Valeur
  <template-name>	nt:unstructured	Ce noeud est la racine de chaque modèle. Il est obligatoire et doit avoir un nom unique.
  jcr:title	String required	Titre du modèle (affiché dans l’assistant Créer un fragment).
  jcr:description	String facultatif	Texte décrivant l’objectif du modèle (affiché dans l’assistant Créer un fragment).
  initialAssociatedContent	String[] facultatif	Tableau contenant les chemins d’accès aux collections qui doivent être associées par défaut à un fragment de contenu nouvellement créé.
  precreateElements	Boolean requis	true, si les sous-ressources représentant les éléments (à l’exception de l’élément maître) du fragment de contenu doivent être créées lors de la création du fragment de contenu ; false s'ils doivent être créés "à la volée". Remarque : actuellement, ce paramètre doit être défini sur true.
  version	Long requis	version de la structure de contenu ; actuellement pris en charge : Remarque : actuellement, ce paramètre doit être défini sur 2.

• Éléments

  Nom	Type	Valeur
  elements	nt:unstructured requis	Noeud contenant la définition des éléments du fragment de contenu. Elle est obligatoire et doit contenir au moins un noeud enfant pour l’élément Main, mais peut contenir [1..n] nœuds enfants. Lorsque le modèle est utilisé, la sous-branche éléments est copiée dans la sous-branche modèle du fragment. Le premier élément (affiché en CRXDE Lite) est automatiquement considéré comme l’élément main; le nom du noeud n'est pas pertinent et le noeud lui-même n'a pas de signification particulière, à part le fait qu'il est représenté par l'actif principal ; les autres éléments sont traités comme des sous-ressources.

• Nom de l’élément

  Nom	Type	Valeur
  <element-name>	nt:unstructured	Ce noeud définit un élément. Il est obligatoire et doit avoir un nom unique.
  jcr:title	String requis	Titre de l’élément (affiché dans le sélecteur d’éléments de l’éditeur de fragments).
  defaultContent	String facultatif default: ""	Contenu initial de l'élément ; utilisé uniquement si precreateElements = true
  initialContentType	String facultatif default: text/html	Type de contenu initial de l’élément ; utilisé uniquement si precreateElements = true; actuellement pris en charge : text/html text/plain text/x-markdown
  name	String requis	Nom interne de l’élément ; doit être unique pour le type de fragment.

• Variations

  Nom	Type	Valeur
  variations	nt:unstructured facultatif	Ce noeud facultatif contient la définition des variations initiales du fragment de contenu.

• Nom de la variation

  Nom	Type	Valeur
  <variation-name>	nt:unstructured requis si un noeud de variation est présent	Définit une variation initiale. La variation est ajoutée à tous les éléments du fragment de contenu par défaut. La variation aura le même contenu initial que l’élément correspondant (voir defaultContent/ initialContentType).
  jcr:title	String requis	Titre de la variation (affiché dans l’onglet Variation de l’éditeur de fragments (rail de gauche)).
  jcr:desciption	String facultatif default: ""	Texte qui fournit une description de la variation (affichée dans l’onglet Variation de l’éditeur de fragments (rail de gauche)).