Plantillas de fragmento de contenido

Las plantillas se seleccionan al crear un fragmento de contenido. Proporcionan al nuevo fragmento la estructura básica, los elementos y la variación. Las plantillas utilizadas para los fragmentos de contenido están sujetas al Administrador de configuración de Granite.

Las plantillas listas para usar se incluyen en:

• /libs/settings/dam/cfm/templates

Puede crear plantillas específicas del sitio para fragmentos de contenido en:

• /apps/settings/dam/cfm/templates
  La ubicación para superponer plantillas integradas o proporcionar plantillas específicas del cliente y para toda la aplicación que no se pretendan ampliar o cambiar durante la ejecución.

• /conf/global/settings/dam/cfm/templates
  La ubicación de las plantillas específicas del cliente para toda la instancia que deben cambiarse durante la ejecución.

El orden de prioridad es (en orden descendente) /conf, /apps, /libs.

La estructura básica de una plantilla se mantiene en:

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

Con una estructura 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

Más detalles sobre los nodos y sus propiedades son:

• Plantilla

  Nombre	Tipo	Value
  <template-name>	nt:unstructured	Este nodo es la raíz de cada plantilla. Es obligatorio y debe tener un nombre único.
  jcr:title	String required	El título de la plantilla (se muestra en la Crear fragmento ).
  jcr:description	String opcional	Texto que describe el propósito de la plantilla (mostrado en la Crear fragmento ).
  initialAssociatedContent	String[] opcional	Matriz con rutas a colecciones que deben asociarse a un fragmento de contenido recién creado de forma predeterminada.
  precreateElements	Boolean required	true, si los subrecursos que representan los elementos (excepto el elemento maestro) del fragmento de contenido se deben crear al crear el fragmento de contenido; false si deben crearse "sobre la marcha". Nota: actualmente, este parámetro debe establecerse como true.
  version	Long obligatorio	Versión de la estructura de contenido; compatible actualmente: Nota: actualmente, este parámetro debe establecerse como 2.

• Elementos

  Nombre	Tipo	Valor
  elements	nt:unstructured obligatorio	Nodo que contiene la definición de los elementos del fragmento de contenido. Es obligatorio y debe contener al menos un nodo secundario para la variable Principal pero puede contener [1..n] nodos secundarios. Cuando se utiliza la plantilla, la subrama de elementos se copia en la subrama de modelo del fragmento. El primer elemento (como se ve en el CRXDE Lite) se considera automáticamente como el main elemento; el nombre del nodo es irrelevante y el nodo en sí no tiene una relevancia especial, aparte del hecho de que está representado por el recurso principal; los demás elementos se gestionan como subrecursos.

• Nombre de elemento

  Nombre	Tipo	Valor
  <element-name>	nt:unstructured	Este nodo define un elemento. Es obligatorio y debe tener un nombre único.
  jcr:title	String obligatorio	Título del elemento (mostrado en el selector de elementos del editor de fragmentos).
  defaultContent	String opcional predeterminada: ""	Contenido inicial del elemento; solo se usa si precreateElements = true
  initialContentType	String opcional predeterminada: text/html	Tipo de contenido inicial del elemento; solo se usa si precreateElements = true; compatible actualmente: text/html text/plain text/x-markdown
  name	String obligatorio	El nombre interno del elemento; debe ser único para el tipo de fragmento.

• Variaciones

  Nombre	Tipo	Valor
  variations	nt:unstructured opcional	Este nodo opcional contiene la definición de las variaciones iniciales del fragmento de contenido.

• Nombre de la variación

  Nombre	Tipo	Valor
  <variation-name>	nt:unstructured obligatorio si hay un nodo de variación	Define una variación inicial. La variación se agrega a todos los elementos del fragmento de contenido de forma predeterminada. La variación tendrá el mismo contenido inicial que el elemento respectivo (consulte defaultContent/ initialContentType)
  jcr:title	String obligatorio	El título de la variación (se muestra en la sección Variación (carril izquierdo).
  jcr:desciption	String opcional predeterminada: ""	Texto que proporciona una descripción de la variación (se muestra en el Variación (carril izquierdo).