Show Menu
TEMAS×

Plantillas de fragmento de contenido

Ahora se recomiendan modelos de fragmentos de contenido para crear todos los fragmentos.
Los modelos de fragmentos de contenido se utilizan en todos los ejemplos de We.Retail.
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 a Granite Configuration Manager.
Las plantillas integradas 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 Ubicación para superponer plantillas listas para usar o proporcionar plantillas específicas para el cliente y para toda la aplicación que no están pensadas para ampliarse o cambiarse en tiempo de 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 en tiempo de ejecución.
El orden de prioridad es (en orden descendente) /conf , /apps , /libs .
No debe cambiar nada en la /libs ruta.
Esto se debe a que el contenido de /libs se sobrescribe la próxima vez que actualice la instancia (y es posible que se sobrescriba al aplicar una revisión o un paquete de funciones).
El método recomendado para la configuración y otros cambios es:
  1. Volver a crear el elemento requerido (es decir, tal como existe en /libs ) en /apps
  1. Realice los cambios en /apps
La estructura básica de una plantilla se encuentra 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
    Título de la plantilla (se muestra en el asistente Crear fragmento ).
    jcr:description
    String
    opcional
    Texto que describe el propósito de la plantilla (mostrado en el asistente Crear fragmento ).
    initialAssociatedContent
    String[]
    opcional
    Matriz con rutas a colecciones que se deben asociar 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 en true .
    version
    Long
    required
    Versión de la estructura de contenido; compatible actualmente:
    Nota : actualmente, este parámetro debe establecerse en 2 .
  • Elementos
    Nombre Tipo Value
    elements
    nt:unstructured
    required
    Nodo que contiene la definición de los elementos del fragmento de contenido. Es obligatorio y debe contener al menos un nodo secundario para el elemento 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 CRXDE Lite) se considera automáticamente el elemento principal ; el nombre del nodo es irrelevante y el nodo en sí no tiene una importancia 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 Value
    < element-name > nt:unstructured Este nodo define un elemento. Es obligatorio y debe tener un nombre único.
    jcr:title
    String
    required
    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 utiliza si precreateElements = true ; compatible actualmente:
    • text/html
    • text/plain
    • text/x-markdown
    name
    String
    required
    El nombre interno del elemento; debe ser único para el tipo de fragmento.
  • Variaciones
    Nombre Tipo Value
    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 Value
    < variation-name >
    nt:unstructured
    requerido si hay un nodo de variación presente
    Define una variación inicial. De forma predeterminada, la variación se agrega a todos los elementos del fragmento de contenido.
    La variación tendrá el mismo contenido inicial que el elemento respectivo (consulte defaultContent/ initialContentType )
    jcr:title
    String
    required
    Título de la variación (se muestra en la ficha Variación del editor de fragmentos (carril izquierdo)).
    jcr:desciption
    String
    opcional
    predeterminada: ""
    Texto que proporciona una descripción de la variación (se muestra en la ficha Variación del editor de fragmentos (carril izquierdo)).