Modelos de fragmento de conteúdo são recomendadas para criar todos os novos fragmentos de conteúdo.
Os modelos de fragmento de conteúdo são usados para todos os exemplos no WKND.
Antes do AEM 6.3, os fragmentos de conteúdo eram criados com base em modelos em vez de modelos.
Os modelos de Fragmento de conteúdo agora estão obsoletos. Eles ainda podem ser usados para criar fragmentos, mas é recomendável usar Modelos de fragmento de conteúdo. Nenhum novo recurso será adicionado aos modelos de fragmento e será removido em uma versão futura.
Os modelos são selecionados ao criar um fragmento de conteúdo. Eles fornecem o novo fragmento com a estrutura básica, os elementos e a variação. Os modelos usados para fragmentos de conteúdo estão sujeitos ao Granite Configuration Manager.
Os templates prontos para uso são mantidos em:
/libs/settings/dam/cfm/templates
Você pode criar modelos específicos do site para fragmentos de conteúdo em:
/apps/settings/dam/cfm/templates
O local para sobrepor modelos prontos para uso ou fornecer modelos do aplicativo específicos do cliente que não devem ser estendidos/alterados no tempo de execução.
/conf/global/settings/dam/cfm/templates
O local para modelos específicos do cliente em toda a instância que precisam ser alterados no tempo de execução.
A ordem de precedência é (em ordem decrescente) /conf
, /apps
, /libs
.
Você deve não alterar nada no /libs
caminho.
Isso ocorre porque o conteúdo de /libs
é substituído na próxima vez que você atualizar sua instância (e pode ser substituído ao aplicar um hotfix ou pacote de recursos).
O método recomendado para configuração e outras alterações é:
Recrie o item necessário (ou seja, como ele existe em /libs
) em /apps
Fazer alterações em /apps
A estrutura básica de um modelo é mantida em:
conf
global
settings
dam
cfm
templates
<template-name>
...
Sendo a estrutura específica:
+ <template-name>
- jcr:primaryType
- jcr:title
- jcr:description
- initialAssociatedContent
- precreateElements
- version
+ elements
- jcr:primaryType
+ <element-name>
- jcr:primaryType
- jcr:title
- defaultContent
- initialContentType
- name
... + other element definitions
+ variations
- jcr:primaryType
+ <variation-name>
- jcr:primaryType
- jcr:title
- jcr:description
- name
... + other variation definitions
Mais detalhes sobre os nós e suas propriedades são:
Modelo
Nome | Tipo | Valor |
---|---|---|
<template-name> |
nt:unstructured |
Este nó é a raiz de cada modelo. É obrigatório e deve ter um nome exclusivo. |
jcr:title |
obrigatório |
O título do modelo (exibido no campo Criar fragmento assistente). |
jcr:description |
opcional |
Um texto que descreve a finalidade do modelo (exibido no campo Criar fragmento assistente). |
initialAssociatedContent |
opcional |
Uma matriz com caminhos para coleções que devem ser associados a um fragmento de conteúdo recém-criado por padrão. |
precreateElements |
obrigatório |
Nota: atualmente, esse parâmetro deve ser definido como |
version |
obrigatório |
Versão da estrutura de conteúdo; atualmente compatível: Nota: atualmente, esse parâmetro deve ser definido como |
Elementos
Nome | Tipo | Valor |
---|---|---|
elements |
obrigatório |
Nó que contém a definição dos elementos do fragmento de conteúdo. É obrigatório e precisa conter pelo menos um nó secundário para o Principal elemento, mas pode conter [1..n] nós-filhos. Quando o modelo é usado, a sub-ramificação dos elementos é copiada para a sub-ramificação do modelo do fragmento. O primeiro elemento (conforme visualizado em CRXDE Lite) é automaticamente considerado como sendo o main elemento; o nome do nó é irrelevante e o nó em si não tem um significado especial, exceto o fato de que é representado pelo ativo principal; os outros elementos são tratados como subativos. |
Nome do elemento
Nome | Tipo | Valor |
---|---|---|
<element-name> |
nt:unstructured |
Este nó define um elemento. É obrigatório e deve ter um nome exclusivo. |
jcr:title |
obrigatório |
O título do elemento (exibido no seletor de elementos do editor de fragmentos). |
defaultContent |
opcional default: "" |
Conteúdo inicial do elemento; usado somente se precreateElements = true |
initialContentType |
opcional default: |
Tipo de conteúdo inicial do elemento; usado somente se
|
name |
obrigatório |
O nome interno do elemento; deve ser exclusivo para o tipo de fragmento. |
Variações
Nome | Tipo | Valor |
---|---|---|
variations |
opcional |
Esse nó opcional contém a definição das variações iniciais do fragmento de conteúdo. |
Nome da variação
Nome | Tipo | Valor |
---|---|---|
<variation-name> |
obrigatório se um nó de variação estiver presente |
Define uma variação inicial. A variação terá o mesmo conteúdo inicial que o respectivo elemento (consulte |
jcr:title |
obrigatório |
O título da variação (exibido no editor de fragmentos Variação (painel esquerdo). |
jcr:desciption |
opcional default: "" |
Um texto que fornece uma descrição da variação (exibido no editor de fragmentos Variação (painel esquerdo). |