Modèles

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

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

Lorsque vous utilisez un modèle pour créer une page, il n’y a pas de différence visible (dans la page de création) et aucune indication du type de modèle utilisé.

Modèles modifiables

Les modèles modifiables sont désormais considérés comme des bonnes 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.

REMARQUE

Un article de la communauté AEM explique comment développer un site de Experience Manager avec des modèles modifiables. Voir Création d’un site web Adobe Experience Manager 6.4 à l’aide de modèles modifiables.

Modèles statiques

Modèles statiques:

  • Doivent être définis et configurés par vos développeurs.
  • Il s’agissait du système de création de modèles d’AEM d’origine, 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.
REMARQUE

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

AEM les outils de modernisation 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 très 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 obtenir un exemple, voir 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, 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.

Un autre avantage est que les propriétés 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œ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 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.

Sur cette page