Show Menu
SUJETS×

Modèles de fragment de contenu

Les modèles de fragment de contenu sont désormais recommandés pour créer tous les fragments.
Les modèles de fragment de contenu sont utilisés pour tous les exemples dans We.Retail.
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.
The order of precedence is (in descending order) /conf , /apps , /libs .
Vous ne devez rien modifier dans le chemin /libs .
En effet, le contenu de /libs est remplacé dès que vous mettez à niveau votre instance (et risque de l’être si vous appliquez un correctif ou un Feature Pack).
La méthode recommandée pour la configuration et d’autres modifications est la suivante :
  1. Recreate the required item (i.e. as it exists in /libs ) under /apps
  2. Apportez les modifications désirées dans /apps
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 (Modèle)
    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
    requis
    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. It is mandatory and needs to contain at least one child node for the Main element, but can contain [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.
    The first element (as viewed in CRXDE Lite) is automatically considered to be the main element; the node name is irrelevant and the node itself does not have a special significance, apart from the fact that it is represented by the main asset; the other elements are handled as sub assets.
  • 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)).