Plantillas de fragmento de contenido

PRECAUCIÓN

Ahora se recomiendan los modelos de fragmento de contenido para crear todos los fragmentos.

Los modelos de fragmentos de contenido se utilizan en todos los ejemplos de We.Retail.

NOTA

Antes de AEM 6.3, los fragmentos de contenido se creaban con el uso de plantillas en lugar de modelos. Las plantillas ya no están disponibles para crear nuevos fragmentos, pero los fragmentos creados con una plantilla de este tipo siguen siendo compatibles.

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.

PRECAUCIÓN

no debe cambiar nada en la ruta /libs.

Esto se debe a que el contenido de /libs se sobrescribe la próxima vez que actualice la instancia (y puede sobrescribirse al aplicar una correcció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

  2. Realizar cambios en /apps

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 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 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 se deben crear "sobre la marcha".

    Nota: actualmente, este parámetro debe establecerse en true.

    version

    Long

    obligatorio

    Versión de la estructura de contenido; compatible actualmente:

    Nota: actualmente, este parámetro debe establecerse en 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 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 el CRXDE Lite) se considera automáticamente como el elemento main; 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 pestaña Variation 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 pestaña Variation del editor de fragmentos (carril izquierdo)).

En esta página