Modèles templates
Les modèles sont utilisés à divers endroits dans AEM :
-
When création d’une page pour laquelle vous devez sélectionner un modèle; il sera utilisé comme base pour la nouvelle page. Le modèle définit la structure de la page créée, tout contenu initial et le components qui peut être utilisé (propriétés de conception).
-
Lorsque vous créez un fragment de contenu, vous devez également sélectionner un modèle. Ce modèle définit la structure, les éléments initiaux et les variations.
Les modèles suivants sont décrits en détail :
Modèles - Pages templates-pages
AEM propose désormais deux types de modèles de base pour la création de pages :
Modèles modifiables editable-templates
Les modèles modifiables sont désormais considérés comme des bonnes pratiques pour le développement avec AEM.
Les avantages des modèles modifiables :
-
Ont été introduites pour vous permettre de définir les éléments suivants pour toutes les pages créées avec le modèle :
- la structure
- le contenu initial
- stratégies de contenu
-
Une fois la nouvelle page créée, une connexion dynamique est maintenue entre la page et le modèle. Cela signifie que les modifications apportées à la structure du modèle sont répercutées sur les pages créées avec ce modèle (les modifications apportées au contenu initial ne le sont pas).
-
Utilisent des stratégies de contenu (modifiés à partir de l’éditeur de modèles) pour conserver les propriétés de conception (n’utilise pas le mode Conception dans l’éditeur de page).
-
Sont stockés sous
/conf
. -
Consultez les Modèles modifiables pour plus d’informations.
Modèles statiques static-templates
Modèles statiques :
- Doit être défini et configuré par vos développeurs.
- Il s’agissait du système de création de modèles d’AEM d’origine, disponible dans de nombreuses versions.
- Un modèle statique est une hiérarchie de noeuds ayant la même structure que la page à créer, mais sans contenu réel.
- sont copiés pour créer la page ; aucune connexion dynamique n’existe par la suite.
- Utilisations Mode de conception pour conserver les propriétés de conception.
- Sont stockés sous
/apps
. - Consultez les Modèles statiques pour plus d’informations.
Disponibilité des modèles template-availability
-
uniquement la propriété
cq:allowedTemplates
; -
uniquement sur la racine du site.
/content/we-retail/jcr:content
allowedPaths
, allowedParents
et allowedChildren
peuvent également être placées sur les modèles pour définir des règles plus élaborées. Cependant, dans la mesure du possible, il est beaucoup plus simple de définir d’autres propriétés cq:allowedTemplates
dans des sous-sections du site si des restrictions supplémentaires des modèles autorisés s’imposent.cq:allowedTemplates
peuvent être mises à jour par un auteur dans l’onglet Avancé des Propriétés de la page. Les autres propriétés de modèle ne peuvent pas être mises à jour à l’aide de l’interface utilisateur (standard). Il faudrait donc qu’un développeur conserve les règles et qu’un déploiement du code soit effectué pour chaque modification.Lors de la création d’une page dans l’interface admin du site, la liste des modèles disponibles dépend de l’emplacement de la nouvelle page et des restrictions de positionnement spécifiées dans chaque modèle.
Les propriétés suivantes déterminent si un modèle T
peut être utilisé pour qu’une nouvelle page soit placée en tant qu’enfant de la page P
. Chacune de ces propriétés est une chaîne à valeurs multiples contenant aucune ou plusieurs expressions régulières utilisées pour la correspondance avec les chemins :
-
La propriété
cq:allowedTemplates
du sous-nœudjcr:content
deP
ou un ancêtre deP
. -
La propriété
allowedPaths
deT
. -
La propriété
allowedParents
deT
. -
La propriété
allowedChildren
du modèle deP
.
L’évaluation fonctionne comme suit :
-
La première propriété
cq:allowedTemplates
non vide détectée dans la hiérarchie de page commençant parP
est comparée au chemin deT
. Si aucune des valeurs ne correspond,T
est rejeté. -
Si
T
a une propriétéallowedPaths
non vide, mais qu’aucune des valeurs ne correspond au chemin deP
,T
est rejeté. -
Si les deux propriétés ci-dessus sont vides ou inexistantes,
T
est rejeté sauf s’il appartient à la même application queP
.T
appartient à la même application queP
si et seulement si le nom du deuxième niveau du chemin deT
est identique à celui du deuxième niveau du chemin deP
. Par exemple, le modèle/apps/geometrixx/templates/foo
appartient à la même application que la page/content/geometrixx
. -
Si
T
a une propriétéallowedParents
non vide, mais qu’aucune des valeurs ne correspond au chemin deP
,T
est rejeté. -
Si le modèle de
P
a une propriétéallowedChildren
non vide, mais qu’aucune des valeurs ne correspond au chemin deT
,T
est rejeté. -
Dans tous les autres cas,
T
est autorisé.
Le diagramme suivant illustre le processus d’évaluation de modèle :
Limitation des modèles utilisés dans les pages enfants limiting-templates-used-in-child-pages
Pour limiter les modèles servant à créer des pages enfants sous une page donnée, utilisez la propriété cq:allowedTemplates
du nœud jcr:content
de la page pour spécifier la liste des modèles à autoriser en tant que pages enfants. Chaque valeur de la liste doit être un chemin absolu vers un modèle pour une page enfant autorisée, par exemple /apps/geometrixx/templates/contentpage
.
Vous pouvez appliquer la propriété cq:allowedTemplates
sur le nœud jcr:content
du modèle pour que cette configuration soit appliquée à toutes les pages nouvellement créées qui utilisent ce modèle.
Si vous souhaitez ajouter d’autres contraintes, par exemple concernant la hiérarchie des modèles, vous pouvez appliquer les propriétés allowedParents/allowedChildren
sur le modèle. Vous pouvez ensuite spécifier explicitement que les pages créées à partir d’un modèle T doivent être des parents/enfants de pages créées à partir d’un modèle T.
Modèles - Fragments de contenu templates-content-fragments
Voir Modèles de fragment de contenu pour plus d’informations.