Plantillas de página page-templates

Al crear una página, debe seleccionar una plantilla. La plantilla de página se utiliza como base para la nueva página. La plantilla define la estructura de la página resultante, cualquier contenido inicial y los componentes que se pueden utilizar (propiedades de diseño). Esto tiene varias ventajas:

Con las plantillas de página, las partes que componen una página están aisladas dentro de los componentes. Puede configurar las combinaciones necesarias de componentes en una interfaz de usuario, lo que elimina la necesidad de desarrollar un nuevo componente de página para cada variación de página.

Este documento:

Creación de una nueva plantilla creating-a-new-template

La creación de plantillas de página se realiza principalmente con la consola de plantillas y el editor de plantillas por un autor de plantillas. En esta sección se ofrece una descripción general de este proceso y se incluye una descripción de lo que sucede a nivel técnico.

Al crear una plantilla editable, debe hacer lo siguiente:

Carpetas de plantilla template-folders

Para organizar las plantillas, puede utilizar las siguientes carpetas:

AEM En una instancia estándar, la carpeta global ya existe en la consola de plantillas. Contiene plantillas predeterminadas y actúa como alternativa en caso de que no se encuentre ninguna política ni ningún tipo de plantilla en la carpeta actual. Puede agregar las plantillas predeterminadas a esta carpeta o crear una carpeta (recomendado).

Los tipos de plantilla y las directivas se heredan en todas las carpetas según el siguiente orden de prioridad:

Se crea una lista de todas las entradas permitidas. Si alguna configuración se superpone ( path/ label), solo se presenta al usuario la instancia más cercana a la carpeta actual.

Para crear una carpeta, puede hacer lo siguiente:

Uso del CRXDE Lite using-crxde-lite

Uso del explorador de configuración using-the-configuration-browser

ACL y grupos acls-and-groups

Una vez creadas las carpetas de plantilla (ya sea mediante CRXDE o con el Explorador de configuración), se deben definir ACL para los grupos adecuados para las carpetas de plantilla para garantizar la seguridad adecuada.

Las carpetas de plantillas para el tutorial de WKND se pueden usar como ejemplo.

El grupo de autores de plantillas the-template-authors-group

AEM El grupo template-authors es el grupo que se usa para administrar el acceso a las plantillas y viene de serie con las plantillas, pero está vacío. Los usuarios deben agregarse al grupo para el proyecto o sitio.

La siguiente tabla detalla los permisos necesarios para editar plantillas.

Este grupo predeterminado de template-authors solo cubre las configuraciones de proyecto, en las que se permite a todos los miembros de template-authors acceder a todas las plantillas y crearlas. Para configuraciones más complejas, donde se necesitan varios grupos de autores de plantillas para separar el acceso a las plantillas, se deben crear grupos de autores de plantillas más personalizados. Sin embargo, los permisos para los grupos de autores de plantillas seguirían siendo los mismos.

Tipo de plantilla template-type

Al crear una plantilla, debe especificar un tipo de plantilla:

Los tipos de plantilla predeterminados se almacenan en:

Los tipos de plantilla específicos del sitio deben almacenarse en la ubicación comparable de:

Las definiciones de los tipos de plantillas personalizadas deben almacenarse en carpetas definidas por el usuario (recomendado) o, alternativamente, en global. Por ejemplo:

Creación de tipos de plantilla creating-template-types

Si ha creado una plantilla que puede servir de base a otras plantillas, puede copiar esta plantilla como un tipo de plantilla.

También puede desarrollar su propio tipo de plantilla con una plantilla editable de ejemplo como base, disponible en GitHub.

CÓDIGO EN GITHUB

Puede encontrar el código de esta página en GitHub

Definiciones de plantilla template-definitions

Las definiciones para plantillas editables se almacenan en carpetas definidas por el usuario (recomendado) o, alternativamente, en global. Por ejemplo:

El nodo raíz de la plantilla es del tipo cq:Template con una estructura básica de:

<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

Los elementos principales son:

jcr:contenido jcr-content

Este nodo contiene propiedades para la plantilla:

Estructura structure

Define la estructura de la página resultante:

Contenido inicial initial-content

Define el contenido inicial que tendrá una nueva página al crearla:

Diseño layout

Al editar una plantilla, puede definir el diseño, que usa diseño interactivo estándar.

Políticas de contenido content-policies

Las políticas de contenido definen las propiedades de diseño de un componente. Por ejemplo, los componentes disponibles o las dimensiones mínimas/máximas. Se aplican a la plantilla (y a las páginas creadas con la plantilla). Las políticas de contenido se pueden crear y seleccionar en el editor de plantillas.

Políticas de la página page-policies

Las directivas de página le permiten definir la directiva de contenido para la página (parsys principal), en la plantilla o en las páginas resultantes.

Habilitar y permitir el uso de una plantilla enabling-and-allowing-a-template-for-use

Páginas de contenido resultantes resultant-content-pages

Páginas creadas a partir de plantillas editables:

El diagrama anterior muestra cómo se interrelacionan las plantillas, el contenido y los componentes:

Al procesar una página:

Disponibilidad de la plantilla template-availability

Al crear una página en la interfaz de administración del sitio, la lista de plantillas disponibles depende de la ubicación de la nueva página y de las restricciones de colocación especificadas en cada plantilla.

Las siguientes propiedades determinan si se permite utilizar una plantilla T para colocar una nueva página como elemento secundario de la página P. Cada una de estas propiedades es una cadena de varios valores que contiene cero o más expresiones regulares que se utilizan para la coincidencia con rutas:

La evaluación funciona de la siguiente manera:

El diagrama siguiente muestra el proceso de evaluación de la plantilla:

Limitación de plantillas utilizadas en páginas secundarias limiting-templates-used-in-child-pages

Para limitar qué plantillas se pueden usar para crear páginas secundarias en una página determinada, use la propiedad cq:allowedTemplates del nodo jcr:content de la página para especificar la lista de plantillas que se permitirán como secundarias. Cada valor de la lista debe ser una ruta absoluta a una plantilla para una página secundaria permitida, por ejemplo, /apps/wknd/templates/page-content.

Puede usar la propiedad cq:allowedTemplates en el nodo jcr:content de la plantilla para aplicar esta configuración a todas las páginas creadas que usen esta plantilla.

Si desea agregar más restricciones, por ejemplo, con respecto a la jerarquía de plantillas, puede utilizar las propiedades allowedParents/allowedChildren en la plantilla. A continuación, puede especificar explícitamente que las páginas creadas a partir de una plantilla T tengan que ser páginas principales o secundarias de páginas creadas a partir de una plantilla T.