Modèles de page page-templates

Lors de la création d’une page, vous devez sélectionner un modèle. Le modèle de page est utilisé comme base pour la nouvelle 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). Il offre plusieurs avantages :

Avec les modèles de page, les éléments qui constituent une page sont isolés au sein des composants. Vous pouvez configurer les combinaisons de composants nécessaires dans une interface utilisateur, rendant ainsi inutile le développement d’un nouveau composant de page pour chaque variante de page.

Ce document :

Création d’un modèle creating-a-new-template

La création de modèles de page s’effectue essentiellement à l’aide de la console de modèles et de l’éditeur de modèles. Cette tâche est de la responsabilité du créateur de modèles. Cette section vous donne un aperçu de ce processus. Elle décrit ensuite ce qui se passe au niveau technique.

Lors de la création d’un modèle modifiable :

Dossiers de modèles template-folders

Pour organiser vos modèles, vous pouvez utiliser les dossiers suivants :

Dans une instance AEM standard, le dossier global existe déjà dans la console de modèles. Il contient les modèles par défaut et fait office de dossier de rechange si le dossier actif ne contient pas de politiques et/ou de types de modèles. Vous pouvez ajouter vos modèles par défaut à ce dossier ou créer un dossier (recommandé).

Les types de modèles et les politiques sont hérités dans tous les dossiers selon l’ordre de priorité suivant :

Une liste de toutes les entrées autorisées est créée. Si des configurations se chevauchent (path/label), seule l’instance la plus proche du dossier actif s’affiche pour l’utilisateur.

Pour créer un dossier, vous pouvez effectuer l’une des opérations suivantes :

Utilisation de CRXDE Lite using-crxde-lite

Utilisation de l’explorateur de configurations using-the-configuration-browser

ACL et groupes acls-and-groups

Une fois vos dossiers de modèles créés (soit via CRXDE, soit à l’aide de l’explorateur de configurations), des listes de contrôle d’accès (ACL) doivent être définies pour les groupes appropriés afin que les dossiers de modèles garantissent une protection adéquate.

Les dossiers de modèles destinés au tutoriel WKND peuvent être utilisés à titre d’exemple.

Groupe template-authors the-template-authors-group

Le groupe template-authors est utilisé pour gérer l’accès aux modèles. Il est fourni en standard avec AEM, mais il est vide. Les utilisateurs doivent donc être ajoutés au groupe pour le projet/site.

Le tableau suivant présente les autorisations nécessaires à l’édition de modèles.

Ce groupe template-authors par défaut couvre les configurations de projet dans lesquelles tous les membres de template-authors sont autorisés à accéder à l’ensemble des modèles et à en créer. Pour les configurations plus complexes, lorsque plusieurs groupes de personnes créant des modèles sont nécessaires pour séparer l’accès aux modèles, vous devez créer davantage de groupes de personnes créant des modèles personnalisés. Toutefois, les autorisations des groupes de personnes créant des modèles restent les mêmes.

Type de modèle template-type

Lors de la création d’un modèle, vous devez indiquer un type de modèle :

Les types de modèles prêts à l’emploi sont stockés sous :

Les types de modèle spécifiques à un site doivent être stockés dans l’emplacement comparable :

Les définitions de vos types de modèle personnalisés doivent être stockées dans des dossiers définis par l’utilisateur (ce qui est recommandé) ou bien dans global. Par exemple :

Création de types de modèle creating-template-types

Si vous avez créé un modèle qui peut servir de base pour d’autres modèles, vous pouvez le copier en tant que type de modèle.

Vous pouvez également développer votre propre type de modèle en utilisant un exemple de modèle modifiable comme base (disponible sur GitHub).

Code sur Github

Vous pouvez trouver le code de cette page sur GitHub.

Définitions de modèle template-definitions

Les définitions des modèles modifiables sont stockées dans des dossiers définis par l’utilisateur (ce qui est recommandé) ou bien dans global. Par exemple :

Le nœud racine du modèle est de type cq:Template avec la structure suivante :

<template-name>
  initial
    jcr:content
      root
        <component>
        ...
        <component>
  jcr:content
    @property status
  policies
    jcr:content
      root
        @property cq:policy
        <component>
          @property cq:policy
        ...
        <component>
          @property cq:policy
  structure
    jcr:content
      root
        <component>
        ...
        <component>
      cq:responsive
        breakpoints
  thumbnail.png

Les éléments principaux sont les suivants :

jcr:content jcr-content

Ce nœud contient des propriétés pour le modèle :

Structure structure

Définit la structure de la page créée :

Contenu initial initial-content

Définit le contenu initial dont une nouvelle page disposera au moment de sa création :

Mise en page layout

Lorsque vous modifiez un modèle, vous pouvez définir la mise en page, qui utilise une mise en page réactive standard.

Politiques de contenu content-policies

Les politiques de contenu définissent les propriétés de conception d’un composant. Par exemple, les composants disponibles ou les dimensions minimales/maximales. Ces politiques s’appliquent au modèle (et aux pages créées avec le modèle). Les politiques de contenu peuvent être créées et sélectionnées dans l’éditeur de modèles.

Politiques de page page-policies

Les politiques de page vous permettent de définir la politique de contenu de la page (système de paragraphes principal), soit dans le modèle soit dans les pages créées.

Activation et autorisation d’un modèle à utiliser enabling-and-allowing-a-template-for-use

Pages de contenu créées resultant-content-pages

Les pages créées à partir de modèles modifiables :

Le schéma ci-dessus montre la corrélation entre les modèles, le contenu et les composants :

Lors du rendu d’une page :

Disponibilité des modèles template-availability

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

L’évaluation fonctionne comme suit :

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/wknd/templates/page-content.

Vous pouvez utiliser la propriété cq:allowedTemplates sur le noeud jcr:content du modèle pour que cette configuration soit appliquée à toutes les pages 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.