Modèles

Les modèles sont utilisés à divers endroits dans AEM :

Lorsque vous créez une page, vous sélectionnez un modèle.. Ce modèle sert de base à la nouvelle page. Le modèle définit la structure de la page, tout contenu initial et le components qui peut être utilisé (propriétés de conception).
Lorsque vous créez un fragment de contenu, vous sélectionnez également 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

AEM propose désormais deux types de modèles de base pour la création de pages :

REMARQUE

Lors de l’utilisation d’un modèle pour création d’une page, il n’y a aucune différence visible (pour l’auteur de la page) et aucune indication du type de modèle utilisé.

Modèles modifiables

Les modèles modifiables font aujourd’hui partie des bonnes pratiques de développement avec AEM.

Les avantages des modèles modifiables :

Peut être created et modifié par vos auteurs.
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 conservée entre la page et le modèle. Ce lien signifie que les modifications apportées à la structure du modèle sont répercutées sur toutes les pages créées avec ce modèle ; les modifications apportées au contenu initial ne sont pas répercutées.
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.

REMARQUE

Voir Utilisation de modèles de page modifiables pour développer un site de Experience Manager.

Modèles statiques

Modèles statiques :

Doit être défini et configuré par vos développeurs.
Système de création de modèles d’AEM disponible pour 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.

REMARQUE

Depuis AEM version 6.5, l’utilisation des modèles statiques n’est plus considérée comme une bonne pratique. Privilégiez les modèles modifiables à la place.

Les outils de Modernisation d’AEM peuvent vous aider à migrer de modèles statiques à des modèles modifiables.

Disponibilité des modèles

ATTENTION

AEM offre plusieurs propriétés pour contrôler les modèles autorisés sous Sites. Cependant, leur combinaison peut conduire à des règles complexes difficiles à suivre et à gérer.

Par conséquent, Adobe vous recommande de commencer simplement, en définissant :

uniquement la propriété cq:allowedTemplates ;
uniquement sur la racine du site.

Pour consulter un exemple, reportez-vous à la section We.Retail : /content/we-retail/jcr:content

Les propriétés 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, le many plus simple à définir cq:allowedTemplates propriétés des sous-sections du site si des restrictions supplémentaires des modèles autorisés s’imposent.

Un autre avantage est que la variable cq:allowedTemplates Les propriétés peuvent être mises à jour par un auteur dans la variable Avancé de l’onglet 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 d’administration du site, la liste des modèles disponibles dépend de l’emplacement de la nouvelle page et des restrictions d’emplacement spécifiées dans chaque modèle.

Les propriétés suivantes déterminent si un modèle T est 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œud jcr:content de P ou un ancêtre de P.
La propriété allowedPaths de T.
La propriété allowedParents de T.
La propriété allowedChildren du modèle de P.

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 par P est comparée au chemin de T. 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 de P, 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 que P. T appartient à la même application que P si et seulement si le nom du deuxième niveau du chemin de T est identique à celui du deuxième niveau du chemin de P. 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 de P, 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 de T, T est rejeté.
Dans tous les autres cas, T est autorisé.

Le diagramme suivant illustre le processus d’évaluation de modèle :

chlimage_1-176

Limitation des modèles utilisés dans les pages enfants

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 utiliser la variable 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.