Modelos de fragmentos do conteúdo

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.

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	String obrigatório	O título do modelo (exibido no campo Criar fragmento assistente).
  jcr:description	String opcional	Um texto que descreve a finalidade do modelo (exibido no campo Criar fragmento assistente).
  initialAssociatedContent	String[] 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	Boolean obrigatório	true, se os subativos que representam os elementos (exceto o elemento principal) do fragmento de conteúdo tiverem que ser criados quando o fragmento de conteúdo for criado; false se eles devem ser criados "em tempo real". Nota: atualmente, esse parâmetro deve ser definido como true.
  version	Long obrigatório	Versão da estrutura de conteúdo; atualmente compatível: Nota: atualmente, esse parâmetro deve ser definido como 2.

• Elementos

  Nome	Tipo	Valor
  elements	nt:unstructured 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	String obrigatório	O título do elemento (exibido no seletor de elementos do editor de fragmentos).
  defaultContent	String opcional default: ""	Conteúdo inicial do elemento; usado somente se precreateElements = true
  initialContentType	String opcional default: text/html	Tipo de conteúdo inicial do elemento; usado somente se precreateElements = true; atualmente com suporte: text/html text/plain text/x-markdown
  name	String obrigatório	O nome interno do elemento; deve ser exclusivo para o tipo de fragmento.

• Variações

  Nome	Tipo	Valor
  variations	nt:unstructured 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>	nt:unstructured obrigatório se um nó de variação estiver presente	Define uma variação inicial. A variação é adicionada a todos os elementos do fragmento de conteúdo por padrão. A variação terá o mesmo conteúdo inicial que o respectivo elemento (consulte defaultContent/ initialContentType)
  jcr:title	String obrigatório	O título da variação (exibido no editor de fragmentos Variação (painel esquerdo).
  jcr:desciption	String opcional default: ""	Um texto que fornece uma descrição da variação (exibido no editor de fragmentos Variação (painel esquerdo).