Modèles de fragment de contenu sont recommandés pour créer tous les nouveaux fragments de contenu.
Les modèles de fragment de contenu sont utilisés pour tous les exemples dans WKND.
Avant la version 6.3 d’AEM, les fragments de contenu étaient créés à partir de modèles plutôt que de modèles.
Les modèles de fragment de contenu sont désormais obsolètes. Ils peuvent toujours être utilisés pour créer des fragments, mais il est recommandé d’utiliser à la place des modèles de fragment de contenu . Aucune nouvelle fonctionnalité ne sera ajoutée aux modèles de fragment et elles seront supprimées dans une version ultérieure.
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 superposer des modèles d’usine ou fournir des modèles spécifiques à l’application au client qui ne sont pas destinés à être étendus/modifiés au moment de l’exécution.
/conf/global/settings/dam/cfm/templates
Emplacement pour les 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
.
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 :
Recréez l’élément requis (c.-à-d. tel qu’il existe dans /libs
) sous /apps
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 :
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 |
required |
Le titre du modèle (affiché dans la Créer un fragment ). |
jcr:description |
facultatif |
Un texte qui décrit l’objet du modèle (affiché dans la Créer un fragment ). |
initialAssociatedContent |
facultatif |
Tableau avec chemins d’accès aux collections qui doivent être associées par défaut à un fragment de contenu nouvellement créé. |
precreateElements |
required |
Remarque: Actuellement, ce paramètre doit être défini sur |
version |
required |
la version de la structure de contenu ; actuellement pris en charge : Remarque: Actuellement, ce paramètre doit être défini sur |
Éléments
Nom | Type | Valeur |
---|---|---|
elements |
required |
Noeud contenant la définition des éléments du fragment de contenu. Elle est obligatoire et doit contenir au moins un noeud enfant pour la variable Principal , 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 (tel qu’affiché dans CRXDE Lite) est automatiquement considéré comme le main element; le nom du noeud n’est pas pertinent et le noeud lui-même n’a pas de signification particulière, à l’exception du fait qu’il est représenté par la ressource principale ; 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 |
required |
Titre de l’élément (affiché dans le sélecteur d’éléments de l’éditeur de fragments). |
defaultContent |
facultatif par défaut: "" |
Contenu initial de l’élément ; utilisé uniquement si precreateElements = true |
initialContentType |
facultatif par défaut: |
Type de contenu initial de l’élément ; utilisé uniquement si
|
name |
required |
le nom interne de l’élément ; doit être unique pour le type de fragment. |
Variations
Nom | Type | Valeur |
---|---|---|
variations |
facultatif |
Ce noeud facultatif contient la définition des variantes initiales du fragment de contenu. |
Nom de la variation
Nom | Type | Valeur |
---|---|---|
<variation-name> |
requis si un noeud de variation est présent |
Définit une variation initiale. La variation aura le même contenu initial que l’élément correspondant (voir |
jcr:title |
required |
Titre de la variation (affiché dans le Variation (rail de gauche). |
jcr:desciption |
facultatif par défaut: "" |
Texte qui fournit une description de la variation (affiché dans le Variation (rail de gauche). |