Modèles

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

• Lors de la création d’une page, vous devez sélectionner un modèle. C’est la base pour créer la page. Le modèle définit la structure de la page créée, le contenu initial et les composants qui peuvent être utilisés (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 de pages - Modifiables
• Modèles de page - Statiques
• Modèles de fragment de contenu
• Rendu de modèle adaptatif

Modèles - Pages

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

Modèles modifiables

Les modèles modifiables sont maintenant considérés comme les meilleures pratiques pour le développement avec AEM.

Avantages des modèles modifiables :

• Peuvent être créés et modifiés par vos auteurs.

• Sont proposés pour vous permettre de définir ce qui suit pour toutes les pages créées avec le modèle :

  • la structure
  • le contenu initial
  • les 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 Modèles modifiables pour plus d’informations.

Modèles statiques

Les modèles statiques :

• Doivent être définis et configurés par vos développeurs.
• Il s'agissait du système de modèle d'AEM d'origine et a été disponible pour de nombreuses versions.
• Un modèle statique est une hiérarchie de nœuds qui a la même structure que la page à créer, mais sans contenu réel.
• Sont copiés pour créer la nouvelle page, aucune connexion dynamique n’existe après cela.
• Utilisez le mode Conception pour conserver les propriétés de conception.
• Sont stockés sous /apps
• Consultez Modèles statiques pour plus d’informations.

Disponibilité des modèles

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œ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 :

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 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

Voir Modèles de fragment de contenu pour plus d’informations.