Modelos de páginas page-templates

Ao criar uma página, é necessário selecionar um modelo. O modelo de página é usado como a base da nova página. O modelo define a estrutura da página resultante, qualquer conteúdo inicial e os componentes que podem ser usados (propriedades de design). Isso tem várias vantagens:

Com os Modelos de página, as partes que fazem uma página são isoladas dentro dos componentes. É possível configurar as combinações necessárias de componentes em uma interface do usuário, eliminando a necessidade de um novo componente de página ser desenvolvido para cada variação de página.

Este documento:

Criação de um novo modelo creating-a-new-template

A criação de Modelos de página é feita principalmente com o console de modelo e o editor de modelo, por um autor de modelo. Esta seção fornece uma visão geral desse processo e segue com uma descrição do que ocorre em nível técnico.

Ao criar um modelo editável, você:

Pastas de Modelos template-folders

Para organizar seus templates, você pode usar as seguintes pastas:

Em uma instância padrão do AEM, a pasta global já existe no console modelo. Isso mantém modelos padrão e atua como um fallback se nenhuma política e/ou tipo de modelo for encontrado na pasta atual. Você pode adicionar seus modelos padrão a esta pasta ou criar uma pasta (recomendado).

Os tipos de modelo e as políticas são herdados em todas as pastas de acordo com a seguinte ordem de precedência:

Uma lista de todas as entradas permitidas é criada. Se alguma configuração se sobrepõe ( path/ label), somente a instância mais próxima à pasta atual é apresentada ao usuário.

Para criar uma pasta, faça o seguinte:

Uso do CRXDE Lite using-crxde-lite

Usar o navegador de configuração using-the-configuration-browser

ACLs e grupos acls-and-groups

Depois que as pastas de modelo forem criadas (via CRXDE ou com o Navegador de configuração), as ACLs deverão ser definidas para os grupos apropriados para as pastas de modelo, a fim de garantir a segurança adequada.

As pastas de modelo do Tutorial WKND podem ser usadas como exemplo.

O grupo de autores de modelo the-template-authors-group

O grupo template-authors é o grupo usado para gerenciar o acesso a modelos e vem com o AEM como padrão, mas está vazio. Os usuários devem ser adicionados ao grupo para o projeto/site.

A tabela a seguir detalha as permissões necessárias para a edição de modelos.

Este grupo template-authors padrão cobre apenas as configurações do projeto, onde todos os membros template-authors têm permissão para acessar e criar todos os modelos. Para configurações mais complexas, onde vários grupos de autores de modelo são necessários para separar o acesso aos modelos, mais grupos de autores de modelo personalizados devem ser criados. No entanto, as permissões para os grupos de autores de modelo ainda seriam as mesmas.

Tipo de modelo template-type

Ao criar um template, você precisa especificar um tipo de template:

Os tipos de template prontos para uso são armazenados em:

Os tipos de modelo específicos do site devem ser armazenados no local comparável do:

As definições dos tipos de modelos personalizados devem ser armazenadas em pastas definidas pelo usuário (recomendado) ou, como alternativa, em global. Por exemplo:

Criação de Tipos de Modelo creating-template-types

Se você tiver criado um modelo que possa servir como base de outros modelos, poderá copiá-lo como um tipo de modelo.

Você também pode desenvolver seu próprio tipo de modelo usando um modelo editável de exemplo como base, disponível no GitHub.

CÓDIGO NO GITHUB

Você pode encontrar o código desta página no GitHub

Definições de modelo template-definitions

As definições dos modelos editáveis estão armazenadas em pastas definidas pelo usuário (recomendado) ou, como alternativa, em global. Por exemplo:

O nó raiz do modelo é do tipo cq:Template com uma estrutura de esqueleto 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

Os principais elementos são:

jcr:content jcr-content

Este nó retém propriedades para o modelo:

Estrutura structure

Define a estrutura da página resultante:

Conteúdo inicial initial-content

Define o conteúdo inicial que uma nova página terá após a criação:

Layout layout

Ao editar um modelo para definir o layout, este usa o layout responsivo padrão.

Políticas de conteúdo content-policies

As políticas de conteúdo definem as propriedades de design de um componente. Por exemplo, os componentes disponíveis ou as dimensões mínima/máxima. Elas são aplicáveis ao modelo (e às páginas criadas com o modelo). As políticas de conteúdo podem ser criadas e selecionadas no editor de modelo.

Políticas da página page-policies

As políticas de página permitem definir a política de conteúdo para a página (parsys principal), no modelo ou nas páginas resultantes.

Ativação e permissão de um modelo para uso enabling-and-allowing-a-template-for-use

Páginas de conteúdo resultante resultant-content-pages

Páginas criadas a partir de modelos editáveis:

O diagrama acima mostra como os modelos, o conteúdo e os componentes se inter-relacionam:

Ao processar uma página:

Disponibilidade de modelo template-availability

Ao criar uma página na interface do administrador do site, a lista de modelos disponíveis depende do local da nova página e das restrições de posicionamento especificadas em cada modelo.

As propriedades a seguir determinam se um modelo T pode ser usado para que uma nova página seja colocada como filho da página P. Cada uma dessas propriedades é uma string de vários valores que contém zero ou mais expressões regulares usadas para correspondência com caminhos:

A avaliação funciona da seguinte forma:

O diagrama a seguir descreve o processo de avaliação do modelo:

Limite de modelos usados em páginas secundárias limiting-templates-used-in-child-pages

Para limitar quais modelos podem ser usados para criar páginas secundárias em uma determinada página, use a propriedade cq:allowedTemplates do nó jcr:content da página para especificar a lista de modelos a serem permitidos como páginas secundárias. Cada valor na lista deve ser um caminho absoluto para um modelo de uma página secundária permitida, por exemplo, /apps/wknd/templates/page-content.

Você pode usar a propriedade cq:allowedTemplates no nó jcr:content do modelo para aplicar essa configuração a todas as páginas criadas que usam esse modelo.

Se quiser adicionar mais restrições, por exemplo, em relação à hierarquia do modelo, você pode usar as propriedades allowedParents/allowedChildren no modelo. Em seguida, é possível especificar explicitamente que as páginas criadas a partir de um modelo T devem ser páginas principais/secundárias das páginas criadas a partir de um modelo T.