Modelos de página - Estáticos

Um Modelo é usado para criar uma Página e define quais componentes podem ser usados dentro do escopo selecionado. Um modelo é uma hierarquia de nós que tem a mesma estrutura da página a ser criada, mas sem nenhum conteúdo real.

Cada modelo apresentará uma seleção de componentes disponíveis para uso.

• Os modelos são criados de Componentes;
• Os componentes usam e permitem acesso a Widgets e eles são usados para renderizar o Conteúdo.

Propriedades e nós filhos de um modelo

Um modelo é um nó do tipo cq:Template e tem as seguintes propriedades e nós filhos:

Um modelo é a base de uma página.

Para criar uma página, o modelo deve ser copiado (árvore de nó /apps/<myapp>/template/<mytemplate>) para a posição correspondente na árvore do site: isso é o que acontece se uma página é criada usando o Sites guia.

Essa ação de cópia também fornece à página seu conteúdo inicial (geralmente, Conteúdo de nível superior somente) e a propriedade sling:resourceType, o caminho para o componente de página usado para renderizar a página (tudo no nó filho jcr:content).

Como os modelos são estruturados

Há dois aspectos a considerar:

• a estrutura do próprio modelo
• a estrutura do conteúdo produzido quando um template é usado

A estrutura de um modelo

Um modelo é criado em um nó do tipo cq:Template.

Várias propriedades podem ser definidas, em particular:

• jcr:title - título do modelo; aparece na caixa de diálogo ao criar uma página.
• jcr:description - descrição do modelo; aparece na caixa de diálogo ao criar uma página.

Este nó contém um nó jcr:content (cq:PageContent) que pode ser usado como base para o nó de conteúdo das páginas resultantes; faz referência, usando sling:resourceType, ao componente a ser usado para renderizar o conteúdo real de uma nova página.

Esse componente é usado para definir a estrutura e o design do conteúdo quando uma nova página é criada.

O conteúdo produzido por um Template

Os modelos são usados para criar páginas do tipo cq:Page (como mencionado anteriormente, uma página é um tipo especial de componente). Cada página AEM tem um nó estruturado jcr:content. Isto:

• é do tipo cq:PageContent
• é um nó estruturado-tipo que contém uma definição de conteúdo definida
• tem uma propriedade sling:resourceType para fazer referência ao componente que contém os scripts sling usados para renderizar o conteúdo

Modelos padrão

O AEM vem com vários modelos padrão disponíveis imediatamente. Em alguns casos, você pode querer usar os modelos como estão. Nesse caso, você precisa garantir que o modelo esteja disponível para o seu site.

Por exemplo, o AEM vem com vários modelos, incluindo uma página de conteúdo e uma página inicial.

Exibição de Modelos Padrão

Para ver uma lista de todos os modelos no repositório, proceda da seguinte maneira:

1. No CRXDE Lite, abra o Ferramentas e clique em Query.

2. Na guia Query

3. Como Tipo, selecione XPath.

4. No Query insira a seguinte string: //element()*, cq:Template)

5. Clique em Executar. A lista é exibida na caixa de resultados.

Na maioria dos casos, você usará um modelo existente e desenvolverá um novo para uso próprio. Consulte Desenvolvimento de modelos de página para obter mais informações.

Para habilitar um modelo existente para o seu site e exibi-lo na variável Criar página ao criar uma página logo em Sites do Sites defina a propriedade allowedPaths do nó do modelo como: /content(/.&?lang=pt-BR#42;)?

Como os designs de modelo são aplicados

Quando os estilos são definidos na interface do usuário usando Modo Design, o design é mantido no caminho exato do nó de conteúdo para o qual o estilo está sendo definido.

Se os designs forem aplicados usando apenas o Modo de design, as seguintes seções Resolução do caminho de design, Árvore de decisão, e o Exemplo não são aplicáveis.

Resolução do caminho de design

Ao renderizar o conteúdo com base em um modelo estático, o AEM tentará aplicar o design e os estilos mais relevantes ao conteúdo com base em uma passagem da hierarquia de conteúdo.

O AEM determina o estilo mais relevante para um nó de conteúdo na seguinte ordem:

• Se houver um design para o caminho completo e exato do nó de conteúdo (como quando o design é definido no Modo de design), use esse design.
• Se houver um design para o nó de conteúdo do pai, use esse design.
• Se houver um design para qualquer nó no caminho do nó de conteúdo, use esse design.

Nos dois últimos casos, se houver mais de um design aplicável, use o mais próximo do nó de conteúdo.

Árvore de decisão

Esta é uma representação gráfica do Resolução do caminho de design lógica.

Exemplo

Considere uma estrutura de conteúdo simples, como a seguir, em que um design pode ser aplicado a qualquer um dos nós:

/root/branch/leaf

A tabela a seguir descreve como o AEM escolherá um design.

Desenvolvimento de modelos de página

Modelos de página AEM são simplesmente modelos usados para criar novas páginas. Eles podem conter pouco ou tanto conteúdo inicial quanto necessário, sendo sua função criar as estruturas de nó iniciais corretas, com as propriedades necessárias (principalmente sling:resourceType) definidas para permitir edição e renderização.

Criação de um novo modelo (baseado em um modelo existente)

É desnecessário dizer que um novo modelo pode ser criado completamente do zero, mas com frequência um modelo existente será copiado e atualizado para economizar seu tempo e esforço. Por exemplo, os templates no Geometrixx podem ser usados para começar.

Para criar um novo modelo com base em um modelo existente:

1. Copie um template existente (de preferência com uma definição o mais próximo possível do que você deseja alcançar) em um novo nó.

   Normalmente, os modelos são armazenados no /apps/<website-name>/templates/<template-name>.

   OBSERVAÇÃO

   A lista de modelos disponíveis depende do local da nova página e das restrições de posicionamento especificadas em cada modelo. Consulte Disponibilidade do modelo.

2. Altere o jcr:title do nó novo modelo para refletir sua nova função. Você também pode atualizar a variável jcr:description se apropriado. Altere a disponibilidade do modelo da página, conforme apropriado.

   OBSERVAÇÃO

   Se quiser que o modelo seja exibido no Criar página ao criar uma página logo em Sites do Sites , defina o allowedPaths propriedade do nó do modelo para: /content(/.*)?

   

3. Copie o componente no qual o modelo se baseia (isso é indicado pela variável sling:resourceType propriedade do jcr:content no modelo) para criar uma nova instância.

   Normalmente, os componentes são armazenados no /apps/<website-name>/components/<component-name>.

4. Atualize o jcr:title e jcr:description do novo componente.

5. Substitua thumbnail.png se desejar que uma nova imagem em miniatura seja mostrada na lista de seleção do modelo (tamanho 128 x 98 px).

6. Atualize o sling:resourceType do modelo jcr:content para fazer referência ao novo componente.

7. Faça mais alterações na funcionalidade ou no design do modelo e/ou em seu componente subjacente.

   OBSERVAÇÃO

   As alterações feitas no /apps/<website>/templates/<template-name> afetará a instância do modelo (como na lista de seleção).
   As alterações feitas no /apps/<website>/components/<component-name> afetará a página de conteúdo criada quando o modelo for usado.

   Agora você pode criar uma página em seu site usando o novo modelo.

Disponibilizar um modelo existente

Este exemplo ilustra como permitir que um modelo seja usado para determinados caminhos de conteúdo. Os modelos que estão disponíveis para o autor da página ao criar novas páginas são determinados pela lógica definida em Disponibilidade do modelo.

1. No CRXDE Lite, navegue até o modelo que deseja usar para a página, por exemplo, o modelo Boletim informativo.

2. Altere o allowedPaths propriedade e outras propriedades usadas para disponibilidade do modelo. Por exemplo, allowedPaths: /content/geometrixx-outdoors/[^/]+(/.*)? significa que este modelo é permitido em qualquer caminho em /content/geometrixx-outdoors.

   

Recursos do Business.Adobe.com

Content Insights Automated Onboarding Asset Collections Theme Editor Managed Cloud Content As A Service