Show Menu
TÓPICOS×

Modelos de fragmento de conteúdo

Modelos de fragmento de conteúdo agora são recomendados para a criação de todos os fragmentos.
Os modelos de fragmento de conteúdo são usados para todos os exemplos em We.Retail.
Os modelos são selecionados ao criar um fragmento de conteúdo. Eles fornecem ao novo fragmento a estrutura básica, os elementos e a variação. Os modelos usados para fragmentos de conteúdo estão sujeitos ao Gerenciador de configuração do Granite.
Os modelos predefinidos 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 sobreposição de modelos predefinidos ou para fornecer modelos específicos do cliente, em todo o aplicativo, 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 em tempo de execução.
A ordem de precedência é (em ordem decrescente) /conf , /apps , /libs .
Você não deve alterar nada no /libs caminho.
Isso ocorre porque o conteúdo do é substituído na próxima vez que você atualizar sua instância (e pode muito bem ser substituído quando você aplicar uma correção ou um pacote de recursos). /libs
O método recomendado para configuração e outras alterações é:
  1. Recriar o item desejado (isto é, como ele existe em /libs ) em /apps
  2. Faça quaisquer alterações em /apps
A estrutura básica de um modelo é mantida em:
conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

Com 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 Esse nó é a raiz de cada modelo. É obrigatório e deve ter um nome exclusivo.
    jcr:title
    String
    required
    O título do modelo (exibido no assistente para Criar fragmento ).
    jcr:description
    String
    opcional
    Um texto que descreve a finalidade do modelo (exibido no assistente para Criar fragmento ).
    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
    required
    true , se os subativos que representam os elementos (exceto o elemento mestre) do fragmento de conteúdo devem ser criados quando o fragmento de conteúdo é criado; falso se devem ser criados "imediatamente".
    Observação : atualmente, esse parâmetro deve ser definido como true .
    version
    Long
    required
    Versão da estrutura de conteúdo; atualmente suportado:
    Observação : atualmente, esse parâmetro deve ser definido como 2 .
  • Elementos
    Nome Tipo Valor
    elements
    nt:unstructured
    required
    Nó que contém a definição dos elementos do fragmento de conteúdo. É obrigatório e precisa conter pelo menos um nó filho para o elemento Principal , mas pode conter [1.n] nós secundários.
    Quando o modelo é usado, a subramificação de elementos é copiada para a subramificação do modelo do fragmento.
    O primeiro elemento (conforme visualizado no CRXDE Lite) é automaticamente considerado o elemento principal ; O nome do nó é irrelevante e o nó em si não tem um significado especial, além do fato de ser representado pelo ativo principal; os outros elementos são tratados como subativos.
  • Nome do elemento
    Nome Tipo Valor
    < element-name > nt:unstructured Esse nó define um elemento. É obrigatório e deve ter um nome exclusivo.
    jcr:title
    String
    required
    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; Unicamente utilizado se precreateElements = true ; atualmente suportado:
    • text/html
    • text/plain
    • text/x-markdown
    name
    String
    required
    O nome interno do elemento; deve ser exclusiva 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
    required
    O título da variação (exibido na guia Variação (painel esquerdo) do editor de fragmentos).
    jcr:desciption
    String
    opcional
    default: ""
    Um texto que fornece uma descrição da variação (exibida na guia Variação (painel esquerdo) do editor de fragmentos).